YTLM

YouTube Live Music (YTLM) is a bot that allows viewers of a live stream to use commands to queue music

Contents:

• Commands
  • !queue
• Setup
• Config Documentation
  • YOUTUBE_VIDEO_ID
  • RATE_LIMIT_SECONDS
  • TOAST_NOTIFICATIONS
  • PREFIX
  • QUEUE_COMMAND
  • banned_IDs.json
  • banned_users.json
• Notes

Commands

!queue

The default command to queue a song is "!queue <VIDEO_URL>" where <VIDEO_URL> is the Url for the youtube music video, however the command listener (exclamation mark) and command (the word queue) can be changed in the config if desired.

Important

THIS COMMAND ONLY WORKS WITH URLs OF VIDEOS THAT ARE ON YOUTUBE MUSIC; REGULAR VIDEOS WILL NOT DOWNLOAD

Setup

1. Download and extract the source to any folder on your computer (clone repo or download latest release)
2. Install Python. During installation, please make sure the box at the bottom labelled "add Python.exe to PATH" is ticked
3. Check whether pip was added to Path correctly by running pip install --upgrade pip; this will both make sure pip is correctly installed and that it is up-to-date
4. Install the required python libraries (found in Src/requirements.txt) using pip (normally included in Python)
5. Install VLC for your computer appropiately. MAKE SURE TO USE THE SAME ARCHITECTURE AS YOUR PYTHON INSTALL
6. Open the file config.json in your text editor of choice, I recommend VSCode or Notepad++
7. Change LIVESTREAM_ID to the ID of your live stream (Ie, the characters at the end of the URL, after the /live/)
8. Change the value for RATE_LIMIT_SECONDS. This is how long users have to wait before they can request another song (in seconds)
9. Run main.py in the src folder:
   For windows:
   • Press Win+r to open the run dialogue
   • Type "cmd" and hit enter to open command prompt
   • Using command prompt, navigate to where you downloaded the files (using cd <path to folder.)
   • Navigate to the src folder: cd YTLM-main/src
   • Type python main.py and hit enter

Config Documentation

YOUTUBE_VIDEO_ID

This is where you enter the ID to your youtube video.

RATE_LIMIT_SECONDS

How long a user has to wait before they can queue another song, in seconds.

TOAST_NOTIFICATIONS

Setting this to True (default) will enable toast notifications that pop up with the song name and requester, setting it to any other value will disable these notifications

PREFIX

This configuration option allows you to set any character as the listener prefix for commands. To do this, change the value in quotation marks to whatever you desire — it can even be multiple characters!

QUEUE_COMMAND

This configuration option allows you to set any string as the command for queueing a song. Simply change the value in the quotation marks to the desired command.

banned_IDs.json

this file is used to store all banned youtube video IDs, for the time being you will have to add them manually to the file, each video id should be in quotation marks and seperated by commas, for example:

["Video ID 1", "Video ID 2", "Video ID 3"]

banned_users.json

this file is used to store all banned youtube user handles, for the time being you will have to add them manually to the file, each handle should be in quotation marks and seperated by commas, for example:

["@Handle 1", "@Handle 2", "@Handle 3"]

Notes

• This program can be run on any PC with no API key or cookie required
• If used, please credit the repository in the description or somewhere in the video

Star history