tg archive

tg-archive は、 Telegram グループ チャットを静的 Web サイトにエクスポートし、メーリング リスト アーカイブのようにチャット履歴を保存するためのツールです。

プレビュー

@fossunited Telegram グループのアーカイブ。

仕組み

tg-archive は、Telethon Telegram API クライアントを使用して、グループからローカル SQLite データベース (ファイル) にメッセージを定期的に同期し、最後の同期以降の新しいメッセージのみをダウンロードします。次に、どこにでも公開できるメッセージの静的アーカイブ Web サイトを生成します。

特徴

• Telegram グループのメッセージをローカル DB に定期的に同期します。
• ユーザーのアバターをローカルにダウンロードします。
• メディア (ファイル、ドキュメント、写真) をダウンロードして埋め込みます。
• 投票結果をレンダリングします。
• ステッカーの代わりに絵文字の代替品を使用します。
• 静的サイトを生成するための単一ファイルの Jinja HTML テンプレート。
• ページ間のディープリンクを備えた年/月/日のインデックス。
• ページ全体の親メッセージへのリンクを含む返信の「返信中」。
• 最近のメッセージの RSS / Atom フィード。

インストール

• Telegram API 認証情報を取得します。ボット API ではなく、通常のユーザー アカウント API。
  • このページで「エラー」のみを示すアラートが表示される場合は、プロキシ/VPN から切断し、別のブラウザでもう一度試してください。
• pip3 install tg-archiveを使用してインストールします (Python 3.8.6 でテスト済み)。

使用法

1. tg-archive --new --path=mysite (新しいサイトを作成します。 mysite にcdて、 config.yamlを編集します)。
2. tg-archive --sync (データをdata.sqliteに同期します)。注: 初回接続時には、電話番号とアプリに送信される Telegram 認証コードの入力が求められます。認証に成功すると、 session.sessionファイルが作成されます。このセッション ファイルにはアカウントの API 認証が含まれているため、公開して共有しないでください。
3. tg-archive --build (静的サイトをsiteディレクトリに構築し、公開可能)

カスタマイズ

./staticディレクトリで生成されたtemplate.htmlと静的アセットを編集して、サイトをカスタマイズします。

注記

• 同期はいつでも停止 (Ctrl+C) でき、後で再開できます。
• cron ジョブをセットアップしてメッセージを定期的に同期し、アーカイブを再公開します。
• 大規模なグループから大きなメディア ファイルや長いメッセージ履歴を継続的にダウンロードすると、Telegram API のレート制限に達する可能性があります。デバッグ出力を確認します。

MITライセンスに基づいてライセンスされています。