Skip to content

Latest commit

 

History

History
134 lines (92 loc) · 4.15 KB

README.md

File metadata and controls

134 lines (92 loc) · 4.15 KB

🎵 KenKonic - Discord Music Bot

KenKonic is a powerful and feature-rich Discord bot that plays music from YouTube, YouTube Playlists, and Spotify links. It supports modern slash commands, queues, and has intelligent Spotify-to-YouTube conversion via search.

🚀 Features

  • ✅ Slash command interface (Discord API v10)
  • ✅ Play music via:
    • YouTube search terms
    • YouTube video or playlist URLs
    • Spotify track, album, or playlist links
  • 🎧 Queue system with priority support (/playnext)
  • 🎵 Supports pause/resume/skip/stop
  • 🔊 Plays high-quality audio via FFmpeg
  • 🦅 Includes a fun /geier command

🛠 Requirements

  • Python 3.10+
  • A Discord Bot Token
  • FFmpeg installed and in PATH
  • Spotify API credentials (for Spotify support)

📦 Installation

  1. Clone the repository:

    git clone https://github.com/YOUR_USERNAME/YOUR_REPO_NAME.git
cd YOUR_REPO_NAME

  2. Install the dependencies:

    pip install -r requirements.txt

    Make sure ffmpeg is installed and accessible from your command line.

  3. Create a .env file or set these variables in your script:

    DISCORD_TOKEN=your-discord-token
SPOTIFY_CLIENT_ID=your-client-id
SPOTIFY_CLIENT_SECRET=your-client-secret

    Or hardcode them in your Python file:

    SPOTIFY_CLIENT_ID = 'your-client-id'
SPOTIFY_CLIENT_SECRET = 'your-client-secret'
bot.run('your-discord-token')

📚 Commands

Command Description
/join Join your current voice channel
/leave Leave the voice channel
/play [url/query] Play music via YouTube, Spotify, or a search term
/playnext Queue a song to play immediately after the current
/pause Pause the current song
/resume Resume the paused song
/skip Skip the current song
/stop Stop playback and clear the queue
/queue Show the current queue
/geier Just... see for yourself 😅
/help Show help message

🧠 How Spotify Support Works

When you input a Spotify track, album, or playlist link, the bot uses the Spotify API to retrieve song titles and artists, then searches YouTube for playable matches using yt-dlp.

  • Only the first 15 tracks are queued for albums/playlists (can be adjusted).
  • Purely search-based: there’s no direct streaming from Spotify.

🐞 Troubleshooting

  • Nothing plays?

    • Make sure your bot has permission to join and speak in the voice channel.
    • Check that FFmpeg is correctly installed.

  • Spotify errors?

    • Double-check your client ID/secret.
    • Ensure the Spotify API is accessible.

  • Command not working?

    • Use / to see registered commands.
    • Try restarting the bot to re-sync slash commands.

🧑‍💻 Credits

📜 License

MIT License. Free to use, modify, and share.

⚠️ Disclaimer

This project is intended for educational and personal use only.

  • This bot does not stream music from Spotify. It only uses the Spotify Web API to retrieve public metadata (track name, artist).
  • Audio is played using YouTube via yt-dlp.
  • Please make sure to comply with the Terms of Service of Discord, YouTube, and Spotify.
  • The author does not take any responsibility for misuse or violations of platform rules.

❤️ Support

Give the repo a ⭐ if you like it!
Made with 💡