TgMusicBot - Telegram Music Bot

Telegram Group Calls Streaming bot with some useful features, written in Python with Py-Tgcalls. Supporting platforms like YouTube, Spotify, AppleMusic, Soundcloud, JioSaavn and more.

@FallenBeatzBot - Try it now!

---

🚫 Tired of IP Bans from YouTube?

Say goodbye to restrictions with our Premium Music API – your ultimate solution for seamless, high-quality downloads.

• Easy Integration – Just set API_URL in 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!

---

Want to use cookies?

📘 Check out this guide for instructions on downloading and using them.

---

Features

• 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.

---

Installation

📌 Using Docker (Recommended) (Click to expand)

Check here for installation instructions.

1. Clone the repository:

   git clone https://github.com/AshokShau/TgMusicBot.git && cd TgMusicBot

2. Build the Docker image:

   docker build -t tgmusicbot .

3. Set up environment variables:

   cp sample.env .env && vi .env

4. 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 -y

2. Install required packages:

   sudo apt-get install git python3-pip ffmpeg aria2 -y

3. Clone the repository:

   git clone https://github.com/AshokShau/TgMusicBot.git && cd TgMusicBot

4. Create a virtual environment:

   python3 -m venv venv

5. Activate the virtual environment:

   • Windows: venv/Scripts/activate
   • Linux/Mac: source venv/bin/activate

6. Install dependencies:

   pip install -r requirements.txt

7. Set up environment variables:

   cp sample.env .env && vi .env

   Press Ctrl+C when you're done with editing env and :wq to save the environment variables.

8. Install tmux to keep running your bot when you close the terminal by:

   sudo apt install tmux && tmux

9. Finally run the bot by:

   bash start

   For getting out from tmux session : Press Ctrl+b and then d.

Deploy on Heroku (Click to expand)

---

Configuration

📌 Environment Variables (Click to expand)

🔑 Required Variables

• API_ID – Get from my.telegram.org
• API_HASH – Get from my.telegram.org
• TOKEN – Get from @BotFather

🔗 String Sessions

• STRING - Pyrogram String Session, STRING2 ... STRING10

Get from @StringFatherBot

🛠️ Additional Configuration

• 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

🎵 Music Download Options

• 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

• COOKIES_URL – URLs for downloading cookies (More info here)

---

🎮 Usage

1. Add @FallenBeatzBot to a group and grant admin permissions.
2. Use /start to initialize the bot.
3. Use /help to view the list of available commands.

---

Contributing

Contributions are welcome! If you'd like to contribute:

1. Fork the repository.
2. Make meaningful changes – improve features, fix bugs, or optimize performance.
3. 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.

---

License

This project is licensed under the AGPL-3.0 License. See the LICENSE file for details.

---

Credits

• AshokShau - Creator & Maintainer
• Thanks to all contributors & bug hunters for improving the project!
• Special thanks to PyTgCalls for their outstanding work.

---

💖 Support the Project

Love TgMusicBot? Help keep it running!

💰 Donate via Crypto, PayPal, or UPI – Contact me on Telegram for details.

Every contribution helps! ❤️

---

🔗 Links

Follow me on GitHub for updates.
Star the repository on GitHub to support the project.

📢 Join our Telegram community:

---