Ud

Another YouTube music bot (I know, how original ;)

Name

Why is it called 'Ud' though?
It's one of the names for the string instrument thingy

---

Where?

Ud is currently running on a Raspberry Pi in Brazil.
If it kind of stutters at times or doesn't play something, that's either because of the internet speed around these parts or the poor CPU trying to do its job.

It crashed!

Yeah, that happens sometimes, my bad.
Don't worry, it usually doesn't take long to reset.

---

Ud is still in an experimental phase, but it can sort of:

• play YouTube videos (audio) by:
  • using a direct link
  • searching for a user input (query) between quotes (' or ") on YouTube
• play YouTube livestreams (audio)
• loop content indefinitely or a set amount of times
• set its global volume by user demand (0 ~ 200)
• keep track of who asked for each content to play
  • also keep track of how many times it will loop each content

---

What it definitely cannot do:

• use Spotify
• play a YouTube playlist
• play video (image)
• play from mp3 files

---

Known bugs:

• some videos seem to trigger 'finish' way before they should
• some videos trigger a connection error due to them not being reached on the first try. The solution seems to be to just retry a connection, but that is still not reliable.

---

Commands & Instructions

All commands need to be preceeded by an '!' (exclamation mark). These are the commands that Ud can currently understand:

• help: displays the help text message containing the commands
• play [Youtube Link] / [search query]: plays content from a YouTube stream (live or archived). 'Stream' here means any kind of video midia from the website. 'play' must always be followed by a space character and can be used in two ways:
  • !play https://www.youtube.com/...: plays stream via direct link.
  • !play 'darude sandstorm' OR !play "darude sandstorm": uses Google's YouTube Data API to search the words given and returns the top result.
• queue: displays stream queue on chat containing the stream number, who requested it, its time duration, and the title
• skip: skips current stream being played and plays the next one in the queue. Equivalent to !remove 0.
• remove [number]: removes stream from queue based on its queue index/number.
  • !remove6 OR !remove 6: removes stream number 6 (the seventh one) from the queue. All other streams with greater numbers get shifted down (index-wise).
• flush: clears the queue except for the stream currently playing (number 0)
• loop [number] [repetitions]: marks stream, based on its number, to repeat a given amount of times. Can be used in three ways:
  • !loop: marks current stream playing (number 0) to repeat indefinitely.
  • !loop2 OR !loop 2: marks stream number 2 (the third one) to repeat indefinitely
  • !loop2 70 OR !loop 2 70: marks stream number 2 to repeat 70 more times (making it play 71 times in total)
• stop: ends the stream, exits the channel and clears the queue.
• vup: globally increases volume by 20% (x1.2).
• vUP OR VUP: globally increases volume by 50% (x1.5).
• vdown: globally decreases volume by 20% (x0.8).
• vDOWN OR VDOWN: globally decreases volume by 50% (x0.5).
• vol [value]: sets global volume to value. Ranges from 0 (mute) to 200 (arbitrary maximum).
  • !vol80 OR !vol 80: sets global volume to 80.
• volume [value]: same as vol
• vreset: resets global volume to its default value of 25.