Pyrogram bot to automate streaming music in voice chats

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 (a Debian-based Linux recommmended).
An alt Telegram account.
Bot token from @BotFather.
API ID & hash from my.telegram.org.
Python 3.6 or newer & latest version of pip.
MPV (and libmpv).
A software to forward audio to tdesktop (Linux: pulseaudio, Windows: voicemeeter).

Deploying

The code

Cloning

    git clone https://github.com/rojserbest/vcpb.git vcpb && cd vcpb

Configuring

CLI args (when running bot.py)

Example:

python3 bot.py \
--api-id 1 \
--api-hash abcdef1234 \
--token 1234567890:ABCDEF \
--sudo-users 111111_22222_33333 \
--mongo-db-uri mongodb+srv://user:pass@subdomain.domain.extention/vcpb \
--group -1001876543112 \
--dur-limit 10 \
--lang en

Config file

Copy config/sample_config.py to config/config.py and make it use your credentials (you can also give those as an arg when running bot.py):

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

MONGO_DB_URI str: your MongoDB URI (you can get one for free in their official website, sign up, create a cluster and a database named "vcpb")

GROUP int: the id of the group where your bot plays (not required if both USERS_MUST_JOIN and LOG are false)

USERS_MUST_JOIN bool: if true, only users which are in the group can use the bot

LOG bool: if true, now playing messages will be sent to the group

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 might face bulky problems. You can create a user with adduser music and add it to sudoers using sudo usermod -aG sudo music.

ℹ️ 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.

Update and upgrade apt: sudo apt update && sudo apt upgrade -y
Install requirements: sudo apt install python3-pip xrdp pulseaudio mpv libmpv-dev screen -y
Download tdesktop: cd ~ && wget https://telegram.org/dl/desktop/linux -O tdesktop.tar.xz && tar -xf tdesktop.tar.xz && rm tdesktop.tar.xz
Configure XRDP session to only start Telegram: echo "~/Telegram/Telegram" >~/.xsession
Enable pulseaudio service (you can skip this step if you don't have systemctl): systemctl --user enable pulseaudio
Restart the machine: sudo reboot
Start pulseaudio (you can skip this step if you did step 5): pulseaudio --start
Go back to directory of the clone and load a pulseaudio null sink, by running: bash pa.sh
Make a screen for the bot and attach to it: screen -S vcbot
Run the bot: python(3) bot.py
Detattach from the screen by pressing CTRL+A then CTRL+D.
Open a remote desktop client and login to your user.
You should see the Telegram GUI, just login, join a voice chat and set VoiceChatPyroBot as your microphone.
Done, you can now start sending commands to your bot and it'll stream in the voice chat.

On Linux desktop