open-xdownload

open-Xdownload é um downloader de mídia X/Twitter local-first com Web UI integrada e fila de tarefas em segundo plano. Suporta quatro tipos de tarefa — posts únicos, usuários, listas e contas seguidas — e oferece tarefas em lote, planos agendados, arquivamento incremental, retry de falhas e um pool de cookies para rotação de limite de requisições da API. Principais funcionalidades: - Análise e download de posts únicos: Cole um link x.com ou twitter.com para analisar texto, autor e lista de mídias, depois baixe a melhor versão disponível de cada imagem, vídeo ou GIF. - Arquivamento de mídia de usuários: Arquive mídias da timeline de um usuário pelo nome de usuário, @handle ou ID do usuário. - Arquivamento de listas: Insira um ID de lista do X para buscar membros e arquivar suas mídias. - Arquivamento de contas seguidas: Busca as contas que um alvo segue e arquiva mídias dessas contas. - Tarefas em lote: Insira até 200 alvos (usuários, listas, contas seguidas) de uma vez com deduplicação automática. - Planos agendados: Salve alvos como planos recorrentes de arquivamento com intervalos configuráveis (5–43200 minutos). - Arquivamento incremental: Retome da última posição bem-sucedida em execuções repetidas; pule mídias já baixadas. - Tratamento de falhas: Falhas parciais são claramente marcadas; posts com falha entram em uma fila de retry que pode ser repetida manualmente ou automaticamente ao concluir a tarefa. - Pool de cookies: Cookie primário mais múltiplos grupos de backup para rotação de limites durante arquivamento em lote. - Biblioteca de mídia: Navegue pelas mídias baixadas por categoria (imagem, vídeo ou GIF); pesquise nomes de arquivos, URLs de mídia e IDs de posts; pré-visualizações com lazy-loading e navegação por teclado. - Pré-visualizações leves: Imagens com lazy-loading; vídeos carregam apenas uma thumbnail como padrão, montando o player apenas na pré-visualização ampliada. - Armazenamento em diretório local: Diretório de download configurável via UI ou CLI, com caminhos navegáveis e criáveis. Opções de implantação: - Docker Compose (recomendado): Portas 127.0.0.1:8787, volumes para dados e downloads, PUID/PGID configuráveis. - Docker run: Mesmas variáveis de ambiente, invocação manual. - Binário: Baixe em Releases; escuta em 127.0.0.1:8787 por padrão, com flags configuráveis para addr, data-dir, web-dir e download-dir. O serviço não possui autenticação integrada e vincula-se a localhost por padrão. Acesso LAN requer configurar explicitamente o endereço para 0.0.0.0:8787 e colocar o serviço atrás de um reverse proxy autenticado. Os dados são armazenados em banco SQLite (open-xdownload.db) e diretórios locais de download. Campos sensíveis (cookies) são mascarados na UI. Backups devem incluir tanto o banco quanto o diretório de downloads. Licença: MIT.