# Getting Started A guide on how to use ChillBot. The biggest Lofi bot on discord! ## About ChillBot ChillBot is a music bot that streams lofi music to your server. The bot delivers the best lofi beats for you to study, sleep, chill or relax to. ChillBot strives to deliver **high quality audio.** One of the easiest bots to use without any configuration. ## ChillBot Premium The premium version of the bot has some amazing features including **24/7** continuous playback, **multiple streams** support, **DJ role** configuration, server wide **Volume Control** and much more. You can get more information about our premium and how to subscribe via patreon. ## Permissions When you invite the bot, make sure the bot has the correct permissions as listed below. All these permissions are automatically given when you invite the bot. But if you have any specific channel permissions, ensure the ChillBot role has a Green Check ✅for the following perms\ \ **In the Text Channels:** * View Channel * Read message history * Send Messages * Embed Link * Use External Emojis * Attach files * Add reactions **In The voice Channels:** * Connect * Speak * Mute members * Deafen members * Move members If you'd like the bot to only respond in or join specific channels see the advanced permissions page for a guide on that. {% content-ref url="/pages/-MgCrTWeOBHaVsQK2sUk" %} [Advanced Permissions](/advanced-permissions) {% endcontent-ref %} # Commands The following examples in the code block are shown with the default prefix of chillbot which is `/` ![](/files/qrd5yOeKJ7zNTc86F5Ai) ## Music Commands ### Play First join a VC then use the `play` command. ChillBot will join the VC and start playing lofi music ``` /play ``` ### Stop To make the bot stop playing music and leave the VC use the `stop` command ``` /stop ``` {% hint style="info" %} **`stop`** requires manage messages permission or DJ Role (see premium bot for DJ role) {% endhint %} ### Now Playing We've recently added a `nowplaying` command which gives you information of the currently playing song! In order to use this command you need to vote for the bot. You can Vote for the bot here ; You can bypass this by making your guild premium ``` /now-playing ``` ## Utility ### Help The help command gives useful information about the bot such as the full list of commands, our affiliations as well as links to vote for the bot and join our support server. ``` /help ``` The help command can also be used to give more information about another command. In the example below we will get more information on the prefix command. ``` /help play ``` ### Vote Voting for the bot helps us out a lot and we really appreciate it! When you vote for the bot you gain access to the`nowplaying`command for 12 hours. You can vote for the bot again to gain access to it. To show our gratitude you can also get 1 month of premium by having 100 votes! The vote command gives the voting link to ChillBot's TOP.gg page ``` /vote ``` ### Ping The ping command is useful as it gives you latency information about the bot. ``` /ping ``` ### Support Simply gives you link to join our support server ``` /support ``` ### Invite Gives the link link to add the bot to your server ``` /invite ``` ### Statistics Gives various stats about the bot ``` /stats ``` ### Credits You can see all the contributors to chillbot by using the credits command ``` /credits ``` ### \ Music`nowplaying`, `play`, `stop` Premium`premium` Utility`credits`, `help`, `invite`, `ping`, `prefix`, `stats`, `support`, `vote` # Premium Commands By subscribing to a premium chillbot subscription, you will unlock access to 2 additional bots with higher quality and stability than the normal bot! All bots use the prefix /. > ChillBot Premium has the same commands from the free version of ChillBot and more which are shown below ChillBot Premium 1 Invite link [here](https://discord.com/oauth2/authorize?client_id=836913540832034826\&permissions=49630272\&scope=bot%20applications.commands). ChillBot Premium 2 Invite link [here](https://discord.com/oauth2/authorize?client_id=794627202775777303\&permissions=49630272\&scope=bot%20applications.commands). {% hint style="info" %} Parameters in between **< >** are mandatory. Parameters on either side of the " **| "** means you choose either **one.** {% endhint %} ## DJ Role DJ role allows members without `manage messages` permission to stop the bot from playing music. To add a DJ role, first create a role then use the `djrole add` command followed by a role. You can either mention the role OR use the role ID. You can only have 1 DJ role You can check if there is already a djrole with `djrole info` command. ``` /djrole info ``` ``` /djrole add <@ROLE_HERE|ROLE_ID_HERE|ROLE_NAME> ``` You can remove a DJ role by using the `djrole remove`command ``` /djrole remove ``` ## Volume You can set the default volume of chillbot using the Volume command. You can set the volume level from **1-100** {% hint style="info" %} This is different from users manually changing the volume by clicking on the bot. {% endhint %} ``` /volume 75 ``` ## Streams ChillBot Premium has multiple streams that you can use from. To get a list of streams use the `station` command. This also gives you links to the streams we use. ``` /station ``` ![](/files/44VwmZduX3ghaulYlQUD) ## Premium Guild To activate chillbot premium ``` /premium config add ``` To remove a premium server ``` /premium config remove (ID) ``` You can remove a guild by ID if you are not anymore on the server. To get an overview of all your premium servers and how many can still be upgraded just do : ``` /premium config list ``` You can see an example here : ![the numbers next to the server names are the id if you want to retrieve them to remove a server via the id](/files/1LNbxQlc6N7KEdolSD8F) # Advanced Permissions ## Restricting ChillBot You're able to restrict ChillBot to accept commands in certain text channels and also only join certain voice channels.
If you would like ChillBot to NOT join a certain Voice Channel or read commands from certain Text Channels. Deny ❌"View Channel" for the ChillBot role. If a bot can not view a channel it can not interact with it. ![](/files/-MglgBW2uZuu8lSrXkLG) {% hint style="info" %} If the bot has any role that gives it ✅Green Tick in **Channel Permissions** to View Channel, the bot will not be restricted as it overrides ✅> ❌. For more info read discord article about [permissions](https://support.discord.com/hc/en-us/articles/206029707-Setting-Up-Permissions-FAQ) {% endhint %}