telegram-history-dump

Questo strumento è il successore di telegram-json-backup, scritto da zero in Ruby. Può creare backup dei tuoi dialoghi utente e di gruppo (supergruppi) di Telegram utilizzando la funzionalità di controllo remoto di telegram-cli.

Rispetto al vecchio progetto, telegram-history-dump:

• Ha un supporto migliore per il download di file multimediali
• Supporta formati di output diversi da JSON ed è estensibile con formati personalizzati
• Supporta il backup incrementale (vengono scaricati solo i nuovi messaggi)
• Non dipende dai legami Python/Lua instabili all'interno di telegram-cli
• Ha un file di configurazione separato in formato YAML

La configurazione predefinita eseguirà il backup di tutti i dialoghi in una directory denominata output, in formato JSON, senza scaricare alcun file multimediale.

Utilizzo

Configurazione iniziale

1. Compila telegram-cli, avviarlo una volta per collegare il tuo account Telegram
2. Assicurati che Ruby 2+ sia installato sul tuo sistema: ruby --version
3. Opzionalmente configura la tua routine di backup modificando config.yaml

Esecuzione di un backup

1. Avvia telegram-cli con almeno le seguenti opzioni: telegram-cli --json -P 9009
2. Mentre telegram-cli è in esecuzione, esegui lo script: ruby telegram-history-dump.rb

Formattatori

La cronologia verrà sempre archiviata in file conformi a JSON Lines. Tuttavia, è possibile produrre formati di output aggiuntivi decommentando alcune righe nel file di configurazione.

Puoi abilitare uno o più dei seguenti moduli di formattazione:

html crea registri chat stilizzati e impaginati visualizzabili con un browser web.

plaintext crea file di testo leggibili dall'uomo, organizzati come un file al giorno.

bare produce solo i testi effettivi dei messaggi senza contesto. È pensato per analisi linguistiche/statistiche.

pisg crea registri giornalieri compatibili con il formato di logging IRC di EnergyMech come input per il generatore di statistiche chat PISG. Vedi anche telegram-pisg.

Puoi anche implementare un formattatore personalizzato; consulta formatters/lib/formatter_base.rb per i dettagli.

Opzioni della riga di comando

La maggior parte della configurazione di backup viene effettuata tramite il file di configurazione, ma alcune opzioni specifiche sono disponibili come opzioni CLI. Nessuna di esse è obbligatoria.

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)

Note

Note d'uso:

• È possibile eseguire telegram-cli su una macchina diversa, ad esempio come demone su un server. In questo caso è necessario passare --accept-any-tcp a telegram-cli e configurare il firewall sulla porta in modo appropriato per prevenire esposizioni indesiderate. Tieni presente che alcune opzioni relative ai file multimediali non funzioneranno in una configurazione remota.
• Fai attenzione a diminuire chunk_delay o aumentare chunk_size. Telegram sembra limitare le richieste di cronologia. Andare troppo veloce potrebbe causare il timeout di un'operazione e costringere lo script a saltare parte di un dump.

Problemi di telegram-cli noti che influenzano telegram-history-dump:

• vysheng/tg#947 può causare crash durante il dump di canali con più di 100 messaggi.
• vysheng/tg#904 può causare crash quando i dialoghi contengono determinati file multimediali. Se riscontri questo problema, ricompila telegram-cli con la soluzione alternativa suggerita.