🎵 Now Playing Overlay for Navidrome music servers. It displays real-time playback info like track title, artist, and album art in a stream-friendly overlay you can use on OBS, Twitch, or any custom frontend or videos. It's a simple tool for those who want a private way to display what they're listening to, fully privately.

Note: I'm still a beginner and this is my first open source project feel free to criticize and contribute to the project as much as you want, hope you like it :)

• Real-time now playing info from your private Navidrome server
• Clean, customizable HTML/CSS overlay for OBS or videos
• pulls metadata directly from the server using the Subsonic API
• Great support for compilations (Various Artists albums) and box sets (multi-disc albums)
• Multi-user, each user has their own play counts, playlists, favourites, etc...
• fully open source and GPLv3-licensed

• Download and run on your own server/domain
• Configurable or unlimited link expiry
• Your data stays on your server
• Full control

• Node.js
• A running Navidrome music server
• (Optional) OBS or Streamlabs if you plan to use the overlay in streams or recordings

Clone or download the Repository

git clone https://github.com/DaveKai/NaviOverlay cd navioverlay

npm install

Edit config/settings.js to customize:

module.exports = { // Token expiration in days // 0 = never expire (recommended for self-hosting) expires: 0, // example 2 = expire after 2 days  // Server port port: 3000, };

Go to the main directory and open terminal/cmd and type

node navioverlay.js

You should see

🎵 NaviOverlay server running on http://localhost:3000 ⚙️ Config: expires after X days

• Open your browser and go to http://localhost:3000 or whatever port you set in the config
• Enter your Navidrome server URL, username, and password starting from http:// or https://
• Click confirm -> It will redirect you to the generated link that contains the overlay
• Copy the link on the address bar

• in OBS or SLOBS or whatever software you wanna use it with, add a new Browser Source,
• Paste the URL that you copied and click Done :)

• This project runs on Node v22.16.0 and uses a minimal backend.

• express

• cors

GNU General Public License v3.0 ©