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

#### **Name**
Why is it called 'Ud' though?  
It's one of the [names](https://en.wiktionary.org/wiki/%27ud#English) for the [string instrument thingy](https://image.shutterstock.com/image-photo/ud-260nw-622546694.jpg)  
  
<hr style="border:2px solid gray"> </hr>

#### **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.

<hr style="border:2px solid gray"> </hr>

#### **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  


<hr style="border:2px solid gray"> </hr>

#### **What it definitely cannot do**:
- use Spotify
- play a YouTube playlist
- play video (image)
- play from mp3 files  


<hr style="border:2px solid gray"> </hr>

#### **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.  

<hr style="border:2px solid gray"> </hr>


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

Ud tries to play audio from YouTube videos/streams. Type "!help" for the commands.

Voter pour Ud

Tu veux nous soutenir ?