Overview#

A Meta command can be invoked through m-name of the command or via discords slash command interface, so simply /name of the command. There are sometimes small differences between the slash commands and the old school ones, however those differences have no meaningfully impact.
Commands usually only work on servers except the Help and Playlist commands

The commands of meta are ordered in the following categories:

Category	Meant for	Usage
Help	Everyone	Shows the different help commands inside discord
Playlist	Everyone	Different commands to edit your playlists
General	DJs	Commands for playing and controlling the music
Volume	Admins	Used for the volume settings (like if everyone can change the volume)
Channel	Admins	Needed to setup and change the Meta channel
DJ	Admins	Makes it possible for users to set DJ roles or DJ users
Server	Admins	All commands to customize the behavior of Meta for the server
Blacklist	Admins	Allows for creating a blacklist for different songs

Help#

_{Aliases: h | Meant for Everyone}
Commands of this command group will send messages to help with the usage of Meta. Those messages describe the different functions of every command, just like any other help command it does.

• general#

  _{Aliases: ge | Permission needed: Usable for everyone}
  Show commands for playing and controlling the music.

• metachannel#

  _{Aliases: mc | Permission needed: Usable for everyone}
  Sends a description of the buttons and their functions in the meta channel.

• volume#

  _{Aliases: vl | Permission needed: Usable for everyone}
  Describes commands for setting volume specific settings. Those include limiting the maximum volume or if everyone is allowed to change the volume

• channel#

  _{Aliases: ch | Permission needed: Usable for everyone}
  Explains the commands for setting up a meta channel and also explains how you can clear or delete it.

• dj#

  _{Aliases: None | Permission needed: Usable for everyone}
  Shows the commands for setting up a DJ role or only specific users as a DJ. Also includes the commands for the neutral DJ settings.

• server#

  _{Aliases: sv | Permission needed: Usable for everyone}
  Commands for setting the settings of your server, like the default search engine, automatic looping, enabling voice commands or setting a custom embed and so on.

• playlist#

  _{Aliases: pl | Permission needed: Usable for everyone}
  Helps you with creating your own playlist or storing already existing playlists. Also helps with editing and renaming playlists.

• blacklist#

  _{Aliases: bl | Permission needed: Usable for everyone}
  The Commands used for creating a server wide blacklist for given tracks or query's.

Playlist#

_{Aliases: pl | Meant for Everyone}
Commands for creating and editing your playlists. Use m-playlist or /playlist show to see your playlists.

• create    name or link#

  _{Aliases: None | Permission needed: Needs to be at least a neutral DJ}
  Creates a new playlist for you with the given name. If the name is a link Meta stores the playlist from the link. So you are able to store spotify playlists or other playlists on Meta.

• delete    name or index#

  _{Aliases: None | Permission needed: Needs to be at least a neutral DJ}
  Deletes a playlist from your playlists. You can also use the playlist index so m-playlist delete 1 deletes the first playlist.

• move    up or down    name or index#

  _{Aliases: None | Permission needed: Needs to be at least a neutral DJ}
  Moves a playlist in the playlist list up or down. For example m-playlist move 2 up moves the second playlist one up, so it becomes the first.

• add    name or index    song name or link#

  _{Aliases: None | Permission needed: Needs to be at least a neutral DJ}
  Adds a track to the specified playlist. If the playlist is linked to another playlist for example if it's a spotify playlist this won't work. For this use convert.

• remove    name or index    song name or link or index#

  _{Aliases: None | Permission needed: Needs to be at least a neutral DJ}
  Removes a song from the playlist.

• rename    old name or index    new name#

  _{Aliases: None | Permission needed: Needs to be at least a neutral DJ}
  Renames a playlist.

• convert    name or index#

  _{Aliases: None | Permission needed: Needs to be at least a neutral DJ}
  Converts a url based playlist so a playlist linked to spotify etc. and makes it a Meta playlist able to be edited.

• list    name or index#

  _{Aliases: None | Permission needed: Needs to be at least a neutral DJ}
  Lists the first 20 tracks of a playlist. The 20 tracks is a discord limit please use the webapp to see the full playlist.

