Version 0.2.3

This version updates dependencies to fix some loading issues, and adds the movetrack command!

What's fixed?

• fixed some loading issues on some songs

What's new?

• added the movetrack command to move a track in the queue to a different position

---

Setup

https://github.com/jagrosh/MusicBot/wiki/Setup

What to download?

Download one of the following:

• JMusicBot-0.2.3.jar (this version works on all platforms)
• JMusicBot-0.2.3-Windows.jar
• JMusicBot-0.2.3-Linux.jar
• JMusicBot-0.2.3-Mac.jar

Download config.txt if you don't have an existing config or want to use a template instead of migrating a previous version of the config

Download example_playlist.txt only if you need an example for how to set up the playlist. If you download this, put it in a "Playlists" folder.

Your folder should look like this (except use the correct version number):

Remember, please do not put these files on your desktop or anywhere restricted. Putting them together in a folder in your "My Documents" folder is the best option.

DO NOT DOWNLOAD THE SOURCE CODE .zip/.tar.gz. DO NOT DOWNLOAD ANY .java FILES. PLEASE READ ABOVE WHAT YOU NEED TO DOWNLOAD.

Version 0.2.2

What's fixed?

• improved startup/config-loading flow
• write entire config file when no config exists

What's new?

• added an initial version of the lyrics command

---

Setup

https://github.com/jagrosh/MusicBot/wiki/Setup

What to download?

Download one of the following:

• JMusicBot-0.2.2.jar (this version works on all platforms)
• JMusicBot-0.2.2-Windows.jar
• JMusicBot-0.2.2-Linux.jar
• JMusicBot-0.2.2-Mac.jar

Download config.txt if you don't have an existing config or want to use a template instead of migrating a previous version of the config

Download example_playlist.txt only if you need an example for how to set up the playlist. If you download this, put it in a "Playlists" folder.

Your folder should look like this (except use the correct version number):

Remember, please do not put these files on your desktop or anywhere restricted. Putting them together in a folder in your "My Documents" folder is the best option.

DO NOT DOWNLOAD THE SOURCE CODE .zip/.tar.gz. DO NOT DOWNLOAD ANY .java FILES. PLEASE READ ABOVE WHAT YOU NEED TO DOWNLOAD.

Version 0.2.1

This is effectively a patch update that fixes a few small bugs with the last release, and adds a tiny bit of functionality.

What's fixed?

• autoplaylists don't prevent some commands from working
• setting the dj role to @ everyone lets everyone use DJ commands
• better-formatted alert boxes

What's new?

• added an initial version of the playnext command
• (reiterating that the config is very different as of 0.2.0)

---

The new configuration

The new JMusicBot configuration (as of 0.2.0) is now in the HOCON format.

Migrating your config.txt

For the most part, migrating your existing config.txt file is easy; putting the prefix and emojis in double quotes should be sufficient. See the example config for a template. For example, if you previously had

prefix=!!

you will need to change this to

prefix="!!"

More configuration power!

Now you can specify an alternative location to look for your config file (and it can be named whatever you want). Simply include a -Dconfig=/path/to/config/file flag before the -jar flag. You can also set any configuration option (instead of put it in the config file) in a similar format. For example, to set the prefix from the command line instead of the config file, add a -Dprefix=!! flag before the -jar flag.
Ex:

java -Dconfig=myconfig.txt -Dprefix=! -jar JMusicBot-0.2.0.jar

would look for a file called 'myconfig.txt' instead of 'config.txt', and the bot would use the prefix ! (the command line takes precedence over the config file if you set something in both).

---

New flags

As noted in the above configuration section, the latest release implements a change in how flags are provided.

Previously...

The only available flag was -nogui which was placed after the name of the jar and would start the bot without starting a separate window.

Now...

All flags must come before the -jar flag (after the java) and begin with -D. Notable flags include:

• -Dnogui=true disables the gui (same as what -nogui did before)
• -Dconfig=/path/to/configfile sets the file to look for as a config file
• -Dsettingname="some value" sets anything that is normally settable via the config file
  You can use as many or as few flags as you wish; just remember not to lose the -jar as the last flag before the name of the jar.

---

Setup

https://github.com/jagrosh/MusicBot/wiki/Setup

What to download?

Download one of the following:

• JMusicBot-0.2.1,jar (this version works on all platforms)
• JMusicBot-0.2.1-Windows.jar
• JMusicBot-0.2.1-Linux.jar
• JMusicBot-0.2.1-Mac.jar

Download config.txt if you don't have an existing config or want to use a template instead of migrating a previous version of the config

Download example_playlist.txt only if you need an example for how to set up the playlist. If you download this, put it in a "Playlists" folder.

Your folder should look like this (except use the correct version number):

Remember, please do not put these files on your desktop or anywhere restricted. Putting them together in a folder in your "My Documents" folder is the best option.

DO NOT DOWNLOAD THE SOURCE CODE .zip/.tar.gz. DO NOT DOWNLOAD ANY .java FILES. PLEASE READ ABOVE WHAT YOU NEED TO DOWNLOAD.

Version 0.2.0

This update is an update to the bot's internals (performance and code quality) as well as the usage of a new configuration format.

What's fixed?

• dependencies are now up-to-date
• some edge-cases with blocking should be fixed

What's new?

• overhauled internals in preparation for expanding features easier in the future
• automatic DM to the bot owner when a new version is available (can disable in config)
• new flag to start in no-gui mode (see below)
• new config format, old configs will likely not work

---

The new configuration

The new JMusicBot configuration is now in the HOCON format.

Migrating your config.txt

For the most part, migrating your existing config.txt file is easy; putting the prefix and emojis in double quotes should be sufficient. See the example config for a template. For example, if you previously had

prefix=!!

you will need to change this to

prefix="!!"

More configuration power!

Now you can specify an alternative location to look for your config file (and it can be named whatever you want). Simply include a -Dconfig=/path/to/config/file flag before the -jar flag. You can also set any configuration option (instead of put it in the config file) in a similar format. For example, to set the prefix from the command line instead of the config file, add a -Dprefix=!! flag before the -jar flag.
Ex:

java -Dconfig=myconfig.txt -Dprefix=! -jar JMusicBot-0.2.0.jar

would look for a file called 'myconfig.txt' instead of 'config.txt', and the bot would use the prefix ! (the command line takes precedence over the config file if you set something in both).

---

New flags

As noted in the above configuration section, the latest release implements a change in how flags are provided.

Previously...

The only available flag was -nogui which was placed after the name of the jar and would start the bot without starting a separate window.

Now...

All flags must come before the -jar flag (after the java) and begin with -D. Notable flags include:

• -Dnogui=true disables the gui (same as what -nogui did before)
• -Dconfig=/path/to/configfile sets the file to look for as a config file
• -Dsettingname="some value" sets anything that is normally settable via the config file
  You can use as many or as few flags as you wish; just remember not to lose the -jar as the last flag before the name of the jar.

---

Setup

https://github.com/jagrosh/MusicBot/wiki/Setup

What to download?

Download one of the following:

• JMusicBot-0.2.0,jar (this version works on all platforms)
• JMusicBot-0.2.0-Windows.jar
• JMusicBot-0.2.0-Linux.jar
• JMusicBot-0.2.0-Mac.jar

Download config.txt if you don't have an existing config or want to use a template instead of migrating a previous version of the config

Download example_playlist.txt only if you need an example for how to set up the playlist. If you download this, put it in a "Playlists" folder.

Your folder should look like this (except use the correct version number):

Remember, please do not put these files on your desktop or anywhere restricted. Putting them together in a folder in your "My Documents" folder is the best option.

