tg archive

tg-archive是一个用于将 Telegram 群聊导出到静态网站的工具，可以保留邮件列表档案等聊天历史记录。

预览

@fossunited Telegram 群组存档。

它是如何运作的

tg-archive 使用 Telethon Telegram API 客户端定期将消息从组同步到本地 SQLite 数据库（文件），仅下载自上次同步以来的新消息。然后，它会生成一个静态的消息存档网站，以便在任何地方发布。

特征

• 定期将 Telegram 群组消息同步到本地数据库。
• 将用户头像下载到本地。
• 下载并嵌入媒体（文件、文档、照片）。
• 呈现投票结果。
• 使用表情符号替代品代替贴纸。
• 用于生成静态站点的单个文件 Jinja HTML 模板。
• 年/月/日索引，具有跨页面深度链接。
• “回复”在带有跨页面父消息链接的回复中。
• 最近消息的 RSS / Atom 提要。

安装

• 获取 Telegram API 凭证。普通用户帐户 API，而不是机器人 API。
  • 如果此页面生成仅说明“错误”的警报，请断开与任何代理/VPN 的连接，然后在不同的浏览器中重试。
• 使用pip3 install tg-archive安装（使用 Python 3.8.6 测试）。

用法

1. tg-archive --new --path=mysite （创建一个新站点cd到 mysite 并编辑config.yaml ）。
2. tg-archive --sync （将数据同步到data.sqlite ）。注意：首次连接将提示您输入电话号码 + 发送到应用程序的 Telegram 授权码。身份验证成功后，将创建一个session.session文件。请勿公开共享此会话文件，因为它包含您帐户的 API 授权。
3. tg-archive --build （将静态站点构建到site目录中，可以发布）

定制化

编辑生成的template.html和./static目录中的静态资源来自定义站点。

笔记

• 可以随时停止同步 (Ctrl+C)，以便稍后恢复。
• 设置 cron 作业来定期同步消息并重新发布存档。
• 连续从大型群组下载大型媒体文件和长消息历史记录可能会遇到 Telegram API 的速率限制。观察调试输出。

根据 MIT 许可证获得许可。