TgMusicBot - Telegram Music Bot
Telegram Group Calls Streaming bot with some useful features, written in Python with Py-Tgcalls. Supporting platforms like YouTube, Spotify, Apple Music, Soundcloud, JioSaavn and more.
@FallenBeatzBot - Try it now!
Say goodbye to restrictions with our Premium Music API – your ultimate solution for seamless, high-quality downloads.
- Easy Integration – Just set
API_URLin your bot configuration. - High-Quality Downloads – Get music from Spotify, Apple Music, SoundCloud, and YouTube in top quality.
- Unlimited Access – No limits, no interruptions – download as much as you want.
➡️ Click here for more details
📩 Contact me on Telegram to get access!
📘 Check out this guide for instructions on downloading and using them.
- Multi-Platform Support - Play music from Spotify, YT-Music, YouTube, JioSaavn, Apple Music, SoundCloud and Telegram files.
- Playlists & Queue - Seamless music playback with queue management.
- Full Playback Controls - Skip, Pause, Resume, End, Mute, Unmute, Volume, Loop, Seek.
- Group Voice Chats - Supports Telegram group voice chats (requires admin permissions).
- Optimized Performance - Fully async, efficient, and lightweight.
- Easy Deployment - Pre-configured Docker setup.
- Open-Source & Free - Built from scratch using PyTdBot & PyTgCalls.
💡 Prefer using Pyrogram instead of PyTdBot? Check out the Pyro-Branch.
Dependencies Tree: Click to expand
tgmusicbot v1.1.7
├── aiofiles v24.1.0
├── apscheduler v3.11.0
│ └── tzlocal v5.3.1
├── cachetools v5.5.2
├── kurigram v2.2.0
│ ├── pyaes v1.6.1
│ └── pysocks v1.7.1
├── meval v2.5
├── motor v3.7.0
│ └── pymongo v4.12.0
│ └── dnspython v2.7.0
├── mutagen v1.47.0
├── ntgcalls v1.3.3
├── pillow v11.2.1
├── psutil v7.0.0
├── py-tgcalls v2.1.1
│ ├── aiohttp v3.11.16
│ │ ├── aiohappyeyeballs v2.6.1
│ │ ├── aiosignal v1.3.2
│ │ │ └── frozenlist v1.6.0
│ │ ├── attrs v25.3.0
│ │ ├── frozenlist v1.6.0
│ │ ├── multidict v6.4.3
│ │ ├── propcache v0.3.1
│ │ └── yarl v1.20.0
│ │ ├── idna v3.10
│ │ ├── multidict v6.4.3
│ │ └── propcache v0.3.1
│ ├── deprecation v2.1.0
│ │ └── packaging v24.2
│ └── ntgcalls v1.3.3
├── py-yt-search v0.2
│ └── httpx v0.28.1
│ ├── anyio v4.9.0
│ │ ├── idna v3.10
│ │ └── sniffio v1.3.1
│ ├── certifi v2025.1.31
│ ├── httpcore v1.0.8
│ │ ├── certifi v2025.1.31
│ │ └── h11 v0.14.0
│ └── idna v3.10
├── pycryptodome v3.22.0
├── pydantic v2.11.3
│ ├── annotated-types v0.7.0
│ ├── pydantic-core v2.33.1
│ │ └── typing-extensions v4.13.2
│ ├── typing-extensions v4.13.2
│ └── typing-inspection v0.4.0
│ └── typing-extensions v4.13.2
├── pytdbot v0.9.2
│ ├── aio-pika v9.5.5
│ │ ├── aiormq v6.8.1
│ │ │ ├── pamqp v3.3.0
│ │ │ └── yarl v1.20.0 (*)
│ │ ├── exceptiongroup v1.2.2
│ │ └── yarl v1.20.0 (*)
│ └── deepdiff v8.4.2
│ └── orderly-set v5.4.0
├── pytgcrypto v1.2.9.2
├── python-dotenv v1.1.0
├── pytz v2025.2
├── tdjson v1.8.47
├── ujson v5.10.0
└── yt-dlp v2025.3.31
📌 Using Docker (Recommended) (Click to expand)
Check here for installation instructions.
- Clone the repository:
git clone https://github.com/nothing-bots/dan.git && cd dan
- Build the Docker image:
docker build -t tgmusicbot . - Set up environment variables:
cp sample.env .env && vi .env - Run the Docker container:
docker run -d --name tgmusicbot --env-file .env tgmusicbot
📌 Manual Installation (Click to expand)
1.Update and Upgrade your system:
sudo apt-get update && sudo apt-get upgrade -y2.Install tmux to keep running your bot when you close the terminal by:
sudo apt install tmux && tmux3.Install required packages:
sudo apt-get install git python3-pip ffmpeg -y && pip3 install uv4.Clone the repository:
git clone https://github.com/AshokShau/TgMusicBot.git && cd TgMusicBot5.Create a virtual environment:
uv venv6.Activate the virtual environment:
- Windows:
.venv/Scripts/activate - Linux/Mac:
source .venv/bin/activate
7.Install dependencies:
uv pip install -e .8.Set up environment variables:
cp sample.env .env && vi .envPress
Ctrl+Cwhen you're done with editing env and:wqto save the environment variables.
9.Finally, run the bot by:
tgmusicbotFor getting out from tmux session: Press
Ctrl+band thend.
Deploy on Heroku (Click to expand)
📌 Environment Variables (Click to expand)
- API_ID – Get from my.telegram.org
- API_HASH – Get from my.telegram.org
- TOKEN – Get from @BotFather
- STRING1 - Pyrogram String Session, STRING2 ... STRING10
Get from @StringFatherBot
- OWNER_ID – Your Telegram User ID
- MONGO_URI – Get from MongoDB Cloud
- API_URL – Buy from @AshokShau (Spotify API for unlimited downloads)
- API_KEY – Required for API_URL
- DOWNLOADS_DIR – Directory for downloads and TDLib database
- SUPPORT_GROUP – Support Group Link
- SUPPORT_CHANNEL – Support Channel Link
- IGNORE_BACKGROUND_UPDATES – Ignore background updates
- LOGGER_ID – Log Group ID
- AUTO_LEAVE – Leave all chats for all userbot clients.
- PROXY_URL – Optional; Proxy URL for yt-dlp
- DEFAULT_SERVICE – Default search platform (Options:
youtube,spotify,jiosaavn) - DOWNLOADS_DIR – Directory for downloads and TDLib database
- COOKIES_URL – URLs for downloading cookies (More info here)
- Add @FallenBeatzBot to a group and grant admin permissions.
- Use
/startto initialize the bot. - Use
/helpto view the list of available commands.
Contributions are welcome! If you'd like to contribute:
- Fork the repository.
- Make meaningful changes – improve features, fix bugs, or optimize performance.
- Submit a pull request with a clear explanation of your changes.
🔹 Avoid submitting minor PRs for small typos or README tweaks unless they significantly improve clarity.
This project is licensed under the AGPL-3.0 License. See the LICENSE file for details.
- AshokShau - Creator & Maintainer
- Thanks to all contributors & bug hunters for improving the project!
- Special thanks to PyTgCalls for their outstanding work.
Love TgMusicBot? Help keep it running!
💰 Donate via Crypto, PayPal, or UPI – Contact me on Telegram for details.
Every contribution helps! ❤️
Follow me on GitHub for updates.
Star the repository on GitHub to support the project.
📢 Join our Telegram community:
