🌸 Shinobu — High-Fidelity Music & Community Audio Bot

Shinobu is built for servers that want music to sound clean and keep playing: 48 kHz voice output, automatic multi-node recovery, studio DSP, and a complete request channel from one command.

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
• Documentation: https://docs.shinobubot.pro

Frequently Asked Questions (FAQ / SSS)

Q: Is Shinobu free to use?
A: Yes. Essential playback features, queue management, lyrics lookup, personal favorites, curated radio stations, and core audio filters are completely free. Optional supporter perks and dedicated server resources are available for donors.

Q: Which audio sources are supported?
A: Shinobu supports YouTube, Spotify tracks/playlists/albums, SoundCloud, Apple Music, Deezer, and direct internet radio streams.

Q: What happens if an audio node goes down?
A: Shinobu monitors connection health continuously. If an audio node experiences degradation, the playback coordinator seamlessly migrates your session to an available backup node without interrupting your queue.

Q: How do I set up the dedicated song request channel?
A: An administrator can simply run /setup action:Create. Shinobu creates a dedicated #🎵・song-requests channel with an interactive controller. Any song title or link typed in that channel will automatically enqueue and delete the trigger message to keep chat tidy.

Q: How does the Weekly Community Music Digest work?
A: Every Monday, Shinobu aggregates all music played in your server over the previous 7 days and posts a compact recap card highlighting the top 3 songs, top artist, and top DJ of the week. Server administrators can change the channel or toggle this feature at any time with /community digest.