https://github.com/AsmSafone/MusicPlayer
A Telegram Music Bot written in Python using Pyrogram and Py-Tgcalls. This is Also The Source Code of The UserBot Which is Playing Music in @S1-BOTS Support Group ❤️
https://github.com/AsmSafone/MusicPlayer
hacktoberfest hacktoberfest-accepted music music-player musicbot musicplayer player playlist soundcloud spotify stream-music telegram telegram-bot vcplayer videostream youtube
Last synced: 3 months ago
JSON representation
A Telegram Music Bot written in Python using Pyrogram and Py-Tgcalls. This is Also The Source Code of The UserBot Which is Playing Music in @S1-BOTS Support Group ❤️
- Host: GitHub
- URL: https://github.com/AsmSafone/MusicPlayer
- Owner: AsmSafone
- License: agpl-3.0
- Created: 2021-12-23T11:00:14.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2024-12-06T10:58:52.000Z (10 months ago)
- Last Synced: 2025-05-21T18:05:46.036Z (5 months ago)
- Topics: hacktoberfest, hacktoberfest-accepted, music, music-player, musicbot, musicplayer, player, playlist, soundcloud, spotify, stream-music, telegram, telegram-bot, vcplayer, videostream, youtube
- Language: Python
- Homepage:
- Size: 1.78 MB
- Stars: 327
- Watchers: 6
- Forks: 1,165
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
⭐️ Music Player ⭐️
A Telegram Music Bot written in Python using Pyrogram and Py-Tgcalls
### ⚡️ 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](#languages),
thanks to the translators.
[](https://deploy.safone.dev)
Note: `First Fork The Repo Then Click On Deploy To Heroku Button!`
- Legecy Method
```bash
$ git clone https://github.com/AsmSafone/MusicPlayer
$ cd MusicPlayer
$ sudo apt install git curl python3-pip ffmpeg -y
$ pip3 install -U pip
$ pip3 install -U -r requirements.txt
$ cp sample.env .env
# < edit .env with your own values >
$ python3 main.py
```
Or you can use this One-Liner to save your time :
```
git clone https://github.com/AsmSafone/MusicPlayer && cd MusicPlayer && sudo apt install git curl python3-pip ffmpeg -y && pip3 install -U pip && pip3 install -U -r requirements.txt
```
Make sure to edit the .env file accordingly,
```
cp sample.env .env
```
Run it using,
```
python3 main.py
```
- Docker Build Method
```bash
$ git clone https://github.com/AsmSafone/MusicPlayer
$ 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 from https://my.telegram.org/apps.
- `API_HASH`: Telegram app hash from https://my.telegram.org/apps.
- `SESSION`: Pyrogram string session. You can generate from [here](https://replit.com/@AsmSafone/genStr).
- `SUDOERS`: ID of sudo users (separate multiple ids with space).
- `BOT_TOKEN`: Telegram bot token from https://t.me/botfather. (optional)
- `QUALITY`: Custom stream quality (high/medium/low) for the userbot in vc. Default: `high`
- `PREFIX`: Bot commad prefixes (separate multiple prefix with space). Eg: `! /`
- `LANGUAGE`: An [available](#languages) bot language (can change it anytime). Default: `en`
- `STREAM_MODE`: An stream mode like audio or video (can change it anytime). Default: `audio`
- `ADMINS_ONLY`: Put `True` if you want to make /play commands only for admins. Default: `False`
- `SPOTIFY_CLIENT_ID`: Spotify client id get it from [here](https://developer.spotify.com/dashboard/applications). (optional)
- `SPOTIFY_CLIENT_SECRET`: Spotify client secret get it from [here](https://developer.spotify.com/dashboard/applications). (optional)
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 [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
• !update / !restart | Update and restart your music player
```text
ar Arabic
bn Bengali
cn Chinese
de German
en English
fr French
hi Hindi
ja Japanese
nl Dutch
ru Russian
te Telegu
tr Turkish
```
New languages, bug fixes and improvements following
[our contribution guidelines](./CONTRIBUTING.md) are warmly welcomed!
For any kind of help join [our support group](https://t.me/AsmSupport) or raise an [issue](https://github.com/AsmSafone/MusicPlayer/issues).
- [Me](https://github.com/AsmSafone) for [Noting](https://github.com/AsmSafone/MusicPlayer) 😬
- [Dan](https://github.com/delivrance) for [Pyrogram](https://github.com/pyrogram/pyrogram) ❤️
- [Laky-64](https://github.com/Laky-64) for [Py-TgCalls](https://github.com/pytgcalls/pytgcalls) ❤️
- And Thanks To All [Contributors](https://github.com/AsmSafone/MusicPlayer/graphs/contributors)! ❤️
Music Player is licenced under the GNU Affero General Public License v3.0.
Read more [here](./LICENSE).