DO NOT DOWNLOAD THE SOURCE CODE .zip/.tar.gz. DO NOT DOWNLOAD ANY .java FILES. PLEASE READ ABOVE WHAT YOU NEED TO DOWNLOAD.

Version 0.1.3

This update updates dependencies to support more sources and to keep up with Discord's fairly-often-changing API.

What's fixed?

• fixed some exceptions that got thrown on rare occasions
• implemented Pair manually to stop some OpenJDK conflicts

What's new?

• automatically checks for new versions at startup
• more details about where config is being loaded from
• os-specific jars if you want to save a bit of space

Setup

https://github.com/jagrosh/MusicBot/wiki/Setup

What to download?

Download one of the following:

• JMusicBot-0.1.3,jar (this version works on all platforms)
• JMusicBot-0.1.3-Windows.jar
• JMusicBot-0.1.3-Linux.jar
• JMusicBot-0.1.3-Mac.jar

Download config.txt only if you don't have an existing config for a previous version of the bot

Download example_playlist.txt only if you need an example for how to set up the playlist. If you download this, put it in a "Playlists" folder.

Your folder should look like this (except use the correct version number):

Remember, please do not put these files on your desktop or anywhere restricted. Putting them together in a folder in your "My Documents" folder is the best option.

DO NOT DOWNLOAD THE SOURCE CODE .zip/.tar.gz. DO NOT DOWNLOAD ANY .java FILES. PLEASE READ ABOVE WHAT YOU NEED TO DOWNLOAD.

Version 0.1.2

This update fixes a recent change to YouTube's page format which broke a lot of music bots. It also adds a bit more customization.

What's fixed?

• fixed loading issues on some youtube tracks

What's new?

