Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.jobot.jeppdev.com/llms.txt

Use this file to discover all available pages before exploring further.

JoBot can join your voice channel and play music sourced from YouTube or a Subsonic personal music server. There are no slash commands to learn — you ask for music in plain English and JoBot handles the rest.

How it works

When you ask JoBot to play something, it searches the available music source, adds tracks to its playback queue, and streams them into your voice channel. The AI interprets your request and decides which tool to use — searching by title and artist, fetching random songs, or queuing multiple tracks at once.
1

Ask JoBot for music

Send a message mentioning JoBot with a natural language request, such as @JoBot play some Radiohead or @JoBot shuffle my library.
2

JoBot searches and queues

JoBot searches the configured music source, selects matching tracks, and adds them to the queue.
3

Music plays in your voice channel

JoBot joins your voice channel (if it isn’t already there) and begins streaming.

YouTube music

JoBot can search YouTube for any song, artist, or album. Use natural language to describe what you want to hear. Example prompts:
  • @JoBot play Mr. Brightside by The Killers
  • @JoBot search for lo-fi hip hop
  • @JoBot find something by Boards of Canada

Subsonic library

If you have a Subsonic server configured, JoBot uses it as its preferred music source. It can search your library, fetch random tracks, and generate shareable links for songs. Example prompts:
  • @JoBot play something from my library
  • @JoBot pick a random song
  • @JoBot find Portishead in my collection
When both Subsonic and YouTube are configured, JoBot prefers Subsonic for music lookups. Configure your Subsonic server in your environment variables to take advantage of your personal library.

Queue management

JoBot maintains a playback queue for your server. Tracks play in order, and you can ask JoBot to skip, stop, or describe what’s currently playing. Example prompts:
  • @JoBot what's playing?
  • @JoBot skip this song
  • @JoBot stop the music
  • @JoBot show me the queue
JoBot can create temporary share links for songs in your Subsonic library. Share links are tied to specific songs and can be set to expire after a number of days. Example prompts:
  • @JoBot create a share link for this song
  • @JoBot share a link to that track that expires in 7 days
You can also ask JoBot to list or delete existing share links.

Voice channel commands

You can ask JoBot to join or leave your voice channel directly:
What you sayWhat JoBot does
@JoBot join my voice channelJoins the voice channel you’re currently in
@JoBot leave the voice channelDisconnects from the current voice channel
@JoBot skip this songSkips to the next track in the queue
@JoBot stop the musicStops playback entirely
@JoBot what's playing?Describes the current track and queue
JoBot needs to be in a voice channel before it can play music. If you ask it to play something and it isn’t already connected, it will join your current voice channel first.