Skip to content

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.

Notifications You must be signed in to change notification settings

bohd4nx/EmojiSaver

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Telegram Emoji & Sticker Downloader

Python aiogram 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.

🤖 @EmojiSaverBot

✨ 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

    git clone https://github.com/bohd4nx/EmojiSaver.git
    cd EmojiSaverBot
  2. Install dependencies

    pip install -r requirements.txt
  3. Configure environment

    • Create or modify data/config.py:
    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

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 file for details.


Made with ❤️ by @bohd4nx

GitHub stars

About

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.

Topics

Resources

Stars

Watchers

Forks

Languages