/VoiceChatPyroBot

Pyrogram bot to automate streaming music in voice chats

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

Pyrogram bot to automate streaming music in voice chats

Read this before scrolling down

  • You can't run this on Android using Termux.
  • You can't run this on iOS using iSH.
  • You can't run this on Windows server (aka RDP).
  • You can't run this on Shadow.
  • You can't run this on Heroku.

Help

If you face an error, want to discuss this project or get support for it, join it's group on Telegram.

Requirements

  • A computer (Debian-based Linux VPS recommmended).
  • An alt Telegram account.
  • Bot token from @BotFather.
  • API ID & hash from my.telegram.org.
  • Python3 & pip3.
  • Mplayer
  • A software to forward audio to tdesktop

Deploying

The code

Cloning

    git clone https://github.com/rojserbest/VoiceChatPyroBot.git tgvcbot && cd tgvcbot

Configuring

Copy sample_config.py to config.py and make it use your credentials:

API_ID int: your api id from my.telegram.org

API_HASH str: your api hash from my.telegram.org

TOKEN str: your bot token from @BotFather

SUDO_USERS list(int): a list of user ids which can pause, skip and change volume

LOG_GROUP int: (optional) a group chat id to send "now playing" messages to in a non-spammy way

LANG str: your bot language, choose an available language code in strings/

DUR_LIMIT int: max video duration in minutes for downloads

PIP requirements

    pip(3) install -U -r requirements.txt

Running

⚠️ Warning for Linux users: don't run any command as root (except those which require it), else you'll face bulky pulseaudio problems. You can create a user with adduser.

ℹ️ The volume command isn't working on Windows.

On Linux VPS

These are apt package manager instructions but you can install the required packages with other package managers too.

  1. Update and upgrade apt:
    sudo apt update && sudo apt upgrade
  1. Install requirements:
    sudo apt install xrdp pulseaudio mplayer screen
  1. Download tdesktop:
    cd ~ && wget https://telegram.org/dl/desktop/linux -O tdesktop.tar.xz && tar -xf tdesktop.tar.xz && rm tdesktop.tar.xz
  1. Configure XRDP session to only start Telegram:
    echo "~/Telegram/Telegram" >~/.xsession
  1. Go back to directory of the clone and load a pulseaudio null sink, by running:
    bash pa.sh
  1. Make a screen for the bot and attach to it:
    screen -S vcbot
  1. Run the bot:
   python(3) bot.py

  1. Detattach from the screen by pressing CTRL+A then CTRL+D.

  2. Open a remote desktop client and login to your user.

  3. You should see the Telegram GUI, just login, join a voice chat and set MySink.monitor as your microphone.

  4. Done, you can now start sending commands to your bot and it'll stream in the voice chat.

On Linux desktop

These are apt package manager instructions but you can install the required packages with other package managers too.

  1. Update and upgrade apt:
    sudo apt update && sudo apt upgrade
  1. Install requirements:
    sudo apt install pulseaudio mplayer pavucontrol screen

  1. If you have Telegram skip this step, otherwise download it here.

  2. Go to directory of the clone and load a pulseaudio null sink, by running:

    bash pa.sh
  1. Make a screen for the bot and attach to it:
    screen -S vcbot
  1. Run the bot:
   python(3) bot.py

  1. Detattach from the screen by pressing CTRL+A then CTRL+D.

  2. Open Telegram, join a voice chat and set MySink.monitor as your microphone.

  3. Done, you can now start sending commands to your bot and it'll stream in the voice chat.

On Windows 10 PC

  1. Download Voicemeeter here and install it.

  2. Download virtual audio cable here and install it.

  3. Reboot.

  4. Right click the speaker account in your taskbar, then click playback.

  5. Set Voicemeeter input and Voicemeeter output as default and click OK.

  6. Download mplayer here, extract it and add it to path.

  7. Start Voicemeeter engine.

  8. Run the bot:

   python bot.py

  1. Open Telegram, join a voice chat and set Voicemeeter input as your microphone.

  2. Done, you can now start sending commands to your bot and it'll stream in the voice chat.

Usage

Streaming YouTube videos

  1. Open YouTube in your browser, and search for a song.
  2. Copy the complete video URL to clipboard and send it to your bot in private.

Method 2

  1. Enable inline for you bot in @BotFather.
  2. In your bot's private, type @usernameOfYourBot followed by your YouTube search query, and click a result.

Bot Commands

Inorder to command the bot send the below mentioned command with / prefix

  • start - start the bot

  • song - check the playing song

  • volume - check the current volume

  • queue - check songs in the queue

  • pause - pause the playing song (Sudo Users)

  • resume - resume the paused song (Sudo Users)

  • play - same as resume (Sudo Users)

  • ban - ban a user (Sudo Users)

  • unban - unban a user (Sudo Users)

  • bans - see banned users (Sudo Users)

  • skip - skip the playing song (Sudo Users)

  • stream - stream a radio (Sudo Users)

  • cleardownloads - delete all downloads (Sudo Users)

TODOS

  1. Migrate to proper Database like SQLite for storing media queue and user requests.
  2. Keep track of previous and completed media requests.
  3. Add the features requested by users.

Authors & Acknowledgment

Inspiration

Development & contribution