<div align="center"> <img src="icon.svg" alt="Emoji Saver Bot Logo" width="120" height="120" style="border-radius: 24px;"> <h1 style="margin-top: 24px;">Telegram Emoji Saver Bot</h1> <p style="font-size: 18px; margin-bottom: 24px;"> <strong>Extract and convert Telegram custom emoji and stickers to TGS, JSON, Lottie, and PNG formats</strong> </p> <p> <a href="https://python.org"><img alt="Python" src="https://img.shields.io/badge/Python-3.12+-3776AB?style=flat&logo=python&logoColor=white"></a> <a href="https://github.com/aiogram/aiogram"><img alt="aiogram" src="https://img.shields.io/badge/aiogram-3.26.0-2CA5E0?style=flat&logo=telegram&logoColor=white"></a> <a href="https://github.com/bohd4nx/EmojiSaver/stargazers"><img alt="Stars" src="https://img.shields.io/github/stars/bohd4nx/EmojiSaver?style=flat&color=yellow"></a> <a href="https://github.com/bohd4nx/EmojiSaver/issues"><img alt="Issues" src="https://img.shields.io/github/issues/bohd4nx/EmojiSaver?style=flat&color=red"></a> </p> <p> <a href="https://github.com/bohd4nx/EmojiSaver/issues">Report Bug</a> · <a href="https://github.com/bohd4nx/EmojiSaver/issues">Request Feature</a> · <a href="https://t.me/EmojiSaverBot"><strong>Demo Bot</strong></a> · <a href="https://t.me/send?start=IV33ltNgzUFL"><strong>Donate</strong></a> </p> </div>

Features

Download and convert Telegram stickers
Extract custom (premium) emoji from messages
Download full sticker and emoji packs from t.me links
Auto-detect file format (TGS, WebM, WebP, MP4, GIF, etc.)
Auto-split large archives into 45 MB parts
Progress updates during pack processing
Multi-language support (English and Russian)

Quick Start

1. Installation

git clone https://github.com/bohd4nx/EmojiSaver.git
cd EmojiSaver
pip install -r requirements.txt

2. Configuration

Create .env file in project root:

# Your bot token, get it from @BotFather
BOT_TOKEN=1234567890:your_bot_token_from_@botfather

# Rate limit cooldown in seconds (default: 5)
RATE_LIMIT_COOLDOWN=5

3. Run

python main.py

Usage

Bot Commands

/start - Welcome message and instructions
/help - Detailed usage guide

Custom Emoji Extraction

Forward or send message with an animated custom emoji
Wait for processing
Download ZIP archive with all formats
Edit in your favorite animation software

Sticker Conversion

Forward or send any sticker to bot
Wait for processing
Download ZIP archive with converted formats (or original file)
Use in After Effects, Figma, or LottieFiles

Pack Download

Send pack URL (e.g., https://t.me/addstickers/YourPack or https://t.me/addemoji/YourPack)
Watch progress as bot processes each item
Download complete archive with all stickers/emoji converted
Edit entire pack in your workflow

💡 Tip: For regular static emoji, use the StaticEmoji pack:
https://t.me/addemoji/StaticEmoji or https://t.me/addstickers/StaticEmoji

Format Compatibility

Output Formats

| Format | Extension | Software Compatibility | Use Case | | ---------- | --------- | --------------------------------------------- | ------------------------------------ | | TGS | .tgs | Telegram | Upload as custom emoji/stickers | | JSON | .json | Adobe After Effects, Figma, Lottie Web Player | Edit animations, web implementation | | PNG | .png | Photoshop, GIMP, Any image viewer | Raster preview, 512x512 pixels | | Lottie | .lottie | LottieFiles, Android/iOS apps | Cross-platform animation integration |

Input Requirements

Type: Any Telegram sticker or custom emoji
Supported Formats:
- TGS (Lottie-based animations) - converted to JSON, Lottie, PNG
- WebM, WebP, MP4, GIF, PNG, JPG, JPEG, MKV - saved as original without conversion

Processing Pipeline

Download - Retrieve sticker/emoji files from Telegram servers
Format Detection - Detect file type by magic bytes and file extension fallback
Conversion (TGS only) - Generate JSON, Lottie, and PNG formats
Packaging - Compress files into ZIP archives (max 45 MB per part)
Delivery - Send back to user with multi-part support when needed

Made with ❤️ by @bohd4nx

Star ⭐ this repo if you found it useful!

</div>

EmojiSaver

Install / Use

README