Skip to content

VoidStar-INC/NowPlaying-Universal-

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

63 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

NowPlayingRevamped-universal

A lightweight Now Playing overlay for OBS Studio, built on Windows Media Control via the TUNA plugin. Displays album art, track title, artist name, and a live progress bar as a browser source in your stream.


Verified Working Platforms

  • YouTube (browser)
  • YouTube Music (browser)
  • Spotify (browser — see Spotify notes below)
  • Twitch (browser)
  • iHeart Radio (browser)

This overlay works with any platform that registers with Windows Media Control through a browser. The list above is verified — many more platforms likely work without additional setup.


Lineage

This project is part of a chain of open source contributions:


Features

  • Album art with smooth fade on track change
  • Artist name and track title with animated text transition
  • Live progress bar pulled from TUNA's local webserver
  • Auto-hides when nothing is playing
  • Slide in / slide out animation
  • Customizable accent color and size via CSS variables
  • Filter out unwanted audio sources via ignore lists

Requirements


Setup

Step 1 — TUNA Configuration

In OBS, open TUNA settings and configure the following:

  • Set Song source to Windows Media Control
  • Format {title} → save to a folder of your choice as Tuna-nowplaying.txt
  • Format {first_artist} → save to the same folder as tuna-artist.txt
  • Cover art → save to the same folder as cover.png
  • Enable the TUNA webserver on port 1608

Step 2 — Place the Files

Download or clone this repo and place all the files into the same folder you configured TUNA to save its output files in. Your folder should contain:

  • index.html
  • index.js
  • style.css
  • settings.json
  • Tuna-nowplaying.txt
  • tuna-artist.txt
  • cover.png

Keeping everything in one folder means no file path editing is required.

Step 3 — Simple Web Server

  1. Open Simple Web Server and create a new server
  2. Point it to the folder from Step 1 and Step 2
  3. Note the URL it gives you (e.g. http://localhost:8080)
  4. Turn the server on

Step 4 — OBS Browser Source

  1. In OBS, add a new Browser Source
  2. Set the URL to: http://localhost:8080/index.html (adjust the port to match what Simple Web Server gave you)
  3. Width: 500, Height: 150
  4. Check "Refresh browser when scene becomes active"
  5. Position it wherever you like on your scene

Spotify Notes

The Spotify desktop app does not register reliably with Windows Media Control. To use Spotify with this overlay:

  1. Open open.spotify.com in your preferred browser
  2. Start playing a song
  3. Click the device/speaker icon in the bottom right of the Spotify player
  4. Select your browser as the active playback device
  5. The overlay will pick it up automatically via Windows Media Control

If the Spotify desktop app is open it may intercept playback. Either close it or make sure the browser is selected as the active device in Spotify's device picker.


Known Limitations

  • Multiple simultaneous sources — if two browser tabs are playing audio at the same time, Windows Media Control will display whichever source became active most recently. When the second source stops, the first will not automatically repopulate until a new track change event occurs. This is a Windows Media Control behavior and is planned for improvement in a future update.

Customization

Accent color

Open style.css and change the --accent variable:

--accent: #00e5ff;  /* cyan — default */
--accent: #ff6b6b;  /* red */
--accent: #a8ff78;  /* green */
--accent: #ffd700;  /* gold */

Widget size

Change --art-size in style.css to resize the album art (and the whole widget scales with it).

Filtering unwanted sources

If Windows Media Control picks up game audio or other apps you don't want displayed, open index.js and add them to the ignore lists:

ignoredArtists: ["Rocket League", "Windows"],
ignoredTitles:  ["Unknown", ""],

Planned

  • Improved handling of multiple simultaneous audio sources
  • Broader platform testing and verification
  • Customizable widget position
  • Multiple visual themes

License

MIT — free to use, modify, and build on. Credit appreciated but not required.

About

Universal Now Playing overlay for OBS Studio. Shows album art, track title, artist, and a live progress bar. Works with YouTube, Spotify, Twitch, iHeart Radio, and any browser-based media via Windows Media Control + TUNA. Forked from xMannyGamingx/NowPlayingRevamped.

Topics

Resources

Stars

Watchers

Forks

Contributors

Languages

  • JavaScript 57.6%
  • CSS 35.8%
  • HTML 6.6%