https://github.com/jellytyan/charlotte
Powerful Telegram Bot for downloading content from many sources, such as Youtube, Tiktok, Spotify etc.
https://github.com/jellytyan/charlotte
aiogram aiogram-bot apple-music-downloader bot instagram-downloader soundcloud-downloader spotify-downloader telegram telegram-bot tiktok-downloader youtube-downloader
Last synced: 5 months ago
JSON representation
Powerful Telegram Bot for downloading content from many sources, such as Youtube, Tiktok, Spotify etc.
- Host: GitHub
- URL: https://github.com/jellytyan/charlotte
- Owner: JellyTyan
- License: mit
- Created: 2024-09-05T20:30:37.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-06-16T17:20:57.000Z (12 months ago)
- Last Synced: 2025-06-16T17:39:40.452Z (12 months ago)
- Topics: aiogram, aiogram-bot, apple-music-downloader, bot, instagram-downloader, soundcloud-downloader, spotify-downloader, telegram, telegram-bot, tiktok-downloader, youtube-downloader
- Language: Python
- Homepage: https://t.me/ZefirkaFox_Bot
- Size: 771 KB
- Stars: 12
- Watchers: 1
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: docs/CONTRIBUTING.MD
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
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!
[](https://github.com/JellyTyan/Charlotte)
## 
Available Services
- [x] Youtube / Shorts
- [x] Youtube Music
- [x] SoundCloud
- [x] Spotify
- [x] Apple Music
- [x] Pinterest
- [x] Instagram
- [x] Pixiv
- [x] X (Twitter)
- [x] Reddit
- [x] BiliBili
- [x] TikTok
## 
》Features
- [x] High speed
- [x] Simple & intuitive
- [x] Customizable
- [x] Multilingual
- [x] Wide media support
- [x] Friendly personality
- [x] Regularly updated
- [x] Audio & video support
- [x] Lightweight
## 
》Requirements
- Python (optional)
- Telegram Bot Token. Get it from [BotFather](https://t.me/BotFather)
- Spotify client ID `for Spotify support` [Click here to get](https://developer.spotify.com/dashboard/login)
- Spotify client Secret `for Spotify support` [Click here to get](https://developer.spotify.com/dashboard/login)
## 
》Installation Guide
Clone the repo by running
```bash
git clone https://github.com/JellyTyan/Charlotte.git
```
### After cloning Fill all requirement in `/config/.env` **(rename `.env.example` to `.env`)**
### Configure virtual environment
```bash
python3 -m venv venv
```
#### Then enter to venv
Windows
```bash
./venv/Scripts/activate
```
Linux / MacOS
```bash
source ./venv/bin/activate
```
### Install all dependents
```bash
pip install -r requierements.txt
```
### Run this command for compiling languages
```bash
pybabel compile -d locales -D messages
```
### Run bot with
```bash
python3 main.py
```
### All done!
## 
》Support
[](https://t.me/charlottesbasement)
[Basement](https://t.me/charlottesbasement) - 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.