Descargador de YouTube

1. Estructura de Carpetas de la Aplicación

El programa organiza sus recursos y ficheros en carpetas independientes para garantizar su portabilidad y fácil mantenimiento:

• bin/: Contiene el motor de descarga yt-dlp.exe y recibe automáticamente las descargas y actualizaciones Nightly.
• config/: Guarda la configuración persistente en config.json y la subcarpeta config/favoritos/, donde cada lista de favoritos se guarda en un fichero .json independiente.
• docs/: Contiene la documentación técnica y de usuario en Markdown (manual.md, atajos.md) y sus versiones web (manual.html, atajos.html).
• resources/vlc/: Aloja las librerías nativas de reproducción multimedia (VLC), permitiendo que el ejecutable principal sea ligero e independiente.

2. Búsqueda de Contenidos

Para realizar una búsqueda:

1. Pulsa Alt + T o Ctrl + F para situar el foco en el campo de texto.
2. Escribe los términos deseados o pega directamente una URL de vídeo, canal o lista.
3. Selecciona el tipo de búsqueda en el selector Tipo (Alt + I).
4. Pulsa Enter o el botón Buscar (Alt + B).

Criterio de ordenación natural de yt-dlp: Los resultados se obtienen y presentan respetando fielmente la relevancia y orden natural por defecto de yt-dlp. El número máximo de resultados se define cómodamente en Opciones y Preferencias (Ctrl + , o F2), manteniendo la ventana de búsqueda despejada.

3. Tipos de Búsqueda: Vídeos, Canales y Listas

Por defecto, la aplicación siempre inicia en la plataforma YouTube y con el tipo de búsqueda en Vídeos. Para casos excepcionales, el usuario puede seleccionar la plataforma en el menú Plataformas o el tipo de búsqueda en el selector Tipo (Alt + I):

• Vídeos (Predeterminado): Muestra los vídeos encontrados según el criterio por defecto de yt-dlp, con su título, canal, duración e identificador.
• Canales: Encuentra canales y creadores de contenido, mostrando su nombre, identificador, suscriptores y, si está disponible, el número de vídeos que contiene (al igual que las listas de reproducción). Al pulsar Enter o doble clic en un canal, se cargarán de inmediato todos los vídeos subidos por dicho canal.
• Listas de reproducción: Localiza listas temáticas indicando el número de vídeos incluidos. Al pulsar Enter o doble clic, se mostrarán todos los vídeos de la lista.

4. Plataformas Multimedia Soportadas

La aplicación integra en el menú Plataformas motores de búsqueda directos por texto para:

• YouTube (Predeterminado)
• SoundCloud (Pistas, sets y podcasts de audio)
• Bandcamp (Música indie y sellos independientes)
• Bilibili (Animación y vídeo digital)

Además, el motor universal de yt-dlp reconoce automáticamente cualquier enlace directo que pegues en el campo de búsqueda (Twitch, Vimeo, TikTok, Mixcloud, Ivoox, RTVE y más de 1.800 servicios compatibles), por lo que no es necesario seleccionar ninguna plataforma previa para descargar mediante URL.

5. Reproducción Multimedia Continua (VLC)

El reproductor integrado permite previsualizar y disfrutar de las pistas sin necesidad de descargarlas previamente:

• Reproducción continua de selección individual o marcada: Pulsa Ctrl + P o el botón Reproducir selección.
• Reproducción continua de pistas marcadas (salteadas): Puedes marcar con Espacio cualquier combinación de pistas no consecutivas de la lista (por ejemplo, la 1ª, la 3ª, la 6ª y la 10ª). Al pulsar Ctrl + P o el botón Reproducir (N), el reproductor reproducirá en secuencia continua únicamente esas pistas marcadas, omitiendo las intermedias no seleccionadas.
• Reproducir toda la lista: Pulsa Ctrl + L para reproducir todas las pistas encontradas de manera consecutiva.
• Pausar o reanudar: Pulsa Espacio dentro del reproductor para pausar o continuar la reproducción al instante.
• Subir y bajar volumen: Pulsa Flecha Arriba para subir el volumen (+5%) o Flecha Abajo para bajarlo (-5%).
• Silenciar o activar sonido (Mute): Pulsa la tecla M para silenciar el reproductor o restablecer el nivel de audio previo.
• Avanzar / Retroceder canciones de la lista en reproducción: Pulsa Ctrl + Flecha Derecha (o tecla N) para avanzar a la siguiente canción de la lista, y Ctrl + Flecha Izquierda (o tecla P) para retroceder a la canción anterior. (Nota: Las combinaciones Ctrl + Flechas cambian de canción completa en la lista; las flechas solas o combinadas con Shift/Alt desplazan la posición en segundos o minutos dentro de la misma pista).
• Añadir o quitar de Favoritos: Pulsa la tecla B o F para guardar la pista que está sonando en tu lista de favoritos o quitarla si ya existía.
• Descargar contenido en reproducción: Pulsa Ctrl + D para iniciar la descarga del archivo en curso directamente desde el reproductor.
• Cerrar reproductor: Pulsa Escape para detener la reproducción y regresar a la ventana principal.
• Anunciar tiempo (F9 y F10): Pulsa F9 para que el sintetizador de voz anuncie el tiempo transcurrido y F10 para el tiempo restante.
• Navegación temporal con intervalos: Avanza o retrocede con las flechas del teclado en diferentes intervalos: Flechas (10 seg), Shift + Flechas (1 seg), Shift + Alt + Flechas (5 seg), Ctrl + Shift + Flechas (1 min) y Ctrl + Alt + Shift + Flechas (5 min).
• Activar / Desactivar ventana de vídeo (F11): Oculta o muestra el panel de vídeo en cualquier momento para alternar entre el modo vídeo y el modo solo audio compacto.
• Modo Solo Audio Ultrarrápido: Al configurar la reproducción sin vídeo en Preferencias, se transmite exclusivamente la pista de audio más ligera, ofreciendo transiciones inmediatas entre canciones y mínimo consumo de recursos.
• Pre-buffering predictivo: 15 segundos antes de terminar la pista activa, el reproductor precarga la siguiente para evitar silencios.
• Repetición continua: Desactivada por defecto, activable con la tecla R o desde Preferencias.

