Skip to content

Audio sources

The bot plays from links, from searches, and from files. Paste a link into /play, type a song name to search YouTube, or attach an audio file to a play message.

Playing a SoundCloud search result, which shows Source: soundcloud, then an internet radio stream, which shows LIVE

This server has the extra prefix !! set. On a default install, type @JMusicBot play followed by the same link or scsearch: search.

Sites and streams

Source Examples
YouTube Videos, playlists, live streams, and searches by name (/search).
SoundCloud Tracks and playlists. Search with scsearch.
Bandcamp Tracks and albums.
Vimeo Videos.
Twitch Live streams.
Beam Live streams.
getyarn.io Short clips.
NicoNico Videos.
HTTP links Direct links to audio files, and internet radio streams, including M3U and PLS playlists.
Local files Files on the bot's computer, by path.

Each source can be turned off in config.txt, for example to stop people playing files from the bot's computer:

playback {
  audioSources {
    local = false
  }
}

File formats

The bot can play MP3, FLAC, WAV, Matroska and WebM (AAC, Opus or Vorbis), MP4 and M4A (AAC), OGG streams (Opus, Vorbis and FLAC), and AAC streams.

When a song won't play

If a song fails to load, the bot says so and moves on. For YouTube songs that won't play, see Troubleshooting. The yt-dlp library can also download those and play them from disk.

Who can use it

Everyone can play from any source that's turned on. Only the bot owner can turn sources on or off.

Settings

Setting Default What it does
playback.audioSources.<source> true Turn a source on or off: youtube, soundcloud, bandcamp, vimeo, twitch, beam, getyarn, nico, http, local.
playback.maxTrackSeconds 0 Longest song allowed, in seconds. 0 means no limit.
playback.maxYouTubePlaylistPages 10 How much of a YouTube playlist to load, 100 songs per page.

The bot plays these sources through lavaplayer, so anything lavaplayer supports works here.

Next: Desktop app.