← Back to Interwave

Docs & help

Everything you need to get the most out of Interwave. Last updated: 2026-05-15

Getting started

Interwave is a free desktop music player built on Tauri 2. Windows builds are shipping today; macOS and Linux are close behind. Head to the latest release on GitHub, grab the installer for your platform, and run it. The Windows installer is signed, so SmartScreen should not get in your way.

Signing in is optional. The player works fully offline-of-account: you can search, play, build playlists, tweak the EQ, and use every local feature without ever creating an account. Signing in unlocks friends, playlist sharing, and a persistent support ticket history. You can sign up from Settings → Account at any time.

The search bar lives at the top of the window. Start typing — results come back grouped by tracks, artists, and albums. Click any track to start playback. On the first listen for a given track the audio buffers in roughly one to three seconds while the yt-dlp sidecar resolves the stream URL; subsequent plays in the same session come straight from cache and start instantly.

Right-clicking a result gives you the usual menu: play next, add to queue, add to a playlist, like the track, or jump to the artist page. The queue view at the bottom of the window shows what's playing now and what's coming up — drag rows to reorder, hit Delete to remove.

Library & playlists

Every track you tap the heart on lands in Liked Songs, the always-on playlist pinned at the top of the sidebar. Create more playlists with the + button under the sidebar header — name them whatever you want, pin the ones you use most.

To add a track to a playlist, drag it from any list directly onto a playlist in the sidebar, or right-click and pick Add to playlist. Playlists are stored in a local SQLite database on your machine — they are yours forever, they work without the internet, and nothing about them is shared anywhere unless you explicitly hit Share.

Friends

Open Settings → Account and set a display name — this is how other people will find you. From the Friends page, send a request by display name. The other person has to accept it before you appear in each other's lists; you can cancel a pending request at any time.

Online friends and the track they are currently playing show up live in the sidebar. The whole thing runs on a Supabase Realtime channel — no polling, no refresh button, your friends light up the instant they press play.

Sharing playlists

Right-click any playlist in the sidebar and pick Share. Interwave uploads a snapshot of the playlist (name, cover, ordered list of YouTube IDs) and copies a link of the form interwave.cc/p/<token> to your clipboard.

Anyone with the link can preview the snapshot in their browser, or paste the token into the app's import dialog to clone the playlist into their own library. Snapshots are static — they don't update if you edit the original playlist later. Share again to publish a fresh version.

EQ & audio

Open Settings → Audio for the audio controls. The five-band equalizer covers 60 Hz, 250 Hz, 1 kHz, 4 kHz, and 16 kHz, each adjustable by ±12 dB. Save your favorite curves as named presets and switch between them with a click.

The crossfade slider blends the tail of one track into the head of the next, anywhere from 0 to 12 seconds. Volume normalization is on by default — Interwave estimates a per-track gain so quieter songs don't get drowned by loud ones in the same queue.

Lyrics

When a track starts playing, Interwave fetches lyrics from LRCLIB in the background. If a synced LRC file exists, the active line is highlighted in real time as the song plays; click any line in the lyrics panel to seek to that timestamp instantly. Static lyrics still render, just without the highlight.

Keyboard shortcuts

Updates

Interwave checks for new releases every five minutes in the background. When a newer version is available, a small prompt slides in from the bottom-right corner; click Restart and the updater swaps in the new build and relaunches. You can trigger a manual check anytime from Settings → About.

Troubleshooting

Privacy & data

The short version: everything that can live locally, does. Playlists, listening history, settings, and crash diagnostics all sit in a local SQLite database on your machine. The Supabase backend only ever touches auth, friends, shared playlist snapshots, and support tickets. The full breakdown is on the privacy page.

Open source & contributing

Interwave is MIT licensed and developed in the open at github.com/Cloaxyyy/wave. Pull requests are welcome — bug fixes, new features, translations, all of it. Bugs, feature requests, and discussions live on the GitHub issue tracker.

Getting help

The fastest path is the Support page inside the app: it files a ticket directly to the team and you can attach diagnostics with one checkbox. For public issues — bug reports, feature ideas — open a GitHub issue. For anything else, email support@interwave.cc.