tobysmyki/musicbot repository overview

⁠Toby's Music Bot

Hello there! I hope you will find a good use to self-hosted music bot. Cookie auth through file will be added along with the next major release, minor versions are focused on QoL and bugfixes. Full roadmat for the extension - without expected delivery - listed at the bottom.

In order to have sucessfully working playback you have to create your own bot through developer portal. There you need only intent of speaking and joining, then in the guild settings create permission group for the bot allowing it to see the specified voice channels + permission to join and speak. No other permissions are required.

⁠Run [latest-dev]

docker run -p 5000:5000 -e DISCORD_BOT_TOKEN=tokenValue -v host/cookieFile.txt:/data/cookies.txt tobysmyki/musicbot:latest-dev

⁠Run [latest]

docker run -p 5000:5000 -e DISCORD_BOT_TOKEN=tokenValue tobysmyki/musicbot:latest

⁠Access dashboard

open http://localhost:5000⁠

⁠Environment variables

DISCORD_BOT_TOKEN=your_token_here
YTDLP_COOKIES=/data/cookies.txt

⁠STORAGE BACKEND OPTIONS (choose ONE)

Option A: SQLite (default, no external deps)
SQLITE_PATH=/data/bot.db

Option B: Redis (for multi-instance setups)
REDIS_URL=redis:6379/0 # Docker service
REDIS_URL=localhost:6379/0 # Local
REDIS_URL=1.2.3.4:6379/3 # Remote
REDIS_URL=redis://user:pass@host:6379/3 # With auth

⁠Misceleanous

WEBUI_PORT=5000

⁠Acknowledgments

This codebase was generated with assistance from AI agents to bridge my knowledge gap in Python development. Infrastructure, design and QA were managed manually.

⁠Roadmap

⁠release 2026.2:

• add support for cookies from external file, eg. cookies.txt which is natively supported by yt-dlp from pypi
• add support for loading playlists from youtube

⁠release 2026.3:

• add support for soundcloud

⁠release 2026.4:

• add support for spotify (if possible)

⁠release 2026.5:

• switch to production backend gunicorn
• removal of most of the DEBUG traces from the code to not spam log (?)

⁠Known issues / bugs

• skip does double-skip instead of skipping single item (fixed in 2026.1a / latest-dev)
• non-working error log console (fixed in 2026.1a / latest-dev)
• non-working playback history console

⁠Supporting the Project

If you find this useful, donations help fund my ongoing studies in software engineering so I can take over this codebase fully in the future.
[https://ko-fi.com/tobychee⁠]