Como usar gallery-dl com o Twitter / X

O gallery-dl reconhece vários tipos de URL do Twitter / X: uma publicação, a página /media de um utilizador, cronologias, gostos, marcadores, listas, pesquisas e outras páginas suportadas pelo extrator. No primeiro teste, escolha uma publicação pública ou a página de multimédia do perfil. Copie o URL canónico de x.com, coloque-o entre aspas e simule a extração antes de criar ficheiros.

A simulação confirma se a versão instalada é recente, se o URL ativa o extrator certo, se é necessário iniciar sessão e quais os ficheiros selecionados. Uma cronologia pode misturar republicações, respostas, citações, vídeos e conteúdos repetidos. Por isso, reconhecer o URL não garante que o âmbito predefinido corresponda ao objetivo.

gallery-dl --simulate "https://x.com/UTILIZADOR/status/ID_PUBLICACAO"

gallery-dl --simulate "https://x.com/UTILIZADOR/media"

gallery-dl -K "https://x.com/UTILIZADOR/status/ID_PUBLICACAO"

O Twitter limita frequentemente o acesso anónimo às cronologias. Se o gallery-dl pedir cookies autenticados, inicie sessão normalmente num perfil de navegador que controla, confirme que a página abre nesse perfil e indique-o ao comando. O gallery-dl lê a base local de cookies; não precisa de colar valores nesta página nem de os enviar a terceiros.

Feche totalmente o navegador se a base de cookies estiver bloqueada e escolha o mesmo perfil onde a sessão do X está ativa. Sessões expiradas, desafios adicionais, conteúdo privado, restrições etárias ou permissões da conta podem continuar a impedir a extração. Os cookies apenas reproduzem o acesso que a sua conta já possui.

gallery-dl --cookies-from-browser firefox --simulate "https://x.com/UTILIZADOR/media"

gallery-dl --cookies-from-browser chrome --simulate "https://x.com/UTILIZADOR/media"

gallery-dl --cookies-from-browser edge --simulate "https://x.com/UTILIZADOR/media"

Quando a simulação funcionar, escolha uma pasta previsível e adicione um arquivo de downloads. Esse arquivo guarda os identificadores concluídos e ignora-os em execuções futuras, mesmo quando os nomes mudam. Limite o primeiro download real, verifique caminhos e tipos de conteúdo e só depois aumente o trabalho.

O extrator pode incluir ou excluir respostas, republicações, citações, cartões, artigos, pré-visualizações, publicações apenas de texto e vídeos. Os valores predefinidos podem mudar entre versões. Use -K antes de criar nomes ou filtros, mantenha o mesmo arquivo na tarefa recorrente e não publique caminhos de perfis, dados de sessão ou URLs privadas.

gallery-dl --cookies-from-browser firefox --range "1-25" --download-archive "twitter.sqlite3" "https://x.com/UTILIZADOR/media"

gallery-dl --destination "D:/Media/X" --download-archive "twitter.sqlite3" "https://x.com/UTILIZADOR/media"

gallery-dl --write-metadata --download-archive "twitter.sqlite3" "https://x.com/UTILIZADOR/media"

Passe opções para a configuração apenas depois de a linha de comandos funcionar. O exemplo oficial disponibiliza include, replies, retweets, quoted, videos, preferência de tamanho, novas tentativas da API e gestão do limite. Um bloco pequeno e revisto é mais simples de manter do que copiar todas as opções sem saber qual altera o resultado.

O exemplo mantém vídeos, exclui respostas, republicações e citações, espera quando existe um limite e usa um arquivo estável. Pode deixar a seleção dos cookies no comando se máquinas diferentes usam perfis diferentes. Valide o JSON: comentários, vírgulas finais e barras invertidas do Windows sem escape tornam o ficheiro inválido.

{
  "extractor": {
    "twitter": {
      "replies": false,
      "retweets": false,
      "quoted": false,
      "videos": true,
      "ratelimit": "wait",
      "archive": "D:/gallery-dl/twitter.sqlite3"
    }
  }
}

gallery-dl --config-ignore --simulate "https://x.com/UTILIZADOR/media"

gallery-dl --config-status

Separe autenticação, limite, resultados vazios e duplicados. AuthRequired costuma indicar cookies ausentes ou expirados. HTTP 429 significa que deve esperar em vez de repetir agressivamente. Um resultado vazio pode vir do tipo de URL errado, de conteúdo inacessível, de filtros restritivos ou de um arquivo que já contém os identificadores.

Compare uma simulação limpa com --config-ignore com o mesmo URL e as definições normais. Adicione cookies, intervalo, arquivo e filtros um de cada vez. Atualize o gallery-dl pelo mesmo canal de instalação, confirme a versão e consulte os problemas oficiais antes de assumir que pedidos repetidos resolvem uma alteração do X.

O gallery-dl é um descarregador local, não um sistema de permissões. Descarregue apenas conteúdos a que pode aceder e utilizar legitimamente, respeite a privacidade, os direitos de autor, as regras aplicáveis e a lei. Nunca partilhe cookies, tokens, arquivos privados ou dados pessoais descarregados.

Em 30 de julho de 2026, este site verificou o gallery-dl 1.32.8 nos metadados oficiais do PyPI e confirmou HTTP 200, nomes e tamanhos esperados nos ficheiros oficiais de Windows e Linux do Codeberg. O X pode mudar; reveja a versão e a documentação quando um comando deixar de funcionar.