telegram-history-dump

Cet utilitaire est le successeur de telegram-json-backup, écrit entièrement en Ruby. Il peut créer des sauvegardes de vos discussions utilisateur et de (super)groupes Telegram en utilisant la fonction de contrôle à distance de telegram-cli.

Comparé à l'ancien projet, telegram-history-dump :

• Offre un meilleur support pour les téléchargements de médias
• Prend en charge d'autres formats de sortie que JSON et est extensible avec des formats personnalisés
• Prend en charge la sauvegarde incrémentielle (seuls les nouveaux messages sont téléchargés)
• Ne dépend pas des liaisons Python/Lua instables dans telegram-cli
• Possède un fichier de configuration séparé au format YAML

La configuration par défaut sauvegardera toutes les discussions dans un répertoire nommé output, au format JSON, sans télécharger aucun média.

Utilisation

Configuration initiale

1. Compilez telegram-cli, démarrez-le une fois pour lier votre compte Telegram
2. Assurez-vous que Ruby 2+ est installé sur votre système : ruby --version
3. Optionnellement, configurez votre routine de sauvegarde en éditant config.yaml

Effectuer une sauvegarde

1. Démarrez telegram-cli avec au moins les options suivantes : telegram-cli --json -P 9009
2. Pendant que telegram-cli est en cours d'exécution, exécutez le script : ruby telegram-history-dump.rb

Formateurs

L'historique sera toujours stocké dans des fichiers conformes à JSON Lines. Cependant, des formats de sortie supplémentaires peuvent être produits en décommentant quelques lignes dans le fichier de configuration.

Vous pouvez activer un ou plusieurs des modules de formatage suivants :

html crée des journaux de chat stylisés et paginés, consultables avec un navigateur web.

plaintext crée des fichiers texte lisibles, organisés en un fichier par jour.

bare produit uniquement les textes de messages réels sans contexte. Il est destiné à l'analyse linguistique / statistique.

pisg crée des journaux quotidiens compatibles avec le format de journalisation IRC EnergyMech comme entrée pour le générateur de statistiques de chat PISG. Voir aussi telegram-pisg.

Vous pouvez également implémenter un formateur personnalisé ; voir formatters/lib/formatter_base.rb pour plus de détails.

Options de ligne de commande

La plupart de la configuration de sauvegarde se fait via le fichier de config, mais quelques options spécifiques sont disponibles en tant qu'options CLI. Aucune d'entre elles n'est obligatoire.

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)

Remarques

Notes d'utilisation :

• Il est possible d'exécuter telegram-cli sur une machine différente, par exemple en tant que démon sur un serveur. Dans ce cas, vous devez passer --accept-any-tcp à telegram-cli et configurer le pare-feu du port de manière appropriée pour éviter une exposition indésirable. Gardez à l'esprit que certaines options concernant les fichiers médias ne fonctionneront pas dans une configuration distante.
• Soyez prudent en diminuant chunk_delay ou en augmentant chunk_size. Telegram semble limiter le débit des demandes d'historique. Aller trop vite peut entraîner un délai d'attente et forcer le script à sauter une partie d'une sauvegarde.

Problèmes de Telegram-cli connus pour affecter telegram-history-dump :

• vysheng/tg#947 peut provoquer des plantages lors de la sauvegarde de canaux contenant plus de 100 messages.
• vysheng/tg#904 peut provoquer des plantages lorsque des discussions contiennent certains fichiers médias. Si vous rencontrez cela, recompilez telegram-cli avec la solution de contournement suggérée.