Como guardar vídeos do Telegram no Mac com nome e data

A maneira confiável de guardar vídeos do Telegram num Mac é gravá-los no disco como arquivos com nome próprio: para um ou dois clipes, clique com o botão direito no vídeo dentro do Telegram e escolha Guardar como… (Salvar como…), o que lhe dá um .mp4 de verdade onde você quiser. Para uma conversa inteira, o acervo de um canal ou algumas centenas de clipes, use um app de desktop que percorra o histórico da conversa e escreva todos os vídeos no disco de uma só passagem. O que você não deve fazer é ir remexer na pasta de cache do Telegram, ainda que seja o primeiro conselho que costuma aparecer. Aqui está por que esse caminho decepciona, e como é de verdade um bom resultado no Finder.

Onde o Telegram guarda os vídeos no seu Mac antes de você guardá-los

Quando você assiste a um vídeo dentro do Telegram, o app faz o download dele para uma cache: uma pasta privada de rascunho que serve para não precisar buscar o mesmo arquivo duas vezes. A cache é uma área de trabalho do app, não uma biblioteca para você.

Onde ela fica depende de qual Telegram você usa. O Telegram Desktop multiplataforma guarda os dados em ~/Library/Application Support/Telegram Desktop/tdata/, com os vídeos e as fotos enfiados num diretório de cache user_data lá dentro. O Telegram nativo para macOS roda em sandbox, por isso os dados dele ficam numa pasta de group container dentro de ~/Library/Group Containers/. No Finder você chega a qualquer um dos dois com Ir > Ir para a pasta (Go > Go to Folder, Shift-Command-G) e colando o caminho. A estrutura exata muda de versão para versão, o que já é a primeira pista de que este não é um lugar sobre o qual construir um fluxo de trabalho.

Os dois apps também oferecem saídas legítimas. Clique com o botão direito num vídeo e você tem Guardar como… e Mostrar no Finder (Save As… e Show in Finder). No Telegram Desktop, Configurações > Avançado (Settings > Advanced) permite definir uma pasta de downloads para que os arquivos guardados caiam num lugar previsível, e Configurações > Dados e Armazenamento (Settings > Data and Storage) mostra o quanto a cache cresceu e permite limpá-la.

Por que copiar arquivos da cache não é uma resposta de verdade

Abra essa pasta de cache e você vai encontrar diretórios com nomes de dois caracteres, cheios de arquivos sem extensão e sem nenhum título reconhecível — apenas longas sequências derivadas de identificadores internos. Isso causa quatro problemas concretos:

• Você não consegue dizer o que é cada coisa. Nada liga um arquivo à conversa de onde ele veio, à legenda que tinha ou ao dia em que foi publicado. O Finder nem sequer pré-visualiza a maioria deles, porque, sem um .mp4 no fim, o macOS não sabe o que tem em mãos.
• Ela só contém o que você já carregou. Um vídeo que você nunca abriu, ou que o download automático ignorou, nunca entrou na cache. Rolar um canal de 4.000 mensagens para disparar os downloads não é um plano.
• O Telegram apaga o que está lá quando quer. A cache tem um limite de tamanho e um limite de idade. Arquivos que você pretendia manter podem desaparecer porque você assistiu a outra coisa.
• As datas estão erradas. Mesmo quando você encontra o arquivo certo e o renomeia à mão, a data dele é o momento em que o seu Mac o colocou na cache, não o momento em que o vídeo foi publicado.

Escavar a cache é uma forma de recuperar um arquivo de que você precisa desesperadamente. Não é uma forma de guardar vídeos do Telegram em qualquer escala.

Guardar vídeos do Telegram no Mac com um app dedicado

O TelegramBuddy é um app de desktop gratuito para macOS e Windows (no Linux dá para executá-lo a partir do código-fonte), feito exatamente para esta tarefa. Não é um bot nem um serviço web: não existe conta TelegramBuddy nem servidor TelegramBuddy. Um backend em Python fala com a própria API do Telegram, uma interface em React roda numa janela nativa do seu Mac, você entra no seu Telegram e os arquivos são escritos diretamente no seu disco local. Nada é enviado para lugar nenhum.

Chegar aos vídeos guardados é assim:

1. Instale o app. A página de download tem as instruções atuais.
2. Obtenha um api_id e um api_hash gratuitos. São as duas credenciais de API que o Telegram entrega a qualquer conta em my.telegram.org, em API development tools. Na primeira execução, o TelegramBuddy pede essas credenciais e as guarda localmente. Cada instalação usa o seu próprio par, porque o Telegram conta os limites de uso contra o api_id — existe um passo a passo se essa página for novidade para você.
3. Entre na sua própria conta do Telegram. Escaneie um código QR com o app do Telegram no seu telefone, ou use o seu número de telefone. A sessão resultante — o seu login — é um arquivo no seu Mac, e em nenhum outro lugar.
4. Abra a conversa. Escolha-a na sua lista, ou cole um @username, um id numérico, um link de convite t.me/+ ou um link para uma única mensagem de um canal privado, para chegar a algo que a lista não mostra.
5. Mude para a vista de galeria e filtre por Videos. A galeria é um mosaico de miniaturas só com fotos e vídeos, por isso você não passa por texto ao rolar. Você também pode pesquisar nas legendas e nos nomes de arquivo, e limitar a vista a um intervalo de datas.
6. Selecione o que quiser. Clique numa miniatura, shift-clique para um intervalo, ou use Select all (Selecionar tudo) / Files only (Apenas arquivos) quando quiser o conjunto inteiro.
7. Ou pule a seleção por completo e lance um download em massa: todos os arquivos correspondentes na conversa, varridos ao longo de todo o histórico dela. Várias conversas podem ficar na fila ao mesmo tempo.

Vale a pena dizer uma coisa com clareza: uma ferramenta que consegue trazer um canal inteiro de uma só vez não muda de quem é o que está lá dentro. Guarde apenas aquilo que você tem o direito de guardar.

Como ficam as pastas depois

Você obtém uma pasta por conversa, e pode fazer com que ela se divida em subpastas Photos / Videos / Files / Music / Voice (Fotos / Vídeos / Arquivos / Música / Voz), de modo que os vídeos já fiquem separados de todo o resto. Isso significa que um canal que você acompanha há um ano acaba como uma única pasta organizada, para a qual você pode apontar o iMovie, que pode incluir no backup ou arrastar para um disco externo — sem uma passagem posterior de arrumação.

Os nomes de arquivo que você recebe

Os nomes são a parte que as pessoas mais notam, porque o próprio Telegram é inconsistente aqui.

• Se o vídeo foi enviado como arquivo e tinha nome, esse nome é mantido exatamente.
• A maioria dos vídeos e fotos publicados no Telegram não tem nome nenhum. Esses recebem o nome do id da mensagem, o que os mantém únicos e na ordem de publicação.
• Se dois arquivos realmente colidem, o id da mensagem é acrescentado entre parênteses — clip.mp4 e clip (18452).mp4 — para que nada seja sobrescrito em silêncio.

Datas que coincidem com o dia em que o vídeo foi publicado

A data de cada arquivo guardado é definida como a data da mensagem de onde ele veio. Parece um detalhe menor e acaba importando constantemente: ordene a pasta de uma conversa por data no Finder e você recupera a linha do tempo do canal. Pesquise por intervalo de datas no Spotlight e você encontra a semana em que estava pensando. Bibliotecas de fotos e vídeos que leem as datas dos arquivos vão colocar os clipes onde eles pertencem, em vez de empilhar tudo no dia em que você rodou o download.

Três abordagens, lado a lado

	Arrastar da cache	Guardar como, um a um	Download em massa
Extensão correta	Não	Sim	Sim
Nome de arquivo original	Não	Sim, se tinha um	Sim, se tinha um
Data da publicação original	Não	Normalmente a data de hoje	Sim
Organizado em pastas por conversa	Não	Você faz isso	Sim
Prático para um canal inteiro	Não	Não muito	Sim
Sobrevive a uma queda de conexão	n/d	Recomeçar esse arquivo	Retoma onde parou
Ignora arquivos que você já tem	Não	Você controla	Sim

Essa linha da retomada é a que decide os trabalhos longos. Os vídeos são grandes, o Wi-Fi não é, e em algum momento você vai fechar a tampa. O TelegramBuddy executa vários downloads ao mesmo tempo — o limite é você que define — e cada um pode ser pausado, retomado, cancelado ou tentado de novo. Um arquivo grande que para no meio deixa um arquivo .part e continua exatamente daquele byte depois, mesmo que você feche o app; arquivos pequenos e fotos são simplesmente buscados de novo por inteiro, o que é mais rápido do que fazer a contabilidade. Arquivos já concluídos são ignorados na execução seguinte, por isso reexecutar um canal um mês depois traz apenas o que é novo, e os limites de uso do Telegram (os chamados “flood waits”) são aguardados pelo app em vez de chegarem a você como erros. Existe mais detalhe sobre downloads interrompidos se você está movendo um acervo grande.

Para onde ir a seguir

Se a conversa que lhe interessa é um canal e não um diálogo, baixar todos os vídeos de um canal do Telegram cobre a versão “coloque na fila e esqueça” disto. Se você quer as palavras além das fotos e dos vídeos — uma página HTML legível ou um JSON de toda a conversa, com os arquivos ligados — comece por exportar o histórico de conversas do Telegram. E o FAQ responde às duas perguntas que as pessoas sempre têm depois: por que o app precisa das suas próprias credenciais de API, e onde o seu arquivo de sessão realmente fica.