# Getting Started

Here's a quick getting started guide just to get you on your feet and explain how to get the best experience you can.

Before starting, note that the following guide should help you.

{% embed url="<https://youtu.be/CHTr-sy-hQM?t=86>" %}

### 1. Inviting the bot on your server

Click [here](https://green-bot.app/invite) to invite Green-bot on your server. You will be redirected to a discord page. First click accept and then Authorize.

By default, Green-bot is asking Administrator permissions. If you don't want to give Administrator permissions to Green-bot, you can find a link [here](https://discord.com/oauth2/authorize?client_id=783708073390112830\&scope=bot\&permissions=20016336) with basic permissions.

![](https://3725463460-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVR916scdNqhBW7aHuuTM%2Fuploads%2Fgit-blob-e4f5da55847b2c007b7153c7d517eec89c19df4a%2Fimage.png?alt=media)

### 2. Receiving instructions

0nce you've added Green-bot, It will send a message in the system channel of your server about how to get started

![](https://3725463460-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVR916scdNqhBW7aHuuTM%2Fuploads%2Fgit-blob-a4376fadabe1df8f3c31714fa897541f16c79572%2Fimage%20\(3\).png?alt=media\&token=4089618e-bc31-4a38-8be8-1f296c8217d8)

To learn how to use Green-bot, you can check to following sections:

{% content-ref url="/pages/p6AOalCis52MVmfTaMCY" %}
[How to use commands](/the-bot-prefix)
{% endcontent-ref %}

{% content-ref url="/pages/W0szSlRDVcIxtcKbDD3N" %}
[Playing your first song](/playing-your-first-song)
{% endcontent-ref %}


# How to use commands

You can execute commands using slash commands, press / like you're sending a message and the select green-bot in the list

![](https://3725463460-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVR916scdNqhBW7aHuuTM%2Fuploads%2FjTl8DqqbEiSIcNAQ5dtV%2Fimage.png?alt=media\&token=0ca7b648-6b4e-419c-8bd0-27157a517070)

#### How to execute a command ?

Select the command you want to use and press enter!

#### Isn't it another way?

Yes, you can use prefix commands by sending \* + the name of your command

Ex: `*play`

{% hint style="info" %}
`To get the command list, you can do the help command`
{% endhint %}


# Playing your first song

We've tried to make things simple to use whilst also giving you control of what happens in your voice channel. To get started with playing music you must first join the voice channel of your choice.

You can search for a specific song using the `/search` command.\
If you use the `/play` command, the bot will choose the first song.

Once you've made your search, Green-bot will search your song and add it to the queue.

If Green-bot give any results, or not the results you were looking for, then please give in a more specific search term or the direct link to the song instead.

*Green-Bot search finds only songs, if you want to play a video you have to prodvide the link*

![Playing Music](https://cdn.discordapp.com/attachments/863342883946627073/1010848984258052136/playsong.gif)

### Youtube video

You can also check this amazing video wich shows you how to play a song with the bot.

{% embed url="<https://youtu.be/zekLv1fl8HA>" %}


# Configuration

You will see there all the articles to learn how to setup Green-bot.


# Setting a default track announcement channel

You can set a default channel where Green-bot will send the track announcement messages

If no channel is set, it will use the channel where you made the command that made the bot joining your channel, do /leave and the play command again in another channel to change it.

#### Setting a channel

To set a channel, just do the following command replacing `{prefix}` by your prefix and `#channel` by your channel

`/textchannel #channel`

#### Disable the plugin

`/textchannel reset`


# Setup the DJ role

You can restrict some commands to only some users that have a specific role. By default to manage a queue an user needs the Manage Messages discord permission. You can remove this by setting as a dj role a role that this user has or giving him the permissions

#### Setup a dj role

The command is: `/setdj @role`

You can custom which commands can DJs use via the `/djcommands` command

#### Transfering the DJ of a queue

The DJ of a queue is the user that made the command that made the bot joining the voice channel. He bypasses all checks for DJs commands

You can transfer a queue DJ with `/givedj @user`


# 24/7 playback

If you want your green-bot to stay on your voice channel even when no songs are being played, you can enable this 24/7 mode.

You can enable it by using the 24/7 command: `/247`

You can use this same command to enable or disable the 24/7 mode


# Vote Skip system

The vote skip system consists in making users vote when there are 2 or more people in the voice room.

The vote skip system is enabled by default but you can disable it using `/voteskip`


# Restrict the bot to only some voice channels

If you want to make Green-bot working only in some voice channels, you can use the `/setvc` command. The bot will only work in the voice channels you'll set. if no channels are set it will work in all channels

#### Add a voice channel to the list

To add a voice channel to this list, run the following command:

`/setvc`

Then provide any channel and the bot will be able to play in this channel

The channel is now in the list of the allowed voice channels! You can check with the `/settings` command

#### Disable the restriction

Just do: `/setvc voice-channel` again and the channel will be removed from the list


# Restrict the bot to only some text channels

If you want to make Green-bot working only in some text channels, you can use the `/textchannels` command. The bot will only work in the text channels you'll set

#### Add a text channel to the list

To add a text channel to this list, run the following command:

`/textchannels`

The channel is now in the list of the allowed text channels! You can check with the `/settings` command

#### Disable the restriction

Just do: `/textchannels`  and select the same channel again to remove a channel from to the list


# Automatically shuffle playlists

You can shuffle automatically the spotify/youtube playlist with the Auto-Shuffle plugin

#### Enable the plugin.

Run `/autoshuffle`

#### Disable the plugin.

Run `/autoshuffle`


# Auto Enable Autoplay

You can automatically enable the autoplay for every single new queue with the Auto-Autoplay plugin

#### Enable the plugin.

Run `/autoautoplay`

#### Disable the plugin.

Execute the command again


# Disabling buttons on now playing message

You can hide the message on the now playing messages. The buttons are enabled by default

![](https://cdn.discordapp.com/attachments/863342883946627073/1012695706861051934/unknown.png)

#### Enable the plugin.

`/buttons`

#### Disable the plugin.

Execute the command again


# Disable the messages announcing a new song

You can disable the following message if you don't want that your channel full of messages

![](https://3725463460-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVR916scdNqhBW7aHuuTM%2Fuploads%2Fgit-blob-4176afaaf9ac9c3680b5a41c838661ab9c14a7a3%2Fimage.png?alt=media)

#### Enable the plugin.

Run `/announcesongs`

#### Disable the plugin.

Execute the command again


# Intro

Here are some useful informations about Green-bot Premium

Green-bot's main features are free but you need to vote for some commands that uses more CPU power than the others. You can bypass the vote-locks and access to some exclusive features with the premium.

***

#### Premium perks

* Access to 3 new premium bots with advanced 24/7
* Bypass cooldowns and do an unlimited number of commands per second
* Bypass need-vote commands for all bots.
* Set a default volume for the bot so you don't need to change it everytime
* Set a default track announcement channel
* Access to autoplay that automaticaly plays songs based on your previous songs and autoautoplay
* Remove duplicate songs and songs from users who left the channel.
* Access to new music filters ( karaoke, speed, pitch... )
* Create more than 5 playlists
* Cool role in our Official Discord Server to show how awesome you are

You can unlock all these perks with the Guild premium tier. You can have it for 2.50$ per month or 27$ per year!

***

You can get the premium here: <https://green-bot.app/premium>


# Redeem

Once you've purchased the premium, make sure that you have linked your patreon account with your discord account.

Click here to link your account: <https://patreon.com/settings/apps><br>

If you want you can 3 more bots:\
[Green-Bot 4](https://green-bot.app/invite/premium), [Green-Bot 5](https://discord.com/api/oauth2/authorize?client_id=1007179406567026699\&permissions=8\&scope=applications.commands%20bot) or [Green-bot 6](https://discord.com/oauth2/authorize?client_id=1013135708044677230\&scope=bot+applications.commands\&permissions=4331695368)

By default only you will be able to use it on your server but you can allow everyone to use it using the `/premium` command and selecting activate

*Once you get/enable the premium, you will have the perks on every version of Green-Bot*

The premium bots only have slashcommands, read more about it here: <https://blog.discord.com/slash-commands-are-here-8db0a385d9e6?gi=c5300813d5c9>

***

If you're having any unexpected issues with redeeming the premium, join our [support server](https://discord.gg/greenbot) and ask the questions in #premium-chat


# Getting the url

To get the url of a spotify track, playlist or album. Right click on it a click Share > Copy URL

![Get The Url](https://cdn.discordapp.com/attachments/863342883946627073/1012681974558773328/gettheurl.gif)

***

*You can also check the following guide:* [*https://wordpress.com/support/audio/spotify/*](https://wordpress.com/support/audio/spotify/)


# Play a song/Playlist

To play your album, playlist or track, Join a voice channel and then type:

`/play <link>`


# Bot is Muted

***

Here is a quick guide about how to unmute the bot on your voice channel!\
Note that you only need to do that one time.

Follow the following gif to check what's wrong.

![Muted](https://cdn.discordapp.com/attachments/863342883946627073/1010849143482224681/canhearthemusic.gif)

***

✨ Your problem is supposed to be fixed!\
Not fixed? Join our [support server](https://discord.gg/greenbot) and ask a moderator to do that for you!


# Permissions

We're going to learn how to give a permission to Green-bot.

Before starting, not that you can re-invite the bot to your server with the admin permissions to fix it ( You don't need to kick the bot ).\
<https://discord.com/oauth2/authorize?client_id=783708073390112830&scope=bot&permissions=19456>\
If you don't want to do that, it doesn't matter.

### 1. Edit the permissions of the channel

Click on the edit button behind your voice channel

![](https://3725463460-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVR916scdNqhBW7aHuuTM%2Fuploads%2Fgit-blob-e8d38143b91b910bf46a9227404aecf1c1b3daa8%2Fimage%20\(6\).png?alt=media)

Then, click on permissions

![](https://3725463460-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVR916scdNqhBW7aHuuTM%2Fuploads%2Fgit-blob-e6338f9cd45f9ef5420c9f4941142460fb7a68d2%2Fimage.png?alt=media)

Click on the "+" and add Green-bot

![](https://3725463460-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVR916scdNqhBW7aHuuTM%2Fuploads%2Fgit-blob-2f45f3acea1ed18e27d39e9cc142041d4f3f95ff%2Fimage.png?alt=media)

Scroll down and check "Speak" & "Connect"

![](https://3725463460-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVR916scdNqhBW7aHuuTM%2Fuploads%2Fgit-blob-f74d89730aead0c086b00cfe3dc1e13c6fad83d6%2Fimage.png?alt=media)

Your problem may be fixed!

Not fixed? Join our support server and ask a moderator to do that for you!


# Other

For any other issue, please join our Support Server:

<https://green-bot.app/discord>


# Playlists


# Saving a queue to a playlist

To use this command simply type: `/queue` and click: Save Queue

This will make a playlist and save your current queue to the playlist.


# Create a playlist

To create a playlist, type the command: `/pl-create <playlist-name>`

This will make a playlist on your account which can be played on any server.


# Adding songs to a playlist

You can add songs to the playlist you created by typing the command: `/pl-add <playlist-name> <song/url>`

After typing the above command the bot should say `Successfully added x track(s) to <playlist-name>`

You can add as many songs as you like or even add a spotify playlist to your own playlist on Green-bot


# Play a playlist

To play your own playlist type the command: `/pl-play <playlist-name`

For this you should have a playlist created and make sure to type your playlist is named correctly

After you type this command, the bot will add all the tracks in your playlist to the queue


# Delete a playlist

You can delete your playlist by typing the command: `/pl-delete <playlist-name>`

It's possible to delete every playlist by doing `/pl-delete all` Make sure to type the playlist name correctly otherwise the bot will say `You don't have any playlist called that`


# Edit a playlist

You can change a playlists name after typing the command: `/pl-list` then click: Edit a playlist

Then type the playlists order number (1 to 10) from the list

And finnaly type the New Name you want to give the playlist


# View your playlists

You can see all your playlists by typing the command: `/pl-list`

This will show all the playlists you have made so far (maximum 10) (Shows the playlist name and the number of tracks the playlist has)


# Features


# Changing Volume

You can controll Green-bot's volume in the voice channel using the volume command

\
To set the volume to a specific number just do `/volume number`\
You can specify a number between 1 and 200. Low values are not recomended

If you want to increase the volume use `/volume up`, to decrease it use `/volume down`

You see the current volume by using just `/volume`


# Loop Mode

**Queue Loop**

You can loop the current queue undefinitely using the loop queue mode

Just use the loopqueue command like that: `/loop queue`

**Song Loop**

You can loop the current song undefinitely using the loop song mode

Just use the loopsong command like that: `/loop song`

**Disable the Loop Mode**

You can disable the loop mode using the `*loop off` command


