Repository navigation
Tools
Derrik Diener edited this page Jul 16, 2026
·
1 revision
Beyond the main web and Subsonic interfaces, the Supernova repository contains built-in tools for advanced users and administrators.
Located in the supernova-cli/ directory, sn is a Go-based command line interface for interacting with your Supernova server directly from the terminal.
- Control playback (play, pause, skip) if the web UI is active (via WebSockets/IPC).
- Trigger library scans manually.
- Kick off background plugin jobs.
- (Planned) FUSE mounts: Future versions of the CLI will allow you to mount your remote Supernova library locally using FUSE, letting your OS treat it like a local hard drive.
Located alongside the CLI, supernova-gui.py is a lightweight Python-based desktop application.
- Designed as a minimalist, native desktop wrapper.
- Uses system media keys seamlessly without relying on a browser window.
- Lightweight alternative for users who want a native window experience without installing Electron.
Docker configurations (docker-compose.yml) and automated migration tools reside in the root directory to make deploying the core server, database, and plugins a one-command operation.