• favorite    name or index#

  _{Aliases: fav | Permission needed: Needs to be at least a neutral DJ}
  Sets a playlist as the favorite playlist. This means that songs you mark as favorite are getting added to that playlist.

General#

_{Aliases: None | Meant for DJs}
Commands for playing and controlling the music

• play    song name or link#

  _{Aliases: p | Permission needed: Needs to be at least a neutral DJ}
  Meta is going to play the given song or link. If you want to play a playlist you can simply copy the link of the playlist and paste it in. You can also use search prefixes in front of the song name, like sp: for spotify. For a full list of search prefixes see here.

• search    song name#

  _{Aliases: None | Permission needed: Needs to be at least a neutral DJ}
  The same as the upper mentioned play command, however instead of directly playing the track it first of all gives you a list of 10 songs to chose from. Also supports search prefixes.

• pause#

  _{Aliases: None | Permission needed: Needs to be at least a neutral DJ}
  Pauses or resumes the current track, depending on it already beeing paused or not. Basically a pause toggle.

• skip#

  _{Aliases: s | Permission needed: Needs to be at least a neutral DJ}
  Skips the current track and plays the next one.

• previous#

  _{Aliases: None | Permission needed: Needs to be at least a neutral DJ}
  Goes to the previous played track if one exists.

• current#

  _{Aliases: c | Permission needed: Usable for everyone}
  Meta sends a message showing the current song with buttons to skip, stop, pause and go to the previous song.

• queue#

  _{Aliases: q | Permission needed: Usable for everyone}
  Like the current command it shows the now playing track, but it also shows the queue up to the next 20 tracks.

• stop#

  _{Aliases: c | Permission needed: Needs to be at least a neutral DJ}
  Meta stops playing the current song and also clears the whole queue. If the 24h mode is not enabled meta will disconnect after the timeout set in the server setting.

• seek    position in seconds#

  _{Aliases: None | Permission needed: Only works if you are a normal DJ}
  The current track jumps to the given position. Optionally you can specify + or - in front of the position to jump as many seconds forward or backwards e.g. -10 goes 10 seconds back.

• eject#

  _{Aliases: None | Permission needed: Needs to be at least a neutral DJ}
  The same as the stop command, however Meta will disconnect instantly no matter if 24h mode is enabled or not.

• shuffle#

  _{Aliases: None | Permission needed: Needs to be at least a neutral DJ}
  Shuffles the queue and new songs will be randomly placed in queue. If the command is run again the queue gets back in its original order.

• repeat#

  _{Aliases: None | Permission needed: Needs to be at least a neutral DJ}
  Repeats the queue. If you want to stop repeating the queue, use this command again.

• repeatsong#

  _{Aliases: None | Permission needed: Needs to be at least a neutral DJ}
  Only repeats the current playing track. When the command is used again, it stops repeating the track.

• equalizer    band(1 - 15)    gain(-0.25 - 1)#

  _{Aliases: equa eq | Permission needed: Only works if you are a normal DJ}
  Sets the internal equalizer after the given band and gain. The equalizer gets reset after the current queue ends. To set the default equalizer use server equalizer

• save#

  _{Aliases: None | Permission needed: Usable for everyone}
  Saves the current queue as a playlist for you. To see all of your playlists check out the playlist commands

• favorite#

  _{Aliases: fav f | Permission needed: Usable for everyone}
  Adds the current track to your favorite tracks

Volume#

_{Aliases: vl | Meant for Admins}
A group of commands for setting the volume settings of your server. To see the current volume settings use m-volume or /volume show.

• default    0 to volume limit#

  _{Aliases: None | Permission needed: Requires and admin or a server manager}
  Sets the default volume of Meta if meta starts to play a song. Also support + or - operation so +10 raises the default volume by 10.

• limit    default volume to 1000#

  _{Aliases: None | Permission needed: Requires and admin or a server manager}
  Sets the maximum volume allowed to set. Also support + or - operation so +10 raises the default volume by 10.

• change    True or False#

  _{Aliases: None | Permission needed: Requires and admin or a server manager}
  Allows everyone who is a DJ to change the volume or prohibits anybody from setting it. This is to prevent someone of the DJs to joke around with the volume. For example if True anyone who is a DJ can use the volume set command and if False only admins can use this command and no one else can change the volume.

