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.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.