The .NSP files in this repo are smart playlist definitions, not static song lists. Each file is a set of JSON rules that Navidrome can read during a library scan and turn into a playlist.

What Smart Playlists Do

Smart playlists stay dynamic. Instead of manually adding songs one by one, you define rules like:

songs from a genre
songs from a year range
loved or high-rated tracks
tracks from or excluded by certain artists, albums, or tags

Navidrome applies those rules automatically, so the playlist updates as your library changes.

How To Use

Save the .NSP file in a folder that Navidrome scans for playlists.
Run a library scan or quick scan in Navidrome.
Open the playlist in Navidrome and check that the results match what you wanted.

If the playlist does not appear, the file is usually in the wrong folder, the JSON is invalid, or the scan has not run yet.

Basic File Structure

Most smart playlists here follow the same pattern:

title is the playlist name shown in Navidrome.
comment is a short description.
all means every rule in the list must match.
any means only one rule needs to match.
sort and order control the result order.
limit caps how many tracks the playlist returns.

Example ideas used in this folder:

genre playlists such as Rock, Pop, Hip Hop, Metal, and Country
decade playlists such as 70s, 80s, 90s, 2000s, and 2010s
utility playlists such as Recently Added, Unrated, and Un-Played
favorites and jukebox-style playlists for quick access

Excluding Folders

Navidrome uses a .ndignore file to exclude folders or files from being added to the library.

Put an empty .ndignore file in a folder to ignore that folder and everything under it.
Or place one .ndignore file in your parent music folder and use .gitignore-style rules inside it.

Example:

# Ignore specific folders
/untagged/
/unsorted/

# Ignore a file type
*.flac

# Allow one specific album back in
!/favorite-album/*.flac

Filename Order

The first character of the filename is used as a simple sorting trick for how playlists appear in Navidrome.

For example, a filename like ! Top Hip Hop ;).NSP will appear near the top. While '_ Top Hip Hop ;).NSP' will appear near the bottom.

In this library, the leading characters are used in a rough order like this:

!  #  $  &  '  (;  *  +  ,  -  .  ;  =  >  @  A-Z  ^  _

That makes it easier to group important playlists at the top and push utility playlists lower down.

This does not work well with different apps. For example, amperfy (iphone sub-sonic app) sorts '_ Top Hip Hop ;).NSP' as the top playlist, and 'Top Hip Hop ;).NSP' as the last playlist. So haven't quite figured out the best naming scheme that works well across all apps. For now, just be aware that the leading characters may affect playlist order differently in different apps.

Ratings Sync

A couple of community tools can help synchronize ratings between your Navidrome library and MusicBrainz.

SPTNR — https://gitea.sickgaming.net/sickprodigy/sptnr
- Use this to apply ratings to your Navidrome/Subsonic library. API is used, so user/pass is needed. Once most of your library is rated, you will see them show up in your smart playlists that filter by rating. I have updated it so you can use Spotify, MusicBrainz, or Last.fm ratings as the source for your Navidrome ratings.
MusicBrainz Ratings Helper — https://gitea.sickgaming.net/sickprodigy/musicbrainz-ratings-helper
- Use this to push ratings from Navidrome to MusicBrainz. Requires a MusicBrainz account. This helps the community by sharing your ratings with the MusicBrainz database, so others can benefit from your ratings when they sync their Navidrome library with MusicBrainz. You can also see your ratings on the MusicBrainz website and use them in other apps that pull from MusicBrainz.

Note: These are community tools. Review the documentation, test on a small subset, and back up your data before running a full sync.

README.md

Navidrome Smart Playlists