Skip to main content

​
Getting Help

If you need assistance with MusicBot, have questions, or want to report issues, there are several ways to get in touch.

​
Contact Information

​
Author

SpyFlow

​
Discord

  • Username: spyflow
  • User ID: 533093302031876096
  • Direct Link: Discord Profile

​
GitHub

​
Email

​
Reporting Bugs

If you encounter a bug or issue with MusicBot, please report it on GitHub:
  1. Check existing issues first to see if the problem has already been reported
  2. Open a new issue at github.com/spyflow/musicbot/issues
  3. Provide detailed information:
    • Description of the issue
    • Steps to reproduce the problem
    • Expected behavior vs. actual behavior
    • Error messages or logs (if applicable)
    • Your environment (OS, Python version, dependencies)

​
Example Bug Report

**Issue**: Bot crashes when using !play command

**Steps to Reproduce**:
1. Join a voice channel
2. Run command: !play <YouTube URL>
3. Bot disconnects and logs error

**Expected Behavior**: Bot should play the song

**Actual Behavior**: Bot crashes with error: [paste error here]

**Environment**:
- OS: Ubuntu 22.04
- Python: 3.10.12
- discord.py: 2.3.2

​
Feature Requests

Have an idea for a new feature? We’d love to hear it!
  1. Open an issue on GitHub with the “enhancement” label
  2. Describe the feature you’d like to see
  3. Explain the use case and why it would be valuable
  4. Provide examples if applicable
Alternatively, you can implement the feature yourself and submit a pull request! See the Contributing page for more information.

​
Common Issues

​
Bot won’t connect

  • Verify your DISCORD_BOT_TOKEN is correct in the .env file
  • Check that the bot has been invited to your server with proper permissions
  • Ensure you’ve enabled the required intents in the Discord Developer Portal

​
YouTube playback issues

  • Verify your YOUTUBE_API_KEY is valid
  • Check that ffmpeg is installed on your system
  • Ensure the video is not region-locked or private

​
Voice connection problems

  • Make sure you have the pynacl library installed
  • Check your network connection and firewall settings
  • Verify the bot has permissions to connect and speak in voice channels
For more troubleshooting help, see the Troubleshooting guide.

​
Open Source Project

MusicBot is an open-source project licensed under CC BY-NC-SA 4.0 (Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International). This means:
  • The source code is freely available to view and modify
  • You can use it for non-commercial purposes
  • Contributions from the community are welcome
  • Support is provided on a best-effort basis

​
Community Support

As an open-source project, support relies on community involvement:
  • Help answer questions on GitHub issues
  • Share your solutions and workarounds
  • Contribute bug fixes and improvements
  • Update and improve documentation
Your participation helps make MusicBot better for everyone!

​
Response Time

Please note that as this is a community-driven open-source project, response times may vary. We appreciate your patience and understanding. For urgent issues, consider:
  • Checking the documentation for solutions
  • Searching existing GitHub issues
  • Reviewing the source code in bot.py
  • Reaching out through multiple contact channels

Build docs developers (and LLMs) love

Get started for freeTalk to us