Solución de problemas de descarga
Soundsible busca y descarga mediante yt-dlp. Cuando falla una descarga, el motivo aparece en el registro del motor:
| Ejecutas Soundsible con | Consulta el registro con |
|---|---|
python3 run.py --daemon | La terminal en la que se ejecuta |
| systemd | journalctl -u soundsible -f |
| Docker | docker compose logs -f soundsible |
Cómo se intenta una descarga
Cada descarga intenta, por este orden:
- el flujo de audio nativo sin cookies: la extracción pública suele ofrecer los formatos solo de audio más limpios;
- lo mismo con tus cookies, si las has configurado y YouTube ha solicitado iniciar sesión, confirmar la edad o usar un formato solo disponible con cookies, o ha respondido «El formato solicitado no está disponible» o HTTP 403;
- una descarga recodificada, con cookies si las tienes.
Las consultas de metadatos siguen el mismo orden: primero de forma anónima, después cookies.txt
y, por último, las cookies del navegador. Las cookies nunca son obligatorias para la música pública; son una
alternativa cuando falla lo anterior.
«El formato solicitado no está disponible»
Las cookies pueden hacer que YouTube devuelva una lista de formatos distinta, por eso Soundsible empieza sin ellas y solo vuelve a intentarlo con ellas cuando hace falta. Si este error persiste tras los tres intentos:
- Actualiza yt-dlp. YouTube cambia a menudo y una versión antigua de yt-dlp es la causa más habitual. En una instalación nativa, activa Configuración → Descargas → Actualizar yt-dlp automáticamente (solo administradores) y reinicia Soundsible: a partir de entonces actualizará yt-dlp en segundo plano cada vez que se inicie. Con Docker, descarga la imagen más reciente.
- Exporta un
cookies.txtnuevo; una sesión caducada puede fallar del mismo modo.
«Inicia sesión para confirmar que no eres un bot», búsquedas vacías en un VPS
Las direcciones de centros de datos suelen tratarse como tráfico automatizado. De menor a mayor esfuerzo:
- Si has establecido
SOUNDSIBLE_YT_SEARCH_SOURCE=ytmusicy las búsquedas no devuelven resultados, elimínalo para volver al valor predeterminado,youtube. - Añade cookies de YouTube; consulta Configuración → Cookies de YouTube.
- Dirige el tráfico de YouTube a través de un ordenador doméstico de confianza con el repetidor para VPS.
Las descargas se bloquean o agotan el tiempo de espera
Soundsible ya fuerza IPv4 y reintenta con esperas crecientes; los valores predeterminados y cómo ajustarlos se explican en Configuración → YouTube y descargas.
El orden de los intentos está definido en download_audio, en
shared/downloader/youtube/download.py.