https://github.com/bohd4nx/emojisaver
Telegram bot that saves animated stickers (.tgs) and custom emojis, converts them to .json (Lottie), packs everything into a neat archive, and delivers it to the user.
https://github.com/bohd4nx/emojisaver
emoji lottie-animation lottie-telegram stickers telegram tgs
Last synced: 7 months ago
JSON representation
Telegram bot that saves animated stickers (.tgs) and custom emojis, converts them to .json (Lottie), packs everything into a neat archive, and delivers it to the user.
- Host: GitHub
- URL: https://github.com/bohd4nx/emojisaver
- Owner: bohd4nx
- Created: 2025-02-16T03:09:58.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-05-07T21:40:44.000Z (7 months ago)
- Last Synced: 2025-05-11T12:47:33.896Z (7 months ago)
- Topics: emoji, lottie-animation, lottie-telegram, stickers, telegram, tgs
- Language: Python
- Homepage: https://t.me/EmojiSaverBot
- Size: 27.3 KB
- Stars: 5
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Telegram Emoji & Sticker Downloader
[](https://www.python.org/downloads/)
[](https://docs.aiogram.dev/)
[](LICENSE)
This Telegram bot allows users to extract and download animated emoji and stickers in both TGS (Telegram format) and
JSON (Lottie) formats, making them available for editing in animation software.
## ✨ Features
- 🎯 **Extract Animated Emoji** - Download custom emoji from messages
- 🎭 **Convert Stickers** - Transform animated stickers to editable formats
- 🔄 **Multiple Emoji Support** - Process several emoji in a single message
- 📦 **Dual Format Export** - Get both TGS and JSON formats in one archive
## 🛠 Installation
1. **Clone the repository**
```bash
git clone https://github.com/bohd4nx/EmojiSaver.git
cd EmojiSaverBot
```
2. **Install dependencies**
```bash
pip install -r requirements.txt
```
3. **Configure environment**
- Create or modify `data/config.py`:
```python
from dataclasses import dataclass
@dataclass(frozen=True)
class Config:
# API credentials from https://my.telegram.org/apps
API_ID: str = "your_api_id"
API_HASH: str = "your_api_hash"
# Bot token from @BotFather
BOT_TOKEN: str = "your_bot_token"
# Phone number in international format
PHONE_NUMBER: str = "+1234567890"
# Directory for temporary files
DOWNLOAD_DIR: str = "../temp"
config = Config()
```
## 🚀 Usage
### Running the Bot
```bash
python main.py
```
### User Guide
| Command | Description |
|----------|----------------------------|
| `/start` | Initialize the bot |
| `/help` | Display usage instructions |
#### 📱 Using with Emoji
1. Send any message containing custom animated emoji
2. The bot will automatically extract and convert all emoji
3. Download the ZIP archive containing both formats
#### 🎭 Using with Stickers
1. Forward any animated sticker to the bot
2. The bot will convert it to editable format
3. Download and enjoy!
## 🧩 Development
Want to contribute? Great! Here's how:
1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add some amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
---
