Solución de problemas

Anota la versión de XiaDown, el sistema operativo, el área y la página afectadas, los pasos realizados y el error. Antes de volver a intentarlo, comprueba que no vayas a crear por duplicado el mismo grupo de tareas.

Revisión rápida

1. Confirma la versión en Ajustes → Acerca de.
2. Valida yt-dlp, FFmpeg y Bun en Ajustes → Descargas.
3. Revisa el proxy en Ajustes → Red.
4. Si necesitas una cuenta, valida el inicio de sesión en Biblioteca → Sesiones de apps.
5. Regresa a la página afectada y actualiza o crea una tarea nueva.

Solución por síntoma

Síntoma	Qué revisar primero
El botón para iniciar una descarga o conversión está desactivado	Para descargar, revisa yt-dlp y FFmpeg; para convertir, FFmpeg.
No se puede analizar un enlace	Integridad del enlace, permisos de cuenta, yt-dlp y red; usa Detección si es necesario.
La descarga es lenta o falla con frecuencia	Reduce la concurrencia de descargas; para HLS o m3u8, reduce también la de segmentos.
La conversión falla	Valida FFmpeg y confirma que el archivo de entrada sea accesible y compatible.
El navegador de detección no abre	Vuelve a “Nueva detección” para repetir el análisis. Para “Predeterminado del navegador” de Chrome, revisa la depuración remota y la autorización.
Detección no muestra recursos	Pulsa reproducir, desplázate por la página, amplía el alcance o abre una sesión nueva.
YouTube / Música pide iniciar sesión	Valida o vuelve a conectar la sesión de YouTube.
Una página en línea no termina de cargar	Revisa el proxy, el estado del servicio y la región de la cuenta.
RSS no se actualiza	Actualiza manualmente la suscripción y revisa la dirección y la red.
La música local no se reproduce	Comprueba si el archivo se movió, se eliminó o está en un disco desconectado.
Un elemento de la biblioteca aparece como faltante	Vuelve a montar el disco y revisa, o importa otra vez el archivo existente.

Consultar registros

Abre la carpeta de registros desde Ajustes → General. Reproduce el problema una vez y busca las entradas cercanas a ese momento.

Los registros pueden contener rutas locales, direcciones de sitios o contexto del error. Elimina u oculta esos datos antes de compartirlos. No subas sesiones, enlaces de vinculación, tokens ni la base de datos completa de la biblioteca.

Si el problema continúa

Abre un reporte en GitHub Issues e incluye:

• Las versiones de XiaDown y del sistema.
• El área y la página afectadas.
• Pasos que reproduzcan el problema de forma confiable.
• El mensaje o fragmento de registro sin datos sensibles.
• Una captura sin cuentas, contenido privado ni rutas locales.