====== 🎵 Discord Music Bot – Installation & Usage ======

This bot plays ambient lo-fi music automatically in your Discord voice channel. It starts with shuffle, continues playing without stopping, and can be controlled via simple commands.

===== 📦 Requirements =====
  * Python 3.10 or newer
  * FFmpeg installed (`sudo apt install ffmpeg`)
  * A Discord Bot Token
  * MP3 files placed in the `music/` directory
  * Optional: systemd for autostart on boot

===== 🛠️ Installation =====
  * Clone or copy the bot code into a directory, e.g. `/var/www/mbot/`
  * Create a `music/` folder and add your MP3 tracks
  * Install required Python packages:
    `pip install discord`

===== 🔐 Insert Your Bot Token =====
Open `.env` and replace:
<code>`your-bot-token-here`</code>
with your actual Discord bot token.

===== 🤖 Creating a Discord Bot =====
  * Go to https://discord.com/developers/applications
  * Click **New Application**, give it a name
  * Go to **Bot** tab → click **Add Bot**
  * Under **Privileged Gateway Intents**, enable:
    - Message Content Intent
    - Server Members Intent
  * Copy the token and paste it into `bot.py`

===== 🔗 Invite the Bot to Your Server =====
Go to the **OAuth2 → URL Generator** tab:
  * Scopes: `bot`
  * Bot Permissions:
    - Connect
    - Speak
    - Send Messages
    - Read Message History

Copy the generated URL and open it in your browser to invite the bot.

===== 🚀 Bot =====
Now available on github!

[[https://github.com/JoranJix/discord-musicbot|discord-musicbot]]