NaviClean

NaviClean is a Docker-first cleaner and organizer for mounted Navidrome music libraries, providing guided path previews, duplicate review, unindexed and…

  • Media Applications
  • Tools & Utilities
NaviClean is a Docker-first cleaner and organizer for mounted Navidrome music libraries, providing guided path previews, duplicate review, unindexed and non-music cleanup, Spotify-backed discovery, and audio conversion for users maintaining self-hosted music collections.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

55/100 Fair

Maintained
100last commit 11 days ago
Popular
00 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed today, links checked 20 days ago

GitHub stars
0
Open issues
0
Last commit
2026-11-10
Latest release
v0.7.3
Activity
declining

Checked 6 days ago - source: GitHub (thedinz/NaviClean)

Resources & Compatibility

Requirements not published yet.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Docker setup and default access Run image ghcr.io/thedinz/naviclean:latest with /data mapped for config and /music for your Navidrome library, using PUID=1000 and PGID=1000. The web UI is served on port 8080 with the default login admin/admin. source
  • Reverse proxy When fronting NaviClean with a reverse proxy, set NAVICLEAN_TRUST_PROXY=1, NAVICLEAN_SECURE_COOKIES=auto, and NAVICLEAN_COOKIE_SAMESITE=lax. source

Fetched 47 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

What are the default web UI port and login?

The web UI is served on port 8080. The default login is admin/admin.

What reverse proxy environment variables should I set?

Set NAVICLEAN_TRUST_PROXY=1, NAVICLEAN_SECURE_COOKIES=auto, and NAVICLEAN_COOKIE_SAMESITE=lax. These are the reverse-proxy settings listed in the defaults.

What user IDs should I use on Unraid?

Use PUID=99 and PGID=100. This lets NaviClean write to /mnt/user/appdata/naviclean and the mounted music share.

Can I clean duplicates immediately?

No, duplicate cleanup unlocks only after organization is complete. NaviClean previews clean artist, album, and track paths before that step is available.

How do I enable the internal diagnostics page?

Set NAVICLEAN_ADVANCED_DIAGNOSTICS=1 in the container environment. This shows the Diagnostics page and enables the matching-inspection API routes.

Answers sourced from github.com

Community

Collected 49 days ago - public community threads