Play your Plex music in Discord with style.
| Modern Visual Player | Classic Player Embed |
|---|---|
 |
 |
PlexBot is a next-generation Discord music bot designed for Plex users. Seamlessly stream your personal music library (and more!) into your server’s voice channels, enjoy a beautiful visual player, and take advantage of a robust extension system for ultimate flexibility.
- Stream from Plex: Play tracks, albums, artists, and playlists directly from your Plex server.
- YouTube Support: Search and play music from YouTube.
- Interactive Player UI: Choose between a modern image-based player or a classic Discord embed.
- Static Player Channel: Optionally dedicate a channel for the persistent player UI.
- Rich Queue Management: Add, remove, shuffle, and loop tracks with intuitive controls.
- Slash Commands: Clean, discoverable, and autocomplete-enabled.
- Extensible: Powerful Extensions system for custom features.
- Easy Setup: Guided installation and Docker support.
- Troubleshooting & Guides: Player UI Guide, Troubleshooting, and more.
- More Music Sources: Spotify, SoundCloud, and additional streaming integrations.
- User Custom Playlists: Save, manage, and share your own playlists within Discord.
- Expanded Command Set: More slash commands for advanced control and new features.
- Command Panel UI: In static player channels, use an interactive command panel (embed with buttons) for a seamless experience (no slash commands needed).
- Additional Visual Player Styles: Choose from more themes and layouts for the player UI.
- And much more...
PlexBot offers two distinct player UIs:
- Sleek, image-based: Uses album art as a background, overlaying track info and controls for a rich, modern look.
- Best for dedicated channels: Looks stunning as a persistent player in a static channel.
- Traditional Discord embed: Familiar, compact, and works anywhere.
- Great for multi-purpose channels: Shows album art as a thumbnail.
- Set the player style in your
.envfile:PLAYER_STYLE_VISUAL=true(Modern Visual)PLAYER_STYLE_VISUAL=false(Classic Embed)
- To use a static player channel, set:
USE_STATIC_PLAYER_CHANNEL=trueSTATIC_PLAYER_CHANNEL_ID=<channel_id>
For more, see the Player UI Guide.
/search [query] [source]
Search your Plex library or YouTube. Interactive menus for artists, albums, and tracks.Example:
/search query:"The Beatles" source:"plex"
/playlist [playlist] [shuffle]
Play a full Plex playlist, optionally shuffled.Example:
/playlist playlist:"Summer Hits" shuffle:true
/play [query]
Quickly play a track, album, or artist by search term.Example:
/play query:"Bohemian Rhapsody"
/help
Show an interactive help menu with all commands and usage tips.See the Installation Guide and Configuration Guide for full details.
- Docker (Required)
- Discord bot token
- Plex server credentials (token & base URL)
git clone https://github.com/kalebbroo/PlexBot.git
cd PlexBotConfig the .env and run the install_win.bat/install_linux.sh. This will build the Docker image, install dependencies, and start the container.
Rename .envrename.txt to .env and fill in your credentials. Example:
DISCORD_TOKEN=your-discord-bot-token
PLEX_TOKEN=your-plex-token
PLEX_BASE_URL=your-plex-base-urlPlexBot supports Docker for easy deployment. See the Docker Guide.
PlexBot’s Extensions system lets you add custom features, integrations, and automations. Build your own or browse community extensions.
MIT License. See LICENSE.
DOWNLOADING OR USING THIS SOFTWARE CONSTITUTES ACCEPTANCE OF THE TERMS AND CONDITIONS OF THE MIT LICENSE. THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESSED OR IMPLIED.
PlexBot is not affiliated with Plex, YouTube, or Discord. PlexBot and Kaalebbroo.Dev are affiliated with Hartsy.AI (Allowing artists to control how their work is used)