PakoDJ Bot 🎵

PakoDJ is a Discord bot written in Python that lets you play music directly in your server's voice channels. With its features, you can search for songs on YouTube, manage music queues, view playback history, and much more!

🛠️ Main Features

• Music Playback: Search and play songs from YouTube via links or keywords.
• Queue Management: Add songs to the queue and play them in sequence.
• Playback Controls: Pause, resume, or skip tracks.
• History: View previously played tracks.
• Voice Integration: Automatically connects to the voice channel you're in.
• Multi-Server Support: Each server has its own queue and playback history.

📋 Prerequisites

Before starting, make sure you have:

• Python 3.8 or higher installed.
• ffmpeg installed.
• A Discord bot token (you can obtain one from the Discord Developer Portal).
• The following Python libraries installed:
  • discord.py
  • yt-dlp
  • python-dotenv
  • PyNaCl

⚙️ Setup

1. Clone the repository:

   git clone https://github.com/Pako3549/PakoDJ.git

2. Install the dependencies:

   pip install -r requirements.txt

3. Configure the .env file: Create a .env file in the main directory and add your bot token:

   token=YOUR_BOT_TOKEN

4. Run the bot:

   python main.py

📖 Command

Command	Description
!play <query>	Plays a song searched using keywords or a link. If a song is already playing, adds it to the queue.
!skip	Skips the current track and plays the next one in the queue.
!pause	Pauses the currently playing track.
!resume	Resumes the paused track.
!track	Shows the currently playing track.
!queue	Displays the queue of tracks.
!history	Shows the history of previously played tracks.
!stop	Stops playback and disconnects the bot from the voice channel.
!djhelp	Displays the list of available commands.

🛠️ How It Works

• Search and Playback: The bot uses yt-dlp to fetch the best available audio from YouTube.
• Dynamic Management: Each server has its own queue and playback history.
• Automatic Connection: The bot automatically connects to the voice channel of the user issuing a command.

🐛 Troubleshooting

• Error: Bot is not in a voice channel
  Ensure the bot is connected to a voice channel and that you're in the same channel.
• Error during playback
  Check if the link or query is valid. For persistent issues, check the console for detailed error messages.

📜 License

This project is open-source and available under the GPL-3.0 License. See the LICENSE file for more details.