Nirvana

Nirvana — A Quality Music Bot that Makes You Feel the Music and its Beats.
Your go-to bot for instant tunes, harmonic brilliance, and personalized playlists.

Invite Nirvana · Join Support Server

---

🌟 Features

• 🎧 Crystal Clear Audio Quality
• 🎵 Supports Multiple Platforms – YouTube, Spotify, SoundCloud, etc.
• 🛠️ Slash Command & Context Menu Support
• 🪄 Smart AutoPlay & 24/7 Mode
• 💾 Playlist Creation & Management
• 🌐 Multi-language Support
• 🎛️ Advanced Filters (Bass Boost, Nightcore, Vaporwave, etc.)
• 🔒 Owner & DJ Role System
• ⚙️ Lightweight, Fast & Easy Setup

---

🧠 Requirements

• Latest LTS Node.js
• Lavalink v4+

Optional

• MongoDB (for persistent playlists/settings)
• Docker (for container deployment)

---

🚀 Installation from Source

1. Clone the Repository

git clone https://github.com/abhay/Nirvana.git

2. Enter the Directory

cd Nirvana

3. Install Dependencies

npm install

4. Configure Environment

Copy .env.example to .env:

TOKEN=your_discord_bot_token
PREFIX=!
OWNER_ID=your_discord_user_id
LAVALINK_HOST=localhost
LAVALINK_PORT=2333
LAVALINK_PASSWORD=youshallnotpass

5. Run the Bot

npm start

6. Invite Nirvana to Your Server

Invite Link

---

🐳 Docker Installation

1. Prepare the .env file.
2. Run:

docker compose up -d

To update:

docker compose up --force-recreate --build -d
docker image prune -f

---

💬 Commands Overview

Command	Description
/play <song>	Play a track from any source
/skip	Skip current track
/queue	View queue
/pause	Pause playback
/resume	Resume playback
/stop	Stop all playback
/filter <type>	Apply a filter
/24_7	Toggle 24/7 mode

---

📢 Support

Join our Discord: https://discord.gg/R35fpSXCR3

Or open an issue: https://github.com/abhay/Nirvana/issues

---

🧩 Technologies Used

• Node.js
• Discord.js
• Lavalink
• Shoukaku / Kazagumo
• MongoDB
• Docker

---

👨‍💻 Contributing

1. Fork the repo
2. Create a branch: git checkout -b feature/AmazingFeature
3. Commit changes
4. Push: git push origin feature/AmazingFeature
5. Open a PR

---

⚖️ License

Distributed under the MIT License.

---

💖 Thank you for choosing Nirvana!

Taste the Opulence of Harmonic Brilliance 🎶