Installing it
Unzip the archive and you have two ways in: run it from the folder, or install it. Both use the same files and the same runtime, and neither needs an administrator.
What you need
- Windows 10 or 11, 64 bit. Nothing else.
- About 400 MB of disk: the archive is 165.7 MB, and it unpacks to roughly 390 MB.
- No administrator rights, no service, no driver, no runtime to install separately, and no account of ours to create.
Run it from the folder
Unzip the archive anywhere and double-click run.cmd. The app starts from that
folder: nothing is copied, nothing is installed, and the only thing written outside it is what
the app keeps wherever it runs, in %APPDATA%\Ondographics.
The one thing a folder run does not have is a Start menu entry, and with it the taskbar icon, because Windows draws that button from a shortcut. Ask for one if you want it:
| Command | What it does |
|---|---|
run.cmd | runs the app, installing nothing |
run.cmd -Shortcut | a Start menu entry, and the taskbar icon with it |
run.cmd -Shortcut -Desktop | and one on the Desktop |
run.cmd -Remove | removes those again |
A shortcut belongs to the build rather than to the folder, and an identity can only have one
holder, so -Shortcut from a folder run replaces an installed copy of the same
build's Start menu entry. Running one build two ways is not meant to be kept side by side.
Install it
Double-click install.cmd. It installs for the current user only:
%LOCALAPPDATA%\Programs\Ondographics\app\ the app and the stock Electron runtime
%APPDATA%\Ondographics\ settings, logs, the queue (kept on uninstall)
You get a Start menu entry, a Desktop entry, and an entry in Apps & features.
Anything you type after install.cmd is passed to the script beside it, so the
options below work from a prompt:
| Option | What it does |
|---|---|
-InstallDir <path> | install somewhere else |
-Desktop | also create a Desktop shortcut (the default) |
-NoShortcuts | install the files only |
-NoLaunch | do not start the app afterwards |
-Quiet | no transcript, no prompts |
Only one copy runs at a time, whichever folder it came from: the app holds a single-instance lock on its settings folder, so starting a second copy brings the running one's window to the front instead.
Uninstalling
Apps & features in Windows Settings. Uninstalling is deliberately not offered
in the Start menu, where a mis-click would throw the install away. Your settings and the account
you signed in with are left alone; -PurgeData removes those too, if you want a clean
slate.
What Windows may ask
The honest answer is less comforting than the marketing one, so here it is plainly. The Electron runtime this app runs on is not code-signed, so Windows has no way to know who made it. What the installer does instead is clear the "downloaded from the internet" mark from everything it unpacks, including the scripts, which is what actually produces the first-run dialog. A file without that mark does not get asked about.
Two things follow from that. First, if Windows asks about install.cmd or
run.cmd because they arrived in a downloaded folder, choose Run.
Second, there is no self-extracting setup program in this download on purpose: that would be an
unsigned .exe, and Smart App Control refuses those outright on a machine that
enforces it. The archive has no wrapper for it to refuse, and installing the same app, to the
same place, with the same shortcuts.
Checking the download
The archive's SHA-256 is published on the download page, and the download page checks it for you before handing over the file. To check it yourself after the fact, open a Command Prompt where the file landed:
certutil -hashfile Ondographics-1.11.8-portable.zip SHA256
The line it prints should match the checksum on the download page, character for character.
Next
The manual is the app's own README and covers the tray, the overlay, song requests and the visualiser in detail. The hub explains the catalogue, and saving songs covers the one thing the public build does not carry.