• loading= and searching= items added to config for more customization
• Tracks with attached playlists are now more intuitive to use
• Due to the new YouTube format, some tracks may take longer to load. There is nothing I can do about this :(

Setup

https://github.com/jagrosh/MusicBot/wiki/Setup

What to download?

Download JMusicBot-0.1.2.jar and config.txt. You can skip the config if you already have a previous version (backwards compatible), but there are some new options so it may be worth taking a look at the example config. If you download the example_playlist.txt, make sure to put it in a "Playlists" folder. Your folder should look like this (except use the correct version number):


Remember, please do not put these files on your desktop or anywhere restricted. Putting them together in a folder in your "My Documents" folder is the best option.

DO NOT DOWNLOAD THE SOURCE CODE .zip/.tar.gz. DO NOT DOWNLOAD ANY .java FILES. PLEASE READ ABOVE WHAT YOU NEED TO DOWNLOAD.

Version 0.1.1

This update fixes some underlying load issues, as well as adds new game options, repeat mode, and a new way to load playlists!

What's fixed?

• fixed loading issues on some youtube urls
• fixed some radio locations
• stop command will always allow the bot to leave the channel

What's new?

• Repeat mode (DJ command) for automatically repeating finished songs (puts them on the end of the queue)
• More game options ("Listening to", "Watching", etc), see the config
• When loading a video with an attached playlist (or youtube mix), it will ask you if you want to load the list after loading the song

Setup

https://github.com/jagrosh/MusicBot/wiki/Setup

What to download?

Download JMusicBot-0.1.1.jar and config.txt. You can skip the config if you already have a previous version (backwards compatible), but there are some new options so it may be worth taking a look at the example config. If you download the example_playlist.txt, make sure to put it in a "Playlists" folder. Your folder should look like this (except use the correct version number):


Remember, please do not put these files on your desktop or anywhere restricted. Putting them together in a folder in your "My Documents" folder is the best option.

DO NOT DOWNLOAD THE SOURCE CODE .zip/.tar.gz. DO NOT DOWNLOAD ANY .java FILES. PLEASE READ ABOVE WHAT YOU NEED TO DOWNLOAD.

Version 0.1.0

Small bugs and version bump

What's fixed?

• config loads more formats correctly
• no longer spams errors related to channel categories
• supports longer yt playlists (max 6 pages -> max 10 pages)
• more filtered output

Setup

https://github.com/jagrosh/MusicBot/wiki/Setup

What to download?

Download JMusicBot-0.1.0.jar and config.txt. You can skip the config if you already have a previous version (backwards compatible), but there are some new options so it may be worth taking a look at the example config. If you download the example_playlist.txt, make sure to put it in a "Playlists" folder. Your folder should look like this (except use the correct version number):


Remember, please do not put these files on your desktop or anywhere restricted. Putting them together in a folder in your "My Documents" folder is the best option.

DO NOT DOWNLOAD THE SOURCE CODE .zip/.tar.gz. DO NOT DOWNLOAD ANY .java FILES. PLEASE READ ABOVE WHAT YOU NEED TO DOWNLOAD.

Version 0.0.9

Finally caught a lot of bigger bugs, and added some more requested features

What's fixed?

• Internal issues with the bot thinking no music playing (when it actually is) fixed
• Issue with adding songs when playing from the autoplaylist fixed

What's new?

• status item in config to set the bot's status at startup
• setgame stream <username> <game name> to make the bot "streaming"
• autoplaylist command as a shortcut for playlist setdefault
• can set a global maximum song length in the config (maxtime takes a number of seconds to use as the maximum)
• setting songinstatus to true now shows the song in the status as long as there is only one actual audio connection open, instead of being limited to the bot being in only one guild

What's changed?

• The constantly-refreshing channel topics have been removed (see this issue for why). Therefore, the noprogressintopic config option has been removed. Now, if the bot has perms, it will only update the channel topic with the song titles. To disable the topic-changing completely, don't give the bot permission to change the channel topic
• The last-used nowplaying command now refreshes every few seconds to stay accurate. However, this causes the video thumbnail to also be re-loaded each time. The thumbnail has been removed. If you'd like to revert back to the old nowplaying command (no refresh but with thumbnail), set the npimages config item to true.

Setup

https://github.com/jagrosh/MusicBot/wiki/Setup

What to download?

Download JMusicBot-0.0.9.jar and config.txt. You can skip the config if you already have a previous version (backwards compatible), but there are some new options so it may be worth taking a look at the example config. If you download the example_playlist.txt, make sure to put it in a "Playlists" folder. Your folder should look like this (except use the correct version number):


Remember, please do not put these files on your desktop or anywhere restricted. Putting them together in a folder in your "My Documents" folder is the best option.

DO NOT DOWNLOAD THE SOURCE CODE .zip/.tar.gz. DO NOT DOWNLOAD ANY .java FILES. PLEASE READ ABOVE WHAT YOU NEED TO DOWNLOAD.

Version 0.0.8

This update adds a few new smaller features and hopefully fixes some more bugs

What's fixed?

• Some internal bugs should be fixed because of dependency version bumps

What's new?

• altprefix item in config to assign a second prefix for the bot
• songinstatus item in config that can be set to true to allow the bot to show the currently-playing song in its game status ("Playing ...") if it is on only one server.
• setstatus command to change the bot from the default Online to Idle, DnD, or Invisible

Setup

https://github.com/jagrosh/MusicBot/wiki/Setup

What to download?

Download JMusicBot-0.0.8.jar and config.txt. You can skip the config if you already have a previous version (backwards compatible), but there are some new options so it may be worth taking a look at the example config. If you download the example_playlist.txt, make sure to put it in a "Playlists" folder. Your folder should look like this (except use the correct version number):


Remember, please do not put these files on your desktop or anywhere restricted. Putting them together in a folder in your "My Documents" folder is the best option.

DO NOT DOWNLOAD THE SOURCE CODE .zip/.tar.gz. DO NOT DOWNLOAD ANY .java FILES. PLEASE READ ABOVE WHAT YOU NEED TO DOWNLOAD.