Charlotte

Charlotte is your go-to Telegram bot for downloading audio and video from various popular sites. Share a link with her, and get your file in seconds.

Report Bug · Request Feature · Use For Free

⚠️ This repository is no longer actively maintained.
It remains available as a reference and open archive for those who want to explore or reuse its code.
Charlotte continues to evolve in private development. You can always use it for free. @ZefirkaFox_Bot

If you like this repository, feel free to leave a star ⭐ to motivate me improve!

Available Services

• Youtube / Shorts
• Youtube Music
• SoundCloud
• Spotify
• Apple Music
• Pinterest
• Instagram
• Pixiv
• X (Twitter)
• Reddit
• BiliBili
• TikTok

》Features

• High speed
• Simple & intuitive
• Customizable
• Multilingual
• Wide media support
• Friendly personality
• Regularly updated
• Audio & video support
• Lightweight

》Requirements

• Python (optional)
• Telegram Bot Token. Get it from BotFather
• Spotify client ID for Spotify support Click here to get
• Spotify client Secret for Spotify support Click here to get

》Installation Guide

Clone the repo by running

git clone https://github.com/JellyTyan/Charlotte.git

After cloning Fill all requirement in /config/.env (rename .env.example to .env)

Configure virtual environment

python3 -m venv venv

Then enter to venv

Windows

./venv/Scripts/activate

Linux / MacOS

source ./venv/bin/activate

Install all dependents

pip install -r requierements.txt

Run this command for compiling languages

pybabel compile -d locales -D messages

Run bot with

python3 main.py

All done!

》Support

Basement - Charlotte's Basement, where she tells all change logs or service status.

Charlotte is developed and maintained by @JellyTyan.
This repository is provided as-is for reference and learning purposes.