• step    0 - 1000#

  _{Aliases: None | Permission needed: Requires and admin or a server manager}
  Sets the step size for the volume buttons in the Meta channel. The default value is 10 meaning if you click volume up the volume gets raised by 10%. This allows to change the step for example to 5 or 20. It is also possible to set it to 100 which however doesn't really make sense from a user perspective.

• set    0 to volume limit#

  _{Aliases: None | Permission needed: Only works if you are a normal DJ}
  Changes the current volume of Meta, however this command can be prohibited through the volume change even tho you are a DJ. Also support + or - operation so +10 raises the default volume by 10.

Channel#

_{Aliases: ch | Meant for Admins}
Commands which manage the Meta channel of your server. Here you find commands for creating the Meta channel, clearing it and also removing its function. If you want to see the current meta channel use m-channel or /channel show.

• create#

  _{Aliases: None | Permission needed: Requires and admin or a server manager}
  Creates a new channel in your server witch functions as Meta channel. Everything written in the channel gets taken as a song request and added to the queue for a clean server. Moving the channel around or renaming it is no problem however if you delete the channel, and you want it back you need to rerun this command.

• set#

  _{Aliases: None | Permission needed: Requires and admin or a server manager}
  Sets the the channel where this command is run as the Meta channel. !WARNING! This clears the whole channel and removes any previous messages. Please use channel create if you are unsure.

• clear#

  _{Aliases: None | Permission needed: Requires and admin or a server manager}
  Removes every message in the Meta channel and updates the embeds in the channel. It won't remove the Meta channel function itself but rather clears messages of the Meta channel. Useful if a message wasn't deleted right or if the embed is buggy.

• delete#

  _{Aliases: None | Permission needed: Requires and admin or a server manager}
  Deletes the whole Meta channel from the server.

• remove#

  _{Aliases: None | Permission needed: Requires and admin or a server manager}
  The same as the delete command, however the channel remains afterwards, only the function as a Meta channel gets removed.

DJ#

_{Aliases: None | Meant for Admins}
The command group to set DJs in your server. To see every DJ use m-dj or /dj show.

• add    neutral (if its a normal DJ or not)    @discord role or user#

  _{Aliases: None | Permission needed: Requires and admin or a server manager}
  Adds a role or a user to the DJs. You can also specify multiple roles or users e.g. m-dj add @role1 @role2 @user1 @user2 @role3.... If you want to add neutral DJs use m-dj add neutral @role1.... In the case everyone should be a DJ you can also add @everyone, like m-dj add @everyone to remove @everyone just do the same in DJ remove. In case you use this command as slash command, please keep in mind that only one role or user can be specified, and you need to select if you want to add a role or a user.

• remove    neutral (if its a normal DJ or not)    @discord role or user#

  _{Aliases: None | Permission needed: Requires and admin or a server manager}
  The same as DJ add however instead of adding the DJ it removes the DJ from the DJ list. So please see there.

• clear    optional(role, user or everyone)#

  _{Aliases: None | Permission needed: Requires and admin or a server manager}
  Clears every set DJ. If you specify a section, for example role through m-dj clear role it only clears every DJ role but not the DJ users. When nothing is specified, so only m-dj remove everything gets cleared and no one will be a DJ.

• type    percent, total or interval#

  _{Aliases: None | Permission needed: Requires and admin or a server manager}
  Sets the handle type for the neutral DJs. If set to percent you need at least a given percentage of users in the channel to vote for the function. In the case of total you need the total amount and if interval is specified, you'll have a countdown and the function with the most votes wins. For more detail check the doc page about neutral DJs

• value    0 - 100#

  _{Aliases: None | Permission needed: Requires and admin or a server manager}
  Sets the value for the neutral DJs e.g. if you set the value to 50 and the type of the neutral DJs is percent, 50% of people in the voice channel need to vote for a function like skip.

Server#

_{Aliases: sv | Meant for Admins}
Every command to customize the appearance and behaviour of Meta on your server, from the time it takes to disconnect after the queue finishes to the default color. Use m-server or /server show to see the current settings

