Harmonica - Discord Music Bot 🎵

A self-hosted Discord bot that uses YT-DLP to play audio from YouTube, Spotify, direct links, and livestreams in your Discord voice channels.

✨ Features

🎵 Music Support

• Multi-platform support (YouTube, Spotify, direct links)
• High-quality audio streaming
• Livestream support
• Playlist support

🎚️ Playback Control

• Basic controls (play, pause, skip)
• Queue management
• Loop mode with count option
• Shuffle functionality
• Real-time track information

🎯 Smart Features

• YouTube search integration
• Spotify playlist parsing
• Genius lyrics integration
• Automatic FFmpeg setup
• Configurable auto-leave
• Download cleanup

⚙️ Administration

• Role-based permissions
• Configurable command prefix
• Detailed logging system
• Auto-updates capability

⚠️ Note: This bot is currently in development. While functional, it's recommended for use on a single private Discord server only.

⚡ Quick Start

1. Install Python 3.8+
2. Run pip install -r requirements.txt
3. Rename .env.example to .env and add your Discord token
4. Run python bot.py

🔧 Detailed Setup

Core Setup

1. Python Installation

   • Install Python 3.8 or higher
   • Verify installation: python --version

2. Dependencies

   pip install -r requirements.txt

3. Discord Bot Token

   • Rename .env.example to .env
   • Add your token:

     DISCORD_TOKEN=your_token_here
     

4. Configuration

   • Edit config.json to set:
     • Owner ID
     • Command Prefix
     • Permissions
     • Autoleave
     • Default Volume
     • Auto Clear Downloads
     • Log Level
     • UI Buttons

Optional Features

1. Spotify Integration

   • Rename .spotifyenv.example to .spotifyenv
   • Add credentials:

     SPOTIPY_CLIENT_ID=your_client_id_here
     SPOTIPY_CLIENT_SECRET=your_client_secret_here
     

   • Get credentials from Spotify Developer Dashboard

2. Genius Lyrics

   • Edit .geniuslyrics (created on first startup)
   • Add your Genius API credentials

3. YouTube Authentication

   • Install Get Cookies.txt extension
   • Export cookies and place in root directory
   • Learn more about cookies setup

🎮 Commands

Music Playback

• !play [URL/search] - Play audio from URL or search
• !search [term] - Search YouTube for a song
• !pause - Pause playback
• !resume - Resume playback
• !stop - Stop and clear queue
• !skip - Skip current track
• !replay - Replay current track
• !random - Searches for a random song on YouTube
• !loop [count] - Toggle loop mode (optional count)
• !nowplaying - Show current track info

Queue Management

• !queue - Show queue
• !clear - Clear entire queue
• !clear [position] - Remove specific track
• !shuffle - Shuffle queue

Voice Channel

• !join / !summon - Join your channel
• !leave / !disconnect - Leave channel

Lyrics & Information

• !lyrics - Get lyrics for current song

System Commands

• !alias [add/remove/list] - Manage aliases
• !ping - Show bot status
• !version - Show bot version
• !log - Log current context
• !restart - Restart bot (Owner)
• !logclear - Clear logs (Owner)
• !update - Update bot files (Owner)
• !help - Show all commands

🔍 Troubleshooting

Common Issues

• FFmpeg Issues:

  • Windows: Relaunch after first install
  • macOS: Manual placement in root directory
  • Linux: Automatic installation

• YouTube Sign-In Error/403 Error: Check/update cookies.txt

• Known Limitations:

  • ❌ Multiple server support (WIP)

📋 System Requirements

• Python 3.8+
• FFmpeg
• Stable internet connection
• Discord Bot Token