example_options.ini

# This is the configuration file for MusicBot. Do not edit this file using Notepad.
# Use Notepad++ or a code editor like Visual Studio Code.
# For help, see: https://just-some-bots.github.io/MusicBot/

[Credentials]
# Your Discord bot account token. Required to run the bot.
Token = bot_token

# The bot supports converting Spotify links and URIs to YouTube videos and
# playing them. You can either enter your own Spotify developer app credentials
# below, or the bot will use public credentials to communicate with Spotify.
Spotify_ClientID =
Spotify_ClientSecret =

[Permissions]
# This option determines which user has full permissions and control of the bot.
# Only one user can be the bot's owner. You can generally leave this as "auto".
OwnerID = auto

# This option determines which users have access to developer-only commands.
# You should leave this blank unless you know what you are doing.
DevIDs =

# This bot ignores other bots by default. You can add other bot's IDs here to
# allow MusicBot to listen to their messages.
BotExceptionIDs =

[Chat]
# Determines the prefix that must be used before commands in the Discord chat.
# e.g if you set this to *, the play command would be triggered using *play.
CommandPrefix = !

# Restricts the bot to only listening to certain text channels.
# Space-separated list of text channel IDs.
BindToChannels =

# Setting this to "yes" will allow the MusicBot to work in any channel on servers
# which do not have a "bound" channel set above.
AllowUnboundServers = no

# Allows the bot to automatically join voice channels on startup.
# Space-separated list of voice channel IDs.
AutojoinChannels =

# If set to "yes", the bot will send a DM to the user who requested a song when their
# song begins to play, rather than posting a message in the text channel.
DMNowPlaying = no

# Disable now playing messages for entries automatically added by the bot, via the autoplaylist.
DisableNowPlayingAutomatic = no

# Force the bot to send "now playing" messages in specific text channels.
# If this is empty, the bot will send the messages in the channel where the song was requested.
NowPlayingChannels =

# If "yes", delete the "now playing" messages after a small period of time.
DeleteNowPlaying = yes

[MusicBot]
# The volume of the bot's audio output, between 0.01 and 1.0.
DefaultVolume = 0.25

# The number of people voting to skip in order for a song to be skipped successfully,
# whichever value is lower will be used. Ratio refers to the percentage of undefeaned, non-
# owner users in the channel. 
SkipsRequired = 4
SkipRatio = 0.5

# Determines if downloaded videos will be saved to the audio_cache folder permanently.
# If "yes", videos will not be re-downloaded if queued again, at the cost of hard-drive space.
SaveVideos = yes

# Mentions the user who queued a song when it starts to play.
NowPlayingMentions = no

# Automatically joins the owner's voice channel on startup, if possible. The bot must be on
# the same server and have permission to join the channel.
AutoSummon = yes

# Start playing songs from the autoplaylist.txt file after joining a channel. This does not
# stop users from queueing songs, you can do that by restricting command access in permissions.ini.
UseAutoPlaylist = yes

# Sets if the autoplaylist should play through songs in a random order when enabled. If no,
# songs will be played in a sequential order instead.
AutoPlaylistRandom = yes

# Pause the music when nobody is in a voice channel, until someone joins again.
AutoPause = yes

# Automatically cleanup the bot's messages after a small period of time.
DeleteMessages = yes

# If this and DeleteMessages is enabled, the bot will also try to delete messages from other
# users that called commands. The bot requires the 'Manage Messages' permission for this.
DeleteInvoking = no

# Regularly saves the queue to the disk. If the bot is then shut down, the queue will
# resume from where it left off.
PersistentQueue = yes

# Determines what messages are logged to the console. The default level is INFO, which is
# everything an average user would need. Other levels include CRITICAL, ERROR, WARNING,
# DEBUG, VOICEDEBUG, FFMPEG, NOISY, and EVERYTHING. You should only change this if you
# are debugging, or you want the bot to have a quieter console output.
DebugLevel = INFO

# Specify a custom message to use as the bot's status. If left empty, the bot
# will display dynamic info about music currently being played in its status instead.
StatusMessage = 

# Write what the bot is currently playing to the data/<server id>/current.txt FILE.
# This can then be used with OBS and anything else that takes a dynamic input.
WriteCurrentSong = no

# Allows the person who queued a song to skip their OWN songs instantly, similar to the
# functionality that owners have where they can skip every song instantly.
AllowAuthorSkip = yes

# Enables experimental equalization code. This will cause all songs to sound similar in
# volume at the cost of higher processing consumption when the song is initially being played.
UseExperimentalEqualization = no

# Enables the use of embeds throughout the bot. These are messages that are formatted to
# look cleaner, however they don't appear to users who have link previews disabled in their
# Discord settings.
UseEmbeds = yes

# The amount of items to show when using the queue command.
QueueLength = 10

# Remove songs from the autoplaylist if an error occurred while trying to play them.
# If enabled, unplayable songs will be moved to another file and out of the autoplaylist.
# You may want to disable this if you have internet issues or frequent issues playing songs.
RemoveFromAPOnError = yes

# Whether to show the configuration for the bot in the console when it launches.
ShowConfigOnLaunch = no

# Whether to use legacy skip behaviour. This will change it so that those with permission
# do not need to use "skip f" to force-skip a song, they will instead force-skip by default.
LegacySkip = no

# Leave servers if the owner is not found in them.
LeaveServersWithoutOwner = no

# Use command aliases defined in aliases.json.
UseAlias = yes

# Use an alternate way to display the results from search command.
SearchList = no

# Set the amount of search results returned by default.
DefaultSearchResults = 3

# Specify a custom message to use as the bots embed footer.
CustomEmbedFooter =

# Sets if you'd like the bot to deafen when joining a voice channel
SelfDeafen = yes

[Files]
# Path to your i18n file. Do not set this if you do not know what it does.
i18nFile =