@luxyteam/ytdl

# @luxyteam/ytdl

Este es un módulo de Node.js para descargar audio y video de YouTube utilizando `yt-dlp`. Admite plataformas Android, Linux y Windows, y está diseñado para ser fácil de usar y configurar.

## Instalación

1. **Clona el repositorio o descarga el paquete:**

   Si prefieres usarlo como una dependencia local, puedes instalarlo directamente desde el directorio:

   ```bash
   npm install @luxyteam/ytdl --save

2. Instalación de dependencias:

   Instala las dependencias necesarias para el proyecto:

   npm install

3. Dependencias externas:

   Este proyecto requiere las siguientes dependencias:

   • node-fetch: Para realizar solicitudes HTTP.
   • path: Para manejar rutas de archivos.

   Estas dependencias se instalarán automáticamente al ejecutar npm install.

Uso

1. Descargar audio en formato MP3

Para descargar el audio de un video de YouTube, utiliza el siguiente código:

import { ytmp3 } from "@luxyteam/ytdl";

(async () => {
    const url = "https://youtu.be/3jf6xOg6e7Y?si=P9Lc9WBqo8scbKzB"; // Reemplaza con la URL de tu video
    const audio = await ytmp3(url);

    console.log("Descarga de audio completada:", audio);
})();

Este comando descargará el audio del video en formato m4a. Puedes cambiar el formato modificando el valor 'm4a' en el código de la función generateRandomName().

2. Descargar video en formato MP4

Para descargar un video de YouTube en formato MP4, usa el siguiente código:

import { ytmp4 } from "@luxyteam/ytdl";

(async () => {
    const url = "https://youtu.be/3jf6xOg6e7Y?si=P9Lc9WBqo8scbKzB"; // Reemplaza con la URL de tu video
    const video = await ytmp4(url);

    console.log("Descarga de video completada:", video);
})();

Esto descargará el video en el formato mp4.

3. Buscar videos de YouTube

Para buscar videos en YouTube, puedes utilizar el siguiente código:

import { yts } from "@luxyteam/ytdl";

(async () => {
    const query = "Ma Meilleure Ennemie"; // Reemplaza con tu consulta
    const results = await yts(query);

    console.log("Resultados de búsqueda:", results);
})();

Esto devolverá una lista de videos relacionados con la consulta proporcionada.

Funcionalidades

• ytmp3(url): Descarga el audio de un video de YouTube en formato m4a.
• ytmp4(url): Descarga un video de YouTube en formato mp4.
• yts(query): Realiza una búsqueda en YouTube basada en una consulta de texto y devuelve los resultados.

Requisitos del sistema

• Plataformas compatibles: Android, Linux, Windows.
• Dependencias:
  • node-fetch: Para hacer solicitudes HTTP.
  • path: Para manejar rutas de archivos.
  • yt-dlp debe estar disponible y ser compatible con la plataforma.

Configuración

1. Borrar la caché de cookies: Si las cookies no están configuradas correctamente, el sistema intentará automáticamente cargar cookies válidas desde el archivo cookies.json. Si no se encuentran cookies válidas, se lanzará un error.

2. Actualizar binarios: El script puede actualizar automáticamente los binarios necesarios desde GitHub, asegurándose de que la versión más reciente esté disponible para su uso.

3. Archivos temporales: El proyecto utilizará directorios temporales (temp y bin) para almacenar archivos descargados y binarios ejecutables.

Notas

• La biblioteca utiliza yt-dlp para manejar las descargas. Este módulo se actualiza automáticamente a través del archivo updateFile().
• Se emplea un enfoque de reintentos en caso de fallos al descargar contenido o al probar cookies válidas.

Contribuir

Si deseas contribuir a este proyecto, puedes hacer un fork y crear una solicitud de pull con las mejoras. Asegúrate de seguir las mejores prácticas de desarrollo y de realizar pruebas antes de enviar tus cambios.

---

Este proyecto está bajo la licencia ISC. Consulta el archivo LICENSE para obtener más información.