Features Showcase ✨

SolsticeIO is the cutest Telegram music and video streaming bot, designed from the ground up for speed, visual beauty, and uncompromising audio quality.

---

Studio-Grade Voice & Video Streaming

SolsticeIO streams audio and video directly into Telegram voice chats with zero audio lag and broadcast-level quality:

• Studio Opus Audio: Streams native Opus stereo audio at Telegram's maximum supported bitrate (up to 48kHz / 128kbps stereo) with zero lossy transcoding or artificial downsampling.
• 1080p 60 FPS Video: Crisp, smooth video streaming for concerts, music videos, and live broadcasts with automatic aspect-ratio preservation.
• Native Low-Latency Engine: Uses in-process WebRTC streaming directly in the Go runtime.
• Seamless Track Transitions: Intelligent background stream prefetching resolves the next track before the current song finishes, ensuring seamless music flow without silent pauses.

---

Beautiful Web Room & Telegram Mini App

Transform your voice chat into a music room with SolsticeIO's built-in Web Room:

• Real-Time Synchronization: Sub-second state synchronization keeps progress bars, track metadata, and playlist queues aligned across all listening devices.
• Live Lyrics: Time-synced lyrics scroll smoothly in real time matched to the vocalist's timing, powered by LRCLIB.
• Interactive Controls: Play, pause, seek anywhere with the progress scrubber, adjust volume, toggle shuffle, or skip tracks directly from your browser.
• Live Listener Avatars: See everyone currently tuned into the voice chat in real time.
• Telegram Mini App Ready: Open the player directly inside Telegram as an official Mini App with 1-tap native authentication.
• Read-Only Guest Mode: Guests can view the queue and listen while write actions stay protected.

---

Personal Playlists

Create and manage your personal music library directly inside Telegram or via the Web Room:

• Generous Cloud Storage: Create up to 10 distinct playlists per user, holding up to 200 songs each - giving you a total storage capacity of 2,000 songs.
• 1-Tap Voice Chat Playback: Stream an entire playlist into your group voice chat with a single command (/playlist play <name>) or 1-tap web button.
• Instant Song Saving: Love the currently playing track? Save it to any of your playlists with one tap from the web room.
• Public & Private Sharing: Keep your playlists private or make them public so friends can stream your playlists in their own groups.

---

Smart Autoplay

Never let the music stop when your queue runs out:

• YouTube Music: When manual requests end, SolsticeIO's smart autoplay engine analyzes recent songs and automatically queues contextually relevant songs from YouTube.
• Context-Aware Recommendations: SolsticeIO builds a dynamic listening graph based on artist, genre, and tempo to deliver a cohesive radio experience.
• Music Discovery (/suggest): Explore songs by genre or search query with inline buttons to quickly add them to the queue.

---

Universal Music Source Resolution

Play virtually anything instantly without worrying about formats or links:

• YouTube Music & Video: High-speed streaming from song titles, video URLs, and playlist links.
• Spotify Integration: Instant resolution for Spotify tracks, full albums, and public playlists.
• Direct Telegram Files: Reply to any audio file, voice note, or video file inside Telegram with /play or /vplay to stream it immediately.
• Smart Fallback Engine: Multi-tiered search fallback ensures playback continues even if one provider experiences temporary rate limits or throttling.

---

7-Tier Permission Hierarchy & Vote Skipping

Designed for peaceful group listening without power struggles:

• Granular Role Hierarchy: $$\text{Owner} > \text{Bot Staff} > \text{Group Admins} > \text{DJ Users} > \text{Song Requester} > \text{Members}$$
• Requester Freedom: Users can pause, seek, loop, or skip the songs they requested without needing group admin rights.
• Community Vote Skipping: When regular listeners want to skip a track, SolsticeIO initiates an interactive in-chat vote. Once the configurable listener threshold is met (default: 3 votes), the song skips automatically.
• Dedicated DJ Mode (/dj): Group admins can designate trusted music curators as DJs, giving them full playback control without granting them moderation powers over the group.

---

Advanced Group Moderation

SolsticeIO doubles as a robust group management bot:

• Full Moderation Suite: Ban, temporary ban (/tban), mute, kick, promote, pin, and warn users.
• Stealth Flags (-s and -d):
  • Add -s to any moderation command (e.g. /ban @user -s) to execute silently without posting chat announcements.
  • Add -d to any moderation command (e.g. /ban -d in reply) to instantly purge the offending spam message.
• Automated Strike Enforcement: Set custom warning mode thresholds (/setwarnmode [ban|mute|kick]). Persistent rulebreakers are penalized automatically.
• 3-Strike Anti-Flood Defense: Intelligent sliding-window rate limiting detects command spammers, warns them progressively, and permanently bans persistent abusers.

---

AI Voice & Text-to-Speech

Give your group a lifelike voice:

• Smallest.ai Lightning v3.1 Pro: Ultra-low latency, crystal-clear female Hinglish and multilingual text-to-speech synthesis.
• Native Telegram Voice Notes: Generated speech is transcoded on the fly into native Telegram Opus voice notes.
• Automatic Fallback: Graceful fallback to Google Translate TTS ensures continuous speech generation even during API outages.

---

Encrypted Inline Secret Whispers

Send private, confidential messages directly inside public group chats:

• Recipient-Locked Encryption: Only the sender and the designated recipient can decrypt and read the message; everyone else sees a locked button.
• One-Time Self-Destruct: Optional burn-after-reading mode automatically purges the whisper permanently after the recipient reads it once.
• Auto-Expiring State: Database TTL indexes automatically clean up old unseen whispers after 30 days to protect user privacy.

---

Multi-Language Localization

SolsticeIO speaks your language:

• Native Multilingual Support: Full interface and response localization in English, Spanish, Hindi, and many more.
• Per-Group Language Toggles: Set different languages for different international communities using /language.