Telegram Web Room & Mini App

SolsticeIO features a web dashboard and Telegram Mini App with live lyrics, queue management, and playlist curation.

---

Accessing the Web Room

You can launch the Web Room via:

1. Telegram Mini App: Tap the Web Room button on any now-playing card, or send /web or /room in your group chat. The room opens directly inside Telegram with full touch controls and automatic authorization.

Note: The Web Room functions as an interactive visual controller. Audio streams directly inside your Telegram group voice chat, so listeners should join the voice chat to hear the music.

---

Key Features

1. Real-Time Playback Controls

• Responsive Controls: Pausing, seeking, resuming, or skipping tracks updates the UI for all connected listeners within milliseconds.
• Live Listener Count & Avatars: See everyone currently listening in the voice chat directly on the web interface.

2. Live Lyrics

• Karaoke LRC lyrics powered by LRCLIB.
• As the artist sings, the active line highlights and auto-scrolls smoothly, giving you a karaoke-style experience.
• Supports fallback to full plain lyrics when time-stamped lyrics are unavailable.

3. Interactive Queue Controls

• Seek Scrubber: Jump directly to any timestamp in the song.
• Queue Reordering: View upcoming songs and reorder or remove tracks you requested.
• Playback Toggles: Toggle loop, shuffle the queue, or adjust playback volume on the fly.

4. Playlist Manager

• Open the built-in playlist manager to manage your personal songs without leaving the room.
• Save the currently playing song to any playlist with one tap on the heart icon.
• Create, rename, or delete playlists (up to 10 playlists, 200 songs each, for 2,000 total songs per user).
• Tap Play on any playlist to immediately begin streaming it into your group's voice chat.
• Search YouTube directly from the web drawer and add songs with a single tap.

---

Security & Permissions

SolsticeIO uses a permission system that keeps playback safe while remaining easy for friends to join:

Verified Telegram Members

When opened inside Telegram:

• Your Telegram identity is verified directly through Telegram.
• Members can manage the songs they requested, while group admins and DJs enjoy full playback control.

Read-Only Guest Mode

When visitors join via external links:

• Guests connect in Read-Only Mode.
• They can view live lyrics and watch the queue progress.
• Mutating actions (pause, skip, seek, clear) are protected to prevent unauthorized disruptions from external visitors.