Download for Windows | Features | Visualizers | Build it yourself
ONYX plays the music already sitting on your disk and gives it something worth looking at. The visualizers read the audio as it plays, so what you see follows the track instead of looping a canned animation. Your music stays on your machine. There is no account and no library to upload to.
Features
Eight visualizers. Spectrum, particles, waveform, radial, cascade, orbits, Mirage, and timed lyrics. Press a number key to switch, or let one take the whole screen.
A big cover view. Lyrics mode can show the cover large on the left, with the title and artist under it and the lyrics scrolling on the right, over a blurred copy of the art. Click a line to jump to it.
Reads the audio properly. Frequency bands are log spaced and tilted so a normal mix looks balanced rather than bass heavy. Beat detection tracks tempo and locks to it, so the reactive modes move with the song and not with every hi-hat.
Plays what you already have. mp3, flac, wav, m4a and ogg, from any folder. Drop in files or point it at a whole music folder and it builds the library itself.
Edit tags and covers. Change the title, artist, album or cover art on any track. Your audio files are never rewritten.
Lyrics without the hassle. A song.lrc beside the song is picked up on its own. You can also drop in an .lrc,
paste text, or search for lyrics online with one button. To time them yourself, the sync mode plays the song and
stamps each line when you press Space, with undo and slower playback for the fast parts.
Metadata that travels with the song. Edits are stored beside the file, so they survive a reinstall, a rebuilt
library, or moving the folder to another drive. Export a track as one .onyxpack and whoever opens it gets the cover,
the lyrics and the tags with it.
Fits into Windows. Media keys work, and the track, artist and cover art show up in the volume flyout.
Visualizers
| Visualizer | What you see |
|---|---|
| Spectrum | Log spaced bars on a reflective floor, with peak caps that hold and fall |
| Particles | Dust drifting in the dark. The music moves it and lights it, and only the big hits make it spark |
| Waveform | The live waveform with its recent history receding behind it |
| Radial | A mirrored circular spectrum with bass at the bottom and treble at the top, around the live waveform |
| Cascade | A scrolling spectrogram of the last few seconds, with an optional colour palette |
| Orbits | One satellite per frequency band, orbiting a core that moves with the bass |
| Mirage | A landscape, the song's cover or your own image, made of dots and smoke that move with the music |
| Lyrics | Lyrics that follow the track with the current line lit, full screen or beside the big cover |
Press 1 to 8 to jump straight to one, or V to step through them.
Install
Download ONYX-Setup from the latest release and run it. It
installs for your Windows account only, so it does not ask for admin rights, and it keeps itself up to date.
The setup is not code signed, so Windows SmartScreen may say it protected your PC. Click More info and then Run anyway. Every release lists the SHA-256 of its files.
You need Windows 10 or 11, 64 bit. If you would rather not install anything, the same release has a zip you can unpack and run.
Hotkeys
| Action | Key |
|---|---|
| Play or pause | Space |
| Seek five seconds | ← / → |
| Previous or next track | Shift + ← / → |
| Volume | ↑ / ↓ |
| Mute | M |
| Shuffle | S |
| Repeat mode | R |
| Pick a visualizer | 1 … 8 |
| Next or previous visualizer | V / Shift + V |
| Immersive mode | I |
| Full screen | F |
| Show or hide the sidebar | B |
| Colour in Cascade and Mirage | C |
| Lyrics with the big cover | L |
| Previous or next Mirage picture | [ / ] |
| Edit the current track | E |
| Search | Ctrl + F |
| Close, or leave full screen | Esc |
The media keys on your keyboard work too, through Windows' own media session.
Where your files are
| What | Where |
|---|---|
| Library, settings and play state | %AppData%\ONYX\onyx-state.json |
| Tag, cover and lyric edits | <track>.onyx.json, beside the audio file |
| Cover images | %AppData%\ONYX\covers |
Tracks imported from an .onyxpack |
%AppData%\ONYX\Imported |
| The program | %LocalAppData%\Programs\ONYX (changeable during setup) |
Your audio files are never rewritten. Every edit lands in the sidecar beside them, which is why a reinstall, a rebuilt library or a move to another drive keeps your work. Uninstalling removes the program and leaves your library, settings and edits where they are.
Privacy
ONYX has no account, nothing to upload a library to, and no telemetry. It only goes online for two things:
- It asks GitHub whether a newer release exists, and fetches it when there is one.
- When you press Find lyrics, it sends the title and artist you searched for to LRCLIB, a free lyrics database. Nothing is sent until you press it.
Building
npm install
npm run dev # dev build with hot reload
npm run release # installer and zip in release/Node 20 or newer, on Windows. docs/DEVELOPMENT.md covers the architecture, how the visualizer engine is put together, and how the audio analysis is calibrated.
License
Copyright (C) 2026 slashneck. ONYX is free software under the GNU General Public License, version 3 or later: you can use, change and share it, and any version you share has to stay under the same license with its source code available.
ONYX bundles the Electron runtime and is built with React; tags are read with music-metadata. Each keeps its own license.
