Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/TheHamkerCat/Telegram_VC_Bot
Telegram Voice Chat Bot Written In Python Using Pytgcalls & Pyrogram.
https://github.com/TheHamkerCat/Telegram_VC_Bot
bot heroku heroku-telegram jiosaavn music pyrogram pyrogram-bot pytgcalls python song telegram telegram-bot telegram-musicbot telegram-vcbot tgcalls tgvcbot theme youtube
Last synced: 3 months ago
JSON representation
Telegram Voice Chat Bot Written In Python Using Pytgcalls & Pyrogram.
- Host: GitHub
- URL: https://github.com/TheHamkerCat/Telegram_VC_Bot
- Owner: TheHamkerCat
- License: mit
- Created: 2021-01-03T11:14:43.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2022-12-04T15:07:14.000Z (almost 2 years ago)
- Last Synced: 2024-05-11T06:37:06.663Z (6 months ago)
- Topics: bot, heroku, heroku-telegram, jiosaavn, music, pyrogram, pyrogram-bot, pytgcalls, python, song, telegram, telegram-bot, telegram-musicbot, telegram-vcbot, tgcalls, tgvcbot, theme, youtube
- Language: Python
- Homepage: https://t.me/tgvcsupport
- Size: 5.48 MB
- Stars: 352
- Watchers: 13
- Forks: 745
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome - TheHamkerCat/Telegram_VC_Bot - Telegram Voice Chat Bot Written In Python Using Pytgcalls & Pyrogram. (Python)
README
# Telegram Voice-Chat Bot [PyTGCalls] [](https://github.com/tgcalls/awesome-tgcalls)
Telegram Voice-Chat Bot To Play Music With Pytgcalls From Various Sources In Your Group.
## Requirements
### Account requirements
- A Telegram account to use as the music bot, **You cannot use regular bot accounts, as they cannot join voice chats. *It must be a user account.***
- API_ID and API_HASH for that account.
- The account must be an admin of the chat, with _Manage Voice Chats_ and _Delete Messages_ permissions.
### Environment requirements
- Linux-based OS. **You cannot run this on Windows natively, Use WSL**
- Python 3.9 or later.
- ffmpeg package, look below for instructions.
## Run (Assuming you have a debian-based distro)
```sh
$ git clone https://github.com/thehamkercat/Telegram_VC_Bot
$ cd Telegram_VC_Bot
$ sudo apt-get install ffmpeg
$ pip3 install -U pip
$ pip3 install -U -r requirements.txt
$ cp sample_config.py config.py
```
Edit **config.py** with your own values.
```sh
$ python3 main.py
```
## Heroku
Read this -> https://t.me/TGVCSupport/17542
#### Generate String session [IMPORTANT]
Download this file [generate_string_session.py](https://raw.githubusercontent.com/thehamkercat/Telegram_VC_Bot/master/generate_string_session.py)
```sh
$ pip3 install pyrogram TgCrypto
$ python3 generate_string_session.py
```
Fork this repository and change name of `sample_config.py` to `config.py`
Then you will need get a session string, copy it, then press heroku deploy button.
[](https://heroku.com/deploy?template=https://github.com/thehamkercat/Telegram_VC_Bot/tree/master)
Send [commands](https://github.com/thehamkercat/Telegram_VC_Bot/blob/master/README.md#commands) to bot to
play music.
## Docker
```sh
$ git clone https://github.com/thehamkercat/Telegram_VC_Bot && cd Telegram_VC_Bot
$ cp sample.env .env
```
Edit **.env** with your own values.
```sh
$ sudo docker build . -t tgvc-bot
$ sudo docker run tgvc-bot
```
To stop use `CTRL+C`
## Commands
Command | Description
:--- | :---
/help | Show Help Message.
/skip | Skip Any Playing Music.
/play [SONG_NAME] | To Play A Song Using Saavn.
Service used can be changed in config (`DEFAULT_SERVICE`).
/play youtube/saavn [SONG_NAME] | To Play A Song Using Specific Service.
/play [with reply to an audio file] | To Play A Song With TG Audio File.
/queue | Check Queue Status.
/delqueue | Deletes Queue List and Playlist.
/playlist [songs name separated by line] | Start Playing Playlist.
/joinvc | Join Voice Chat.
/leavevc | Leave Voice Chat.
/volume [1-200] | Adjust Volume.
/pause | Pause Music.
/resume | Resume Music.
## Note
1. If you want any help you can ask [here](https://t.me/tgvcsupport)
## Credits
1. [@MarshalX](https://github.com/MarshalX), For [TGCalls](https://github.com/MarshalX/tgcalls)
2. Thanks to everyone who contributed to the project.