Get started
Introduction
What Nuvo is, what it keeps on your machine, and where its music comes from.
Nuvo is a desktop music player for Linux, Windows and macOS. Linux is the main platform, and Windows and macOS are fully supported. It keeps your library, playlists, likes and listening history on your own computer. There is no Nuvo account and no Nuvo server.
Nuvo has its own visual engine, Scene: each song draws itself to the beat, the words come in as they are sung, and a built-in studio saves short clips.


What you get
Where the music comes from
Nuvo plays tracks from YouTube Music and SoundCloud, and files from folders you add. It does not host music. Search looks in YouTube and SoundCloud at once and ranks their songs in one list.
Nuvo keeps the audio you play in a cache on your disk, so the next play starts fast and works with a weak connection.
Where your data lives
Nuvo comes in two editions. In the Standard edition the files below are plain. In the Encrypted edition the database and both caches are encrypted, and a key opens them.
| What | Where |
|---|---|
| Library database | ~/.local/share/nuvo/library.db |
| Database backups | ~/.local/share/nuvo/backups/ |
| Audio cache | ~/.cache/nuvo/audio/ |
| Cover cache | ~/.cache/nuvo/covers/ |
Tools and models Nuvo downloads (yt-dlp, Deno, ffmpeg, the speech models for lyrics) |
~/.local/share/nuvo/tools/ |
| Log | ~/.local/state/nuvo/core.log |
| Library key, Encrypted edition | Your system keyring |
| Library key without a keyring, Encrypted edition | ~/.local/share/nuvo/master.key, a private file you can seal with a passphrase |
Paths follow the XDG settings on your system. See data and encryption.
How the parts fit
A Rust service nuvo-core owns the data. The Electron window talks to it over a private unix socket, or a named pipe on Windows. Read the architecture overview.