telegram-history-dump

Esta utilidad es la sucesora de telegram-json-backup, escrita desde cero en Ruby. Permite crear copias de seguridad de tus diálogos de usuario y (súper)grupos de Telegram utilizando la función de control remoto de telegram-cli.

En comparación con el proyecto anterior, telegram-history-dump:

• Tiene mejor soporte para descargas de archivos multimedia
• Soporta formatos de salida distintos de JSON y es extensible con formatos personalizados
• Soporta copia de seguridad incremental (solo se descargan mensajes nuevos)
• No depende de los inestables enlaces Python/Lua dentro de telegram-cli
• Tiene un archivo de configuración separado en formato YAML

La configuración predeterminada respaldará todos los diálogos en un directorio llamado output, en formato JSON, sin descargar ningún archivo multimedia.

Uso

Configuración inicial

1. Compila telegram-cli, inícialo una vez para vincular tu cuenta de Telegram
2. Asegúrate de que Ruby 2+ esté instalado en tu sistema: ruby --version
3. Opcionalmente, configura tu rutina de respaldo editando config.yaml

Realizar una copia de seguridad

1. Inicia telegram-cli con al menos las siguientes opciones: telegram-cli --json -P 9009
2. Mientras telegram-cli se está ejecutando, ejecuta el script: ruby telegram-history-dump.rb

Formateadores

El historial siempre se almacenará en archivos compatibles con JSON Lines. Sin embargo, se pueden generar formatos de salida adicionales descomentando algunas líneas en el archivo de configuración.

Puedes habilitar uno o más de los siguientes módulos formateadores:

html crea registros de chat con estilo y paginados, visibles mediante un navegador web.

plaintext crea archivos de texto legibles por humanos, organizados como un archivo por día.

bare genera solo los textos reales de los mensajes sin ningún contexto. Está pensado para análisis lingüísticos/estadísticos.

pisg crea registros diarios compatibles con el formato de registro IRC de EnergyMech como entrada para el generador de estadísticas de chat PISG. Consulta también telegram-pisg.

También puedes implementar un formateador personalizado; consulta formatters/lib/formatter_base.rb para más detalles.

Opciones de línea de comandos

La mayor parte de la configuración de la copia de seguridad se realiza a través del archivo de configuración, pero algunas opciones específicas están disponibles como opciones de CLI. Ninguna de ellas es obligatoria.

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:

• Es posible ejecutar telegram-cli en una máquina diferente, por ejemplo, como un demonio en un servidor. En ese caso, debes pasar --accept-any-tcp a telegram-cli y proteger el puerto con un firewall adecuadamente para evitar una exposición no deseada. Ten en cuenta que algunas opciones relacionadas con archivos multimedia no funcionarán en una configuración remota.
• Ten cuidado al reducir chunk_delay o aumentar chunk_size. Telegram parece limitar la velocidad de las solicitudes de historial. Ir demasiado rápido puede provocar un tiempo de espera en una operación y forzar al script a omitir parte de un volcado.

Problemas conocidos de telegram-cli que afectan a telegram-history-dump:

• vysheng/tg#947 puede causar fallos al volcar canales con más de 100 mensajes.
• vysheng/tg#904 puede causar fallos cuando los diálogos contienen ciertos archivos multimedia. Si te ocurre esto, recompila telegram-cli con la solución sugerida.