6. Descarga de Archivos y Formatos

Para descargar pistas o vídeos:

1. Marca los elementos que desees en la lista con Espacio (o pulsa Ctrl + A para todos).
2. Elige el formato de salida (Alt + F):
   • Vídeo (Mejor calidad MP4): Vídeo a máxima resolución con audio integrado.
   • Audio MP3 (192 kbps - Estándar): Audio MP3 ligero y equilibrado.
   • Audio MP3 (320 kbps - Alta fidelidad): Máxima calidad estéreo MP3.
   • Audio M4A (Original AAC): Sonido directo original sin recodificar.
3. Pulsa el botón Descargar selección (Alt + D o Ctrl + D).

7. Sistema de Múltiples Listas de Favoritos en Ficheros Separados

• Añadir a Favoritos (Ctrl + B): Añade el elemento seleccionado a la lista Principal o a una lista temática personalizada (ej. Música Rock, Flamenco, etc.).
• Ver Favoritos (Ctrl + H): Carga y muestra los elementos guardados en la tabla.
• Reproducción Continua de Favoritos (Ctrl + Shift + P): Reproduce de corrido toda tu colección sin pausas.
• Ficheros independientes para compartir: Cada lista de favoritos se guarda en un fichero .json individual dentro de config/favoritos/ (ej. Rock.json, Flamenco.json). Puedes pasar a un amigo únicamente tu lista de rock y a otro tu lista de flamenco según sus preferencias musicales sin necesidad de compartir toda tu lista. Tu amigo solo tiene que copiar el fichero en su carpeta config/favoritos/.

8. Configuración y Opciones del Programa

Desde la ventana de Preferencias (Ctrl + , o F2) puedes definir:

• Carpeta de destino predeterminada: Carpeta donde se guardarán las descargas.
• Formato de salida predeterminado: MP4, MP3 192k, MP3 320k o M4A.
• Cantidad de resultados por búsqueda: 25 por defecto (configurable de 1 a 500).
• Abrir carpeta de descargas automáticamente al finalizar: Abre inmediatamente la carpeta en el Explorador de Windows al completarse la descarga.
• Preguntar si abrir la carpeta al finalizar la descarga (cuadro Sí / No): Si la apertura automática está desmarcada, al terminar la descarga se mostrará un cuadro de diálogo accesible preguntando si deseas abrir la carpeta en ese momento.
• Repetición continua activada por defecto en el reproductor: Desactivada por defecto.
• Reproducir con vídeo por defecto: Con vídeo por defecto; desmarcar para modo solo audio de alta velocidad.

9. Motor yt-dlp y Descarga Bajo Demanda

El motor yt-dlp no está embebido en el ejecutable, manteniéndolo ligero y modular:

• Descarga inicial guiada: Si no se encuentra en la carpeta, el programa notificará: "no se encuentra la librería necesaria para la ejecución del programa, se va a proceder a su descarga" y la descargará en bin/yt-dlp.exe al aceptar.
• Actualización: Pulsa Ctrl + U para comprobar y actualizar a la versión Nightly en cualquier momento.
• Notificación en bandeja: Al terminar la descarga, el diálogo se cierra automáticamente y se emite una notificación en la bandeja del sistema: "librería descargada con éxito".

10. Tabla Completa de Atajos de Teclado

Atajos Globales y Acciones Principales

Atajos Mnemónicos de Acceso Rápido (Alt + Letra)

Navegación e Interacción en la Lista de Resultados

Controles en el Reproductor Multimedia