# Description
---------------------------------------------------------------------
The Bot joins specified channels at random intervals between 10 minutes and 2 hours, plays one of the specified songs and then leaves
---------------------------------------------------------------------
## Help

For help type `$coco help` or read these release notes

## Channels
If no channels are configured the Bot will randomly join one of the servers voice channels.

If only one is configured it will join that one.

If more are configured it will randomly join one of the defined ones.

### Commands
|Command                |Argument        |Function                                                 |Rights|
|-----------------------|----------------|---------------------------------------------------------|------|
|`$coco add_channel`    |The channel name|Adds the channel with the given name to the joinable list|Admin |
|`$coco list_channels`  |Nothing         |Lists all the saved channels and their IDs               |All   |
|`$coco remove_channel` |The channels id |Removes the channel with the given ID                    |Admin |
|`$coco set_bot_channel`|Nothing         |Sets a channel for the bot to watch*                     |Admin |

\* That means the bot will only send and read messages in that channel

## Songs
If no songs are configured it will play the [coconut song](https://www.youtube.com/watch?v=w0AOGeqOnFY)

If one song is configured it will play that

If more are configured it will play one of them at random

### Commands
|Command            |Argument                      |Function                                               |Rights|
|-------------------|------------------------------|-------------------------------------------------------|------|
|`$coco add_song`   |The songs Youtube link or name|Adds the song with the given name/link to the song list|Admin |
|`$coco list_songs` |Nothing                       |Lists all the saved songs and their IDs                |All   |
|`$coco remove_song`|The songs id                  |Removes the song with the given ID                     |Admin |

## Intervals
The bot defaults to random intervals between 10 and 120 minutes but you can change that with commands

Please note that any changes only apply after the next time the bot joins your channel

### Commands
|Command                 |Argument                            |Function                                           |Rights|
|------------------------|------------------------------------|---------------------------------------------------|------|
|`$coco set_min_interval`|The minimum interval time in minutes|Sets the minimum interval time to the given time   |Admin |
|`$coco set_max_interval`|The maximum interval time in minutes|Sets the maximum interval time to the given time   |Admin |
|`$coco show_intervals  `|Nothing                             |Shows the current minimum and maximum interval time|All   |

This bot was purely a fun project and I dont expecct any money in exchange. Nevertheless, if you want to support me and help me pay the bills of the server its hosted on, consider buying me a coffe https://www.buymeacoffee.com/Overloader

CocoBot

A bot that joins a servers voice channel at random intervals to play a song, then leave. Mostly meant as a joke

Voting for CocoBot

Do you want to support us?