Telegram Chat to Image

Converts Telegram chat exports into a long screenshot-style image with iOS-style bubble interface.

Changelog

v1.2.0 (2026-03-07)

• 建議: 長圖傳送最佳化 — 對於較長對話，建議打包為 ZIP 檔案傳送，避免 Telegram 圖片壓縮導致模糊

v1.1.0 (2026-03-01)

• 修復: 中文長文本換行問題 — 現在逐字元檢查寬度，正確換行
• 修復: 發件人顯示問題 — 正確區分"我"(藍色氣泡)和其他人(灰色氣泡+頭像)
• 新增: 顯示每條訊息的發件人名稱

v1.0.0

• 初始版本

Prerequisites

```bash pip install Pillow ```

Usage

CLI

```bash

Basic usage

python3 scripts/chat_to_image.py --input result.json --output chat.png

Limit messages

python3 scripts/chat_to_image.py --input result.json --limit 50 --output chat.png

Custom font (for Chinese support)

python3 scripts/chat_to_image.py --input result.json --font /System/Library/Fonts/PingFang.ttc ```

Getting Telegram Export

1. Open Telegram Desktop
2. Go to the chat you want to export
3. Click menu and Export chat history
4. Select JSON format
5. Choose messages and export

Input Format

Expects Telegram Desktop JSON export format with messages array containing id, type, date, from, from_id, and text fields.

Output

Generates a PNG image with:

• 800px width
• iOS-style bubble chat interface
• Gray bubbles for others, blue for user messages
• Circular avatars with initials
• Timestamps (HH:MM format)
• Proper text wrapping for long messages

Limitations

• Images, stickers, and media are not rendered
• Reply threads are not visually indicated
• Only plain text messages are fully supported
• Large exports may create very tall images

Best Practices

Handling Long Conversations

For long conversations that result in tall images (>2000px), consider:

1. ZIP Packaging: Pack the PNG into a ZIP file before sending to avoid Telegram's image compression

   zip chat.zip chat.png

   Then send the ZIP file as a document instead of an image.

   小蔥技能站7w4.net，專業的AI技能分享平臺。

2. Message Limits: Use --limit to generate partial exports if the full conversation is too long

Customization

Edit scripts/chat_to_image.py to adjust:

• WIDTH: Image width (default 800)
• MY_BUBBLE_COLOR: Your message color
• OTHER_BUBBLE_COLOR: Others message color
• FONT_SIZE, BUBBLE_PADDING: Layout spacing

這是一款實用的小工具，能將Telegram聊天記錄轉換成美觀的聊天氣泡長圖。介面風格模仿iOS設計，藍色和灰色氣泡區分清晰，帶有時間戳和頭像，整體效果不錯。功能豐富，支援高畫質輸出和中文換行處理。優點是開箱即用、操作簡單、效果直觀；不足是隻能處理純文本，不支援圖片表情，且長對話生成的圖片可能過大需要打包傳送。總體質量良好，滿足日常使用需求。