🌸 Shinobu — High-Fidelity Music & Community Audio Bot

Shinobu provides studio-grade lossless audio playback, resilient multi-node streaming infrastructure, and community-centric music statistics for Discord servers.

Built from the ground up for measurable stability, intuitive first-minute onboarding, and rich listening identity.

---

⚡ Quick Start

• /play <song name or URL> — Stream immediately from YouTube, Spotify, SoundCloud, Apple Music, Deezer, and direct streams.
• /setup — Generates a dedicated text-to-play channel with an interactive button controller.
• /radio <genre> — 24/7 continuous broadcast across 16 curated genre stations (Lo-Fi, Synthwave, Anime, Rock, Jazz, Ambient, etc.).
• /community preview — Preview your server's weekly top songs and listening highlights.
• /help — Browse categorized commands and audio settings.

---

🎧 Why Shinobu?

1. Measurable Voice Reliability & Multi-Node Failover

Shinobu operates on a distributed multi-node architecture (NodeLink / Lavalink). If an audio node experiences latency or disconnects, the connection coordinator immediately migrates your voice session to a healthy backup node within milliseconds—preventing dropped tracks.

2. Studio-Grade Audio Processing

• EBU R128 Loudness Normalization: Automatically evens out volume discrepancies between quiet acoustic tracks and loud masters with zero manual adjustment.
• Dynamic Compression & Peak Limiter: Prevents audio clipping and distortion even at high playback volumes.
• Real-Time DSP Filters: Bass+ Boost, Nightcore, Vaporwave, 8D Binaural Spatial Audio, Treble Boost, LowPass, and Pitch Shift.

3. Community Music Identity

• Weekly Server Music Digest: Posts a weekly community recap card showing your server's top 3 songs, top artist, top DJ, and total listening hours every Monday.
• Community Milestone Celebrations: Automatically recognizes server milestones (100, 500, 1,000, 10,000 songs played; 100 hours listened) with clean celebration cards.
• Server Music Wrapped (/server-stats): Detailed listening heatmaps, top DJ leaderboards, and genre distribution charts.

4. Dedicated Request Channel (Text-to-Play)

Run /setup to generate a dedicated #🎵・song-requests channel. Users can simply type a song name into the chat without slash commands to add it to the queue, while the pinned interactive player card displays track progress and playback controls.

5. Generous Free Tier

Core music playback is completely free:

• Full queue management (/play, /skip, /queue, /shuffle, /loop, /seek, /replay).
• Full lyrics lookup (/lyrics).
• Personal favorites (/favorites, /favorites_play).
• Curated radio stations (Lo-Fi, Synthwave, Anime, Chill).
• Essential DSP audio filters (Bass+, Nightcore, Vaporwave).

---

📋 Technical Specifications

• Audio Output: 48kHz / 16-bit stereo PCM via Opus.
• Gateway & Architecture: Node.js v20+, discord.js v14, hybrid sharding.
• Database Engine: Multi-database support (MySQL / MongoDB) with Redis state caching.
• Supported Languages: 13 languages including English, Turkish, German, Spanish, French, Japanese, Russian, and Arabic.

---

🔗 Official Links

• Website: https://shinobubot.pro
• Support Server: https://discord.gg/pmuYMKE8CY