A minimalist, self-hosted Discord music bot with a powerful TUI dashboard.
Explore the official documentation »
Playify has been completely rewritten to provide a seamless, robust, and beautiful experience directly from your terminal.
- Interactive TUI dashboard: Monitor resources, queue length, active players, and logs in real-time through a beautiful ASCII interface.
- Built-in auto-updater: Keep your bot up to date directly from the dashboard. No
git pullor manual downloads required. - One-click installer: Run the setup script and let Playify automatically install Python, download FFmpeg, and set up your
.envconfiguration. - In-app settings menu: Configure your bot's Discord presence, default volumes, and UI customization without touching a text file.
Playify is an open-source Discord music bot built for simplicity. No web interface, no paywalls, no account needed - just slash commands and music.
It supports YouTube, YouTube Music, SoundCloud, Twitch, Spotify, Deezer, Bandcamp, Apple Music, Tidal, Amazon Music, direct audio links, and local files.
Type /play <url or query> and let it run.
~ sources & playback
- Play from 10+ sources: YouTube, SoundCloud, Twitch, Spotify, Apple Music, etc.
- Direct audio links: stream any public MP3, FLAC, WAV, or audio URL.
- Local file playback: upload and play your own audio/video files directly.
- Autoplay of similar tracks via YouTube Mix and SoundCloud Stations.
- Loop and shuffle queue controls.
- Audio filters: slowed, reverb, bass boost, nightcore, and more.
> spotify support
- Individual tracks.
- Personal and public playlists.
- Spotify-curated mixes (Release Radar, Your Mix) via SpotifyScraper, bypassing API limits.
+ extras
- Lyrics fetching and display for the current track.
- Karaoke mode with synced lyrics.
- 24/7 mode to keep the bot in a channel permanently.
- Kawaii mode - toggle cute kaomoji responses with
/kaomoji. - Interactive queue pages, track removal menus, and a seek interface.
For the complete installation guide (including Docker configurations), please visit the installation documentation.
[ windows - recommended ]
- Download the repository as a ZIP and extract it, or clone it via git.
- Double-click
start.bat. - The Playify installer will automatically install Python, download FFmpeg, and prompt you for your Discord token.
- The TUI dashboard will launch automatically.
[ linux ]
Playify natively supports Linux with an automated setup script.
- Clone the repository:
git clone https://github.com/alan7383/playify.git - Enter the directory:
cd playify - Run the bootstrapper:
bash start.sh - The script will set up your virtual environment, automatically download a local copy of FFmpeg, and launch the dashboard.
For a detailed explanation of each feature, check out the commands reference.
| Command | Description |
|---|---|
/play <url/query> |
Add a song or playlist. Supports direct audio links. |
/search <query> |
Search and choose from the top results. |
/play-files <file(s)> |
Play one or more uploaded audio/video files. |
/queue |
Show the queue with interactive pages. |
/lyrics |
Fetch and display lyrics for the current song. |
/karaoke |
Start a karaoke session with synced lyrics. |
/24_7 <mode> |
Keep the bot in the channel 24/7, even when idle (normal, auto, off). |
/defaultvolume <level> |
Set the volume the bot starts at when it joins (saved per server). |
/reconnect |
Refresh the voice connection without losing your place. |
(And many more...)
- FFmpeg not found - The Windows
start.bathandles this automatically. For manual setups, ensure FFmpeg 6.1.1 is in your PATH orbin/folder. - Spotify errors - check your
SPOTIFY_CLIENT_IDandSPOTIFY_CLIENT_SECRETin.env. - Bot offline or unresponsive - verify your
DISCORD_TOKENand bot permissions in the Developer portal.
Need more help? Check out my detailed FAQ & troubleshooting guide.
- Python & discord.py
- yt-dlp & FFmpeg
- Rich (TUI dashboard)
- aiohttp & SpotifyScraper
Bugs, features, pull requests - all welcome.
- Found a bug? Open an issue.
- Want a feature? Fork the repo and open a pull request.
- Like the project? Star the repository!
- Self-hosted only: all logs stay local to your machine. No telemetry is sent anywhere.
- MIT License - do what you want with the code, just be kind.
made with love by alan7383