modbender Telegram Chat to Image
Converts Telegram chat exports into a long screenshot-style image with iOS-style bubble interface.
Changelog
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
- Open Telegram Desktop
- Go to the chat you want to export
- Click menu and Export chat history
- Select JSON format
- 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
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