⚠️ 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:
- Select your VLC source in the dropdown (recommended method)
- 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