Skip to content
This repository has been archived by the owner on Jun 28, 2024. It is now read-only.

Playback mode explained

Jump to bottom
Terry Geng edited this page Mar 29, 2020 · 6 revisions

After version 5.1 of botamusique, we added four playback modes to emulate the behavior of a classic music player. They are one-shot, repeat, random, autoplay. The main difference between each mode is how the bot will behave when reaching the bottom of the playlist.

  • one-shot (default): Items on the playlist that have already played would be removed. If you skip songs or jump to an item after current songs, items you have skipped or jumped would be also removed. This is the behavior of the previous version (<6).

  • repeat: When reaching the end of the playlist, the bot will start over from the first item, i.e. looping through the entire playlist.

  • random: Once "random" mode is toggled, the playlist will be reshuffled. After that, every time the bot reaching the end of the playlist, it will reshuffle again.

  • autoplay: It is essentially a one-shot playlist, with the feature that when reaching the end of the playlist, the bot will randomly select 5 songs from the library to refill the playlist. The number 5 can be set in the configuration file, by the autoplay_length option in section [bot].

If you don't want a song to be autoplayed, you can add a tag don't autoplay to it to exclude it from being selected.

You can change the playback mode by:

  • Through the web interface: Four playback modes on the web interface

  • Send command to the bot: '!mode one-shot', '!mode repeat', '!mode random', '!mode autoplay'. This command will also write the mode you set into the database.

  • Set default playback mode in the configuration file:

[bot]
playback_mode = repeat

Note: playback mode set in the configuration file will be overridden by the mode set in the database.

Clone this wiki locally