Sobre el proyecto

open-Xdownload es un descargador de medios de X/Twitter local-first con interfaz web integrada y cola de tareas en segundo plano. Admite cuatro tipos de tareas: publicaciones individuales, usuarios, listas y cuentas seguidas; además ofrece tareas por lotes, planes programados, archivo incremental, reintento de fallos y un grupo de cookies para rotación de límites de la API. Capacidades principales: - Análisis y descarga por publicación: pega un enlace de x.com o twitter.com para analizar texto, autor y lista de medios, luego descarga la mejor versión disponible de cada imagen, video o GIF. - Archivo de medios de usuario: archiva medios de la línea de tiempo de un usuario por nombre de usuario, @handle o ID de usuario. - Archivo de listas: ingresa un ID de lista de X para obtener los miembros y archivar sus medios. - Archivo de cuentas seguidas: obtiene las cuentas que sigue un objetivo y archiva medios de esas cuentas. - Tareas por lotes: ingresa hasta 200 objetivos (usuarios, listas, cuentas seguidas) a la vez con deduplicación automática. - Planes programados: guarda objetivos como planes de archivo recurrentes con intervalos configurables (5–43200 minutos). - Archivo incremental: reanuda desde la última posición exitosa en ejecuciones repetidas; omite medios ya descargados. - Manejo de fallos: los fallos parciales se marcan claramente; las publicaciones fallidas entran en una cola de reintento que puede ejecutarse manualmente o automáticamente al completar la tarea. - Grupo de cookies: cookie principal más múltiples grupos de respaldo para rotación de límites durante el archivo por lotes. - Biblioteca de medios: explora medios descargados por categoría de imagen, video o GIF; busca por nombres de archivo, URLs de medios e IDs de publicación; previsualizaciones de carga diferida con navegación por teclado. - Previsualizaciones ligeras: las imágenes cargan diferidamente; los videos solo muestran una miniatura del póster de forma predeterminada, montando el reproductor únicamente en la previsualización ampliada. - Almacenamiento local: directorio de descarga configurable mediante UI o CLI, con rutas navegables y creables. Opciones de despliegue: - Docker Compose (recomendado): puertos 127.0.0.1:8787, volúmenes para datos y descargas, PUID/PGID configurables. - Docker run: mismas variables de entorno, invocación manual. - Binario: descarga desde Releases; escucha en 127.0.0.1:8787 de forma predeterminada, con indicadores configurables de addr, data-dir, web-dir y download-dir. El servicio no tiene autenticación integrada y se vincula a localhost de forma predeterminada. El acceso LAN requiere configurar explícitamente la dirección como 0.0.0.0:8787 y colocar el servicio detrás de un proxy inverso con autenticación. Los datos se almacenan en una base de datos SQLite (open-xdownload.db) y directorios locales de descarga. Los campos sensibles (cookies) aparecen enmascarados en la interfaz. Los respaldos deben incluir tanto la base de datos como el directorio de descargas. Licencia: MIT.