Music Player

by Veronica0706


⭐️ Music Player ⭐️

A Telegram Music Bot written in Python using Pyrogram and Py-Tgcalls

LICENSE Contributors Repository Size
Forks Stars Watchers Commit Activity Issues


⚡️ Fast & Light

Starts streaming your inputs while downloading and converting them. Also, it doesn't make produce files.

👮🏻‍♀️ Safe and handy

Restricts control and sensitive commands to admins.

🗑 Clean and spam free

Deletes old playing trash to keep your chats clean.

😎 Has cool controls

Lets you switch stream mode, loop, pause, resume, mute, unmute anytime.

🖼 Has cool thumbnails

Response your commands with cool thumbnails on the chat.

😉 Streams whatever you like

You can stream audio or video files, YouTube videos with any duration, YouTube lives, YouTube playlists and even custom live streams like radios or m3u8 links or files in the place it is hosted!

📊 Streams in multiple places

Allows you to stream different things in multiple chats simultaneously. Each chat will have its own song queue.

🗣 Speaks different languages

Music Player is multilingual and speaks various languages, thanks to the translators.

🚀 Deploy

Deploy on Heroku

Note: First Fork The Repo Then Click On Deploy To Heroku Button!

☁️ Self Host

  • Legecy Method
$ git clone
$ cd MusicPlayer
$ sudo apt install git curl python3-pip ffmpeg -y
$ pip3 install -U pip
$ curl -sL | sudo -E bash -
$ sudo apt install -y nodejs
$ sudo apt install build-essential
$ sudo npm install pm2@latest -g
$ pip3 install -U -r requirements.txt
$ cp sample.env .env
# < edit .env with your own values >
$ python3
  • Docker Build Method
$ git clone
$ cd MusicPlayer
$ cp sample.env .env
# < edit .env with your own values >
$ sudo docker build . -t musicplayer
$ sudo docker run musicplayer


  • API_ID: Telegram app id.
  • API_HASH: Telegram app hash.
  • SESSION: Pyrogram string session. You can generate from here.
  • SUDOERS: ID of sudo users (separate multiple ids with space).
  • QUALITY: Custom stream quality for the userbot in vc. Default: high
  • PREFIX: Commad prefixes (separate multiple prefix with space). Eg: ! /
  • LANGUAGE: An available bot language (can change it anytime). Default: en

📄 Commands

Command Description • !ping Check if alive or not • !start / !help Show the help for commands • !mode / !switch Switch the stream mode (audio/video) • !p / !play [song name or youtube link] Play a song in vc, if already playing add to queue • !radio / !stream [radio url or stream link] Play a live stream in vc, if already playing add to queue • !pl / !playlist [youtube playlist link] Play the whole youtube playlist at once • !skip / !next Skip to the next song • !m / !mute Mute the current stream • !um / !unmute Unmute the muted stream • !ps / !pause Pause the current stream • !rs / !resume Resume the paused stream • !list / !queue Show the songs in the queue • !mix / !shuffle Shuflle the queued playlist • !loop / !repeat Enable or disable the loop mode • !lang / language [language code] Set the bot language in group • !ip / !import Import queue from exported file • !ep / !export Export the queue for import in future • !stop / !leave Leave from vc and clear the queue

🗣 Languages

en    English

💜 Contribute

New languages, bug fixes and improvements following our contribution guidelines are warmly welcomed!

🛫 Supports

For any kind of help join our support group or raise an issue.


📃 License

Music Player is licenced under the GNU Affero General Public License v3.0. Read more here.