Onyx

by slashneck · Audio & music

Local-only music player with a black and white reactive visualizer.

✓ VerifiedOpen source · GPL-3.0Unsigned↓ 653 downloads★ 0 on GitHubNo ratings yetWindows

About

ONYX

Latest release Downloads Windows 10 and 11 GPL 3.0

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.

Patch notes

ONYX 1.1.0

3 Nov 2026

Lyrics are far less work to set up, covers are bigger and in colour, and three visualizers are new or rebuilt.

Install: download ONYX-Setup-1.1.0.exe and run it. If you already have ONYX installed, it updates itself. Prefer not to install? ONYX-1.1.0-win-x64.zip runs as is.

The setup is not code signed, so SmartScreen may warn on first run. Click More info, then Run anyway.

New

  • Mirage replaces the VU meter: a landscape, the song's cover or your own image, made of dots and smoke that move with the music. Switch pictures with [ and ].
  • Big cover view in Lyrics mode: the cover, title and artist on the left, lyrics on the right, over a blurred copy of the art. Press L, or click the cover in the player bar. Click a line to jump to it.
  • Keyboard lyric sync: the song plays and Space stamps each line. Includes undo and slower playback.
  • Easier lyrics: a song.lrc beside the song is picked up automatically, and you can drop in an .lrc or paste text. Lyrics without timings now show in the Lyrics view.
  • Find lyrics: an optional button that searches LRCLIB.

Changed

  • Radial no longer spins. Bass is at the bottom, treble at the top, mirrored, with the real waveform in the middle.
  • Particles is now calm drifting dust. The music moves and lights it, and only the big hits make it spark.
  • Album covers are in colour and kept at full resolution. They now live in their own files, so the app stops rewriting megabytes of image data while it plays.

Fixed

  • Lyrics where only some lines had timings lost the untimed lines when you opened the editor.
  • Line breaks in plain lyrics were lost when saved beside the song or exported.
  • Revert to file tags left old values in the editor.
  • Show in folder didn't work.
  • A visualizer that crashed stopped every visualizer until the app was restarted.

Privacy

Find lyrics sends the title and artist you searched for to LRCLIB, and only when you press it. Apart from that, ONYX only goes online to check GitHub for updates. There is still no account and no telemetry.

SHA-256

a390067b8e20f10871417e8d5420ff275b358d4b76241837c3b482b13eaa8d2c  ONYX-Setup-1.1.0.exe
be116f07864aa2ce01046621f9f10c1ef280a5569cdec1072470605a1796aa37  ONYX-1.1.0-win-x64.zip
All releases on GitHub ↗

Ratings & comments

No ratings yet. Be the first to rate it.

Sign in to rate:

No comments yet. Be the first to say how it ran.