• Stars
    star
    335
  • Rank 125,173 (Top 3 %)
  • Language
    Python
  • License
    MIT License
  • Created over 3 years ago
  • Updated almost 2 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Telegram Voice Chat Bot Written In Python Using Pytgcalls & Pyrogram.

Telegram Voice-Chat Bot [PyTGCalls] Mentioned in Awesome Telegram Calls

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)

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

$ python3 main.py

Heroku

Read this -> https://t.me/TGVCSupport/17542

Generate String session [IMPORTANT]

Download this file generate_string_session.py

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

Deploy

Send commands to bot to play music.

Docker

$ git clone https://github.com/thehamkercat/Telegram_VC_Bot && cd Telegram_VC_Bot
$ cp sample.env .env

Edit .env with your own values.

$ 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

Credits

  1. @MarshalX, For TGCalls
  2. Thanks to everyone who contributed to the project.