• 24h    True or False#

  _{Aliases: None | Permission needed: Requires and admin or a server manager}
  Enables or disables the 24h mode. If this mode is enabled Meta will stay forever in the voice channel and won't disconnect after the queue has finished. Use m-server 24h true to enable and false to disable this mode.

• channel    set or remove#

  _{Aliases: None | Permission needed: Requires and admin or a server manager}
  Sets a channel as the command channel, this will be the only channel where Meta responds to commands. If you want to disable this feature use channel remove.

• equalizerchange    True or False#

  _{Aliases: equachange | Permission needed: Requires and admin or a server manager}
  Enables or disables the Meta equalizer. If the equalizer is enabled everyone who is a DJ can change it through the equalizer command.

• equalizer    band(1 - 15)    gain(-0.25 - 1)#

  _{Aliases: equa eq | Permission needed: Requires and admin or a server manager}
  Sets the default equalizer for the server. This is different to m-equalizer, as this equalizer sets the default when the bot joins the voice channel. This gets also applied when equachange disabled is.

• search    searchengine#

  _{Aliases: None | Permission needed: Requires and admin or a server manager}
  Sets the default search engine / music provider for the server. Usually when you play a song it gets searched on YouTube and then played as YouTube is the default search engine of Meta. With this command you can set it to other platforms like spotify, twitch etc. For a full list of platforms see here

• timeout    0 - 600#

  _{Aliases: None | Permission needed: Requires and admin or a server manager}
  Sets the time it takes for Meta to disconnect from the channel after the song finished playing. When set to 0 Meta will instantly disconnect. If 24h mode is enabled the timeout controls how much time it takes until the queue gets cleared if everyone disconnects.

• blacklist    True or False#

  _{Aliases: None | Permission needed: Requires and admin or a server manager}
  Enables or disables a blacklist for specified songs on the server. See blacklist commands for more info.

• playlist    True or False#

  _{Aliases: pl | Permission needed: Requires and admin or a server manager}
  Enables or disables the editing of playlists on the server. If disabled, so m-server playlist false no one can edit and see their playlist on the server. They however are still able to play them. So if enabled it basically suppresses the playlist commands to keep the server clean.

• ensure    True or False#

  _{Aliases: None | Permission needed: Requires and admin or a server manager}
  When enabled it forces a person to be in the same voice channel as Meta to control the music.

• repeat    True or False#

  _{Aliases: None | Permission needed: Requires and admin or a server manager}
  When enabled automatically enables the queue repeat if Meta joins a voice channel.

• shuffle    True or False#

  _{Aliases: None | Permission needed: Requires and admin or a server manager}
  When enabled automatically enables the queue shuffle if Meta joins a voice channel.

• reset#

  _{Aliases: None | Permission needed: Requires and admin or a server manager}
  Resets all server settings back to default. This also includes volume, blacklist, channel and DJ settings.

• embed    picture url#

  _{Aliases: None | Permission needed: Requires and admin or a server manager}
  Sets the default picture in the Meta channel. This needs to be an url linking to a raw picture meaning urls like imgur.com won't work. Also supports Gifs.

• color    hex code#

  _{Aliases: None | Permission needed: Requires and admin or a server manager}
  Sets the default color scheme of Meta for this channel. The colo needs to be hexadecimal so like #ffffff.

• fallback    True or False#

  _{Aliases: None | Permission needed: Requires and admin or a server manager}
  When enabled Meta will research a track on YouTube if no track was found with the given search engine. For example if the default search engine is set to spotify and no tracks are found, Meta will automatically look for tracks on YouTube.

Blacklist#

_{Aliases: bl | Meant for Admins}
Commands for adding and removing words from the server wide blacklist for specific songs. To see the blacklist use m-blacklist or /blacklist show

• add    word or link for a song#

  _{Aliases: None | Permission needed: Requires and admin or a server manager}
  Adds a word or a song to the blacklist meaning songs with that word in the title can't be played

• remove    word or link for a song#

  _{Aliases: None | Permission needed: Requires and admin or a server manager}
  Removes a word or a song from the blacklist.

• clear#

  _{Aliases: None | Permission needed: Requires and admin or a server manager}
  Removes every word from the blacklist.