telegram-history-dump

Dieses Dienstprogramm ist der Nachfolger von telegram-json-backup, neu geschrieben in Ruby. Es kann Backups Ihrer Telegram-Benutzer- und (Super-)Gruppen-Dialoge mit der Fernsteuerungsfunktion von telegram-cli erstellen.

Im Vergleich zum alten Projekt bietet telegram-history-dump:

• Bessere Unterstützung für Mediendownloads
• Unterstützt andere Ausgabeformate als JSON und ist durch benutzerdefinierte Formate erweiterbar
• Unterstützt inkrementelle Backups (nur neue Nachrichten werden heruntergeladen)
• Ist nicht von instabilen Python/Lua-Bindungen innerhalb von telegram-cli abhängig
• Verfügt über eine separate YAML-konfigurierte Konfigurationsdatei

Die Standardkonfiguration sichert alle Dialoge in ein Verzeichnis namens output im JSON-Format, ohne Medien herunterzuladen.

Verwendung

Ersteinrichtung

1. Kompilieren Sie telegram-cli, starten Sie es einmal, um Ihr Telegram-Konto zu verknüpfen
2. Stellen Sie sicher, dass Ruby 2+ auf Ihrem System installiert ist: ruby --version
3. Optional können Sie Ihre Backup-Routine durch Bearbeiten der config.yaml konfigurieren

Durchführen eines Backups

1. Starten Sie telegram-cli mit mindestens den folgenden Optionen: telegram-cli --json -P 9009
2. Während telegram-cli läuft, führen Sie das Skript aus: ruby telegram-history-dump.rb

Formatvorlagen

Der Verlauf wird immer in JSON Lines-konformen Dateien gespeichert. Es können jedoch zusätzliche Ausgabeformate erzeugt werden, indem Sie einige Zeilen in der Konfigurationsdatei auskommentieren.

Sie können eines oder mehrere der folgenden Formatvorlagen-Module aktivieren:

html erstellt gestaltete, seitenweise Chatprotokolle, die mit einem Webbrowser betrachtet werden können.

plaintext erstellt menschenlesbare Textdateien, organisiert als eine Datei pro Tag.

bare gibt nur die eigentlichen Nachrichtentexte ohne Kontext aus. Es ist für die linguistische/statistische Analyse gedacht.

pisg erstellt tägliche Protokolle, die mit dem EnergyMech-IRC-Logging-Format kompatibel sind, als Eingabe für den PISG-Chat-Statistikgenerator. Siehe auch telegram-pisg.

Sie können auch einen benutzerdefinierten Formatierer implementieren; siehe formatters/lib/formatter_base.rb für Details.

Kommandozeilenoptionen

Der Großteil der Backup-Konfiguration erfolgt über die Konfigurationsdatei, aber einige spezifische Optionen sind als CLI-Optionen verfügbar. Keine davon ist obligatorisch.

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)

Hinweise

Nutzungshinweise:

• Es ist möglich, telegram-cli auf einem anderen Rechner auszuführen, z. B. als Daemon auf einem Server. In diesem Fall müssen Sie --accept-any-tcp an telegram-cli übergeben und den Port entsprechend mit einer Firewall schützen, um unerwünschte Exposition zu vermeiden. Beachten Sie, dass einige Optionen bezüglich Mediendateien in einer entfernten Einrichtung nicht funktionieren.
• Seien Sie vorsichtig bei der Verringerung von chunk_delay oder Erhöhung von chunk_size. Telegram scheint die Geschwindigkeit von Verlaufsanfragen zu begrenzen. Eine zu hohe Geschwindigkeit kann zu Zeitüberschreitungen führen und das Skript zwingen, einen Teil des Dumps zu überspringen.

Bekannte Probleme von telegram-cli, die telegram-history-dump betreffen:

• vysheng/tg#947 kann Abstürze verursachen, wenn Kanäle mit mehr als 100 Nachrichten gesichert werden.
• vysheng/tg#904 kann Abstürze verursachen, wenn Dialoge bestimmte Mediendateien enthalten. Falls dies auftritt, kompilieren Sie telegram-cli mit dem vorgeschlagenen Workaround neu.