Musipy v2

A modern, stable Discord music bot built with disnake and mafic (Lavalink client).

Current Features

✅ Implemented

• Automatic Lavalink detection & startup — Bot checks if Lavalink is running; if not, automatically starts it locally (configurable via env vars)
• Node pool management — Full integration with mafic's NodePool for robust music node handling
• Utility commands:
  • /ping — Latency check
  • /uptime — Bot uptime tracker
  • /nodes — View connected music nodes status
  • /player — Current player status with track info, queue length, volume, and filters
• Cog-based architecture — Modular design for easy command expansion
• Comprehensive logging — Structured logging for debugging and monitoring
• Environment-based configuration — Support for .env variables (LAVALINK_HOST, LAVALINK_PORT, LAVALINK_PASSWORD, LAVALINK_AUTO_START, DISCORD_TOKEN)

🎯 Architecture Highlights

• Uses AsyncIO for concurrent operations
• YAML-based Lavalink config with Python fallback to env vars
• Auto-reconnection & health checks for Lavalink availability
• Clean separation of bot logic and music node management

Setup

Prerequisites

• Python 3.11+
• Java (for local Lavalink running)
• Discord bot token

Installation

python -m venv .venv
.venv\Scripts\activate
pip install -U disnake mafic pyyaml

Configuration

1. Set environment variables:

   $env:DISCORD_TOKEN = "your-token-here"
   $env:LAVALINK_AUTO_START = "true"
   $env:LAVALINK_HOST = "127.0.0.1"
   $env:LAVALINK_PORT = "2333"
   $env:LAVALINK_PASSWORD = "youshallnotpass"

2. Update application.yml with your Lavalink config (template provided)

3. Run:

   python main.py

Roadmap

TODO

• Audio playback commands (play, pause, skip, queue)
• Search integration (YouTube, Spotify)
• Playlist management
• Equalizer & filter presets
• Web dashboard (optional)

Project Links

• Lavalink Server
• mafic Documentation
• disnake Documentation