Resource icon

OBS Python VLC Now Playing Monitor - Metadata Display 1.2.5

Fixed Issues:
  1. File output not working by default - The script now automatically writes to a default output file path. Previously, users had to manually configure the output file path in settings.
  2. Song titles with dashes displayed incorrectly - Fixed formatting logic that was removing dashes from song names. Files like "Song Title - Artist Name.mp3" now display correctly with the dash preserved.
  3. Folder monitoring mode parsing metadata instead of filenames - When using folder monitoring (instead of VLC source), the script now correctly displays the filename instead of attempting to parse metadata tags, which was causing incorrect display.
How to Update:
  1. Remove the old script from OBS (Tools → Scripts → Select script → Remove)
  2. Add the updated script back
  3. Reconfigure your settings if needed
All users are pleased to not download or run the script. It has a fatal error which im trying to find and fix. If you still have the old version of the file, please use that, otherwise it wont work.

I will fix this as soon as humanly possible, and i know some might be frustrated, but mistakes happen, and im really sorry for that. See ya in a bit lads.
⚠️ Warning: This version, while containing lots of new and improved features, it has a critical bug. Refer to Parse text error update for more information, and please download the new stable version 1.2.5.

Added Multi-Platform Support
Prior to version 1.0.0, the script used lsof, which is primarily a Linux based library.

Fixed Performance Issues (direct source reading)
  • VLC source reading is now the primary method (instant, no file system scanning)
  • lsof now only checks obs process, not entire folder.
  • Much faster and more reliable

Module-Level Imports
  • mutagen imported at top with HAS_MUTAGEN flag
  • Warns user once if not installed
  • No repeated import attempts

Path Validation
  • Validates if music folder exists in script_update()
  • Validates output file directory exists
  • Shows warnings in log with proper context
Better Cache Cleanup
  • Removes entries where files no longer exist
  • Only removes old entries when needed
  • Logs when cleanup happens

And lastly below I have to show some bonus improvements I've done that were not part of the plan (for now at least), but I ended up adding anyways.

Bonus Improvements
  • Better error handling with specific exception types
  • Improved logging with severity levels
  • Removed leading space from text output
  • Added VLC source selection in the OBS UI
  • Status shows mutagen availability and platform
Usage Notes for best results:
  1. Select your VLC source in the dropdown (recommended method)
  2. OR set music folder for fallback monitoring
Windows users need:
pip install psutil mutagen

Linux/macOS users need:
pip install mutagen # lsof is usually pre-installed
Top