KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #codex #typescript #developer-tools #ai-agents #deepseek-harness #claude-code #ai-agent #cli #react #mcp

MusicPlayer

★ 112 Open GitHub ↗

Telegram Bot to play music in VoiceChat with Channel Support and autostarts Radio.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# MusicPlayer

- An Telegram Bot to Play Radio/Music in Channel or Group Voice Chats.
- A Telegram Bot to Play Audio in Voice Chats With Youtube and Deezer support.
- Supports Live streaming from YouTube.

---

## NOTE:

- Make sure you have started a VoiceChat in your Group before deploying.

---

## Features

<details>
 <summary>Show the Features</summary>

- Playlist, queue
- Change VoiceChat title to current playing song name.
- Supports Live streaming from youtube
- Supports both deezer and youtube to search songs.
- Play from telegram file supported.
- Starts Radio after if no songs in playlist.
- Automatically downloads audio for the first two tracks in the playlist to ensure smooth playing
- Automatic restart even if heroku restarts.

</details>

---

## Variables
<details>
 <summary>See Variables</summary>

### Pre Requisites 
- `API_ID` : Get from [my.telegram.org](https://my.telegram.org/app) or [@UsetTGzKBot](https://telegram.dog/UseTGzKBot)
- `API_HASH` : Get from [my.telegram.org](https://my.telegram.org/app) or [@UseTGzKBot](https://telegram.dog/UseTGzKBot)
- `BOT_TOKEN` : Get From [@Botfather](https://telegram.dog/BotFather)
- `SESSION_STRING` : Generate From here [![GenerateStringName](https://img.shields.io/badge/repl.it-generateStringName-yellowgreen)](https://replit.com/@ZauteKm/GenerateStringSession)
- `CHAT` : ID of Channel/Group where the bot plays Music.
- `LOG_GROUP` : Group to send Playlist, if CHAT is a Group
- `ADMINS` : ID of users who can use admin commands.
- `ARQ_API` : Get it for free from [@ARQRobot](https://telegram.dog/ARQRobot), This is required for /dplay to work.
- `STREAM_URL` : Stream URL of radio station or a youtube live video to stream when the bot starts or with /radio command. Some Streaming Links [Click here.](https://t.me/c/1481808444/143)
- `MAXIMUM_DURATION` : Maximum duration of song to play.(Optional)
- `REPLY_MESSAGE` : A reply to those who message the USER account in PM. Leave it blank if you do not need this feature. 
- `ADMIN_ONLY` : Pass `Y` If you want to make /play and /dplay commands only for admins of `CHAT`. By default `N` /play and /dplay is available for all.

</details>

---

## Deploy Now

<details><summary>Deploy to Heroku</summary>

 
<a href="https://heroku.com/deploy?template=https://github.com/ZauteKm/MusicPlayer">
 <img src="https://www.herokucdn.com/deploy/button.svg" alt="Deploy">

<details>
 <summary>Deploy on Qovery</summary>

</details>

<details>
 <summary>Deploy in your VPS</summary>

```sh
git clone https://github.com/ZauteKm/MusicPlayer
cd MusicPlayer
pip3 install -r requirements.txt
# <Create Variables appropriately>
python3 main.py
```

</details>

---

## Commands
<details><summary>How to Use..!</summary>

- Enable the worker after deploy the project to Heroku.

- Bot will starts radio automatically in given `CHAT` with given `STREAM_URL` after deploy.(24*7 Music even if heroku restarts, radio stream restarts automatically).

- To play a song use /play as a reply to audio file or a youtube link.

- Use /play <song name> to play song from youtube and /dplay <song name> to play from Deezer.

- Use /help to know about other commands.
</a>

</details>

---

#### Support
Join Now Telegram [VC Music Live Sets](https://t.me/c/1481808444/131)

## Requirements

- Python 3.6 or higher.
- A
  [Telegram API key](https://docs.pyrogram.org/intro/quickstart#enjoy-the-api)
  and a Telegram account.
- [FFmpeg Python](https://www.ffmpeg.org/)
- Telegram [String Session](https://replit.com/@ZauteKm/GenerateStringSession) of the account.
- Userbot Needs To Be Admin In The Channel or Group.
- Must Start A Voice Chat In Channel/Group Before Running The Bot.

## License
```sh
#!/usr/bin/env python3
# Copyright (C) @ZauteKm
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU Affero General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.

# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU Affero General Public License for more details.

# You should have received a copy of the GNU Affero General Public License
# along with this program. If not, see <https://www.gnu.org/licenses/>.
```

---

## Credits

- [Zaute Km](https://github.com/ZauteKm) [Dev]
- [Dash Eclipse](https://github.com/dashezup) [For tgvc_userbot]
- [Marshal X](https://github.com/MarshalX) [For pytgcalls]

MusicPlayer

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README