telegram-history-dump

Esta utilidade é a sucessora do telegram-json-backup, escrita do zero em Ruby. Ela pode criar backups dos seus diálogos de usuário e (super)grupos do Telegram usando o recurso de controle remoto do telegram-cli.

Em comparação com o projeto antigo, o telegram-history-dump:

• Possui melhor suporte para downloads de mídia
• Suporta formatos de saída além de JSON e é extensível com formatos personalizados
• Suporta backup incremental (apenas mensagens novas são baixadas)
• Não depende de bindings instáveis de Python/Lua no telegram-cli
• Possui um arquivo de configuração formatado em YAML separado

A configuração padrão fará backup de todos os diálogos para um diretório chamado output, no formato JSON, sem baixar nenhuma mídia.

Uso

Configuração inicial

1. Compile o telegram-cli, inicie-o uma vez para vincular sua conta do Telegram
2. Certifique-se de que o Ruby 2+ está instalado no seu sistema: ruby --version
3. Opcionalmente, configure sua rotina de backup editando config.yaml

Realizando um backup

1. Inicie o telegram-cli com pelo menos as seguintes opções: telegram-cli --json -P 9009
2. Enquanto o telegram-cli estiver em execução, execute o script: ruby telegram-history-dump.rb

Formatadores

O histórico será sempre armazenado em arquivos compatíveis com JSON Lines. No entanto, formatos de saída adicionais podem ser produzidos descomentando algumas linhas no arquivo de configuração.

Você pode ativar um ou mais dos seguintes módulos de formatação:

html cria logs de chat estilizados e paginados, visualizáveis com um navegador web.

plaintext cria arquivos de texto legíveis por humanos, organizados como um arquivo por dia.

bare gera apenas os textos reais das mensagens sem qualquer contexto. Destina-se a análise linguística/estatística.

pisg cria logs diários compatíveis com o formato de registro do EnergyMech IRC como entrada para o gerador de estatísticas de chat PISG. Consulte também telegram-pisg.

Você também pode implementar um formatador personalizado; veja formatters/lib/formatter_base.rb para detalhes.

Opções de linha de comando

A maior parte da configuração do backup é feita através do arquivo de configuração, mas algumas opções específicas estão disponíveis como opções de CLI. Nenhuma delas é obrigatória.

Usage: telegram-history-dump.rb [options]
    -c, --config=cfg.yaml            Path to YAML configuration file
    -k, --kill-tg                    Kill telegram-cli after backup
    -h, --help                       Show help
    -d, --dir=DIR                    Subdirectory for output files
                                     (relative to backup_dir in YAML config)
    -l, --limit=LIMIT                Maximum number of messages to backup
                                     for each target (overrides YAML config)

Notas

Notas de uso:

• É possível executar o telegram-cli em uma máquina diferente, por exemplo, como um daemon em um servidor. Nesse caso, você deve passar --accept-any-tcp para o telegram-cli e configurar o firewall da porta adequadamente para evitar exposição indesejada. Lembre-se de que algumas opções relacionadas a arquivos de mídia não funcionarão em uma configuração remota.
• Tenha cuidado ao diminuir chunk_delay ou aumentar chunk_size. O Telegram parece limitar a taxa de solicitações de histórico. Ir muito rápido pode causar um tempo limite da operação e forçar o script a pular parte de um dump.

Problemas conhecidos do telegram-cli que afetam o telegram-history-dump:

• vysheng/tg#947 pode causar travamentos ao despejar canais com mais de 100 mensagens.
• vysheng/tg#904 pode causar travamentos quando os diálogos contêm determinados arquivos de mídia. Se isso ocorrer, recompile o telegram-cli com a solução alternativa sugerida.