OBS Python VLC Now Playing Monitor - Metadata Display 1.0.0

VLC Now Playing Monitor

Automatically detects and displays the currently playing song from your VLC Video Source, reading actual ID3 metadata tags (title, artist, album) instead of relying on manual timing.

✨ Features

• Real-time Detection: Automatically detects which song VLC is currently playing
• Metadata Support: Reads ID3 tags (title, artist, album) from MP3, FLAC, OGG, M4A, WAV, OPUS, AAC files
• Customizable Format: Use variables like `{title} - {artist}` to create your own display format
• Smart Caching: Caches metadata for better performance
• File Export: Optionally save current song to a text file
• Session Statistics: Track how many songs played during your stream
• Fallback Support: Uses filename if metadata is unavailable
• Zero Latency: Updates instantly when songs change

Perfect For

• Radio streams
• Music channels
• DJ streams
• Lo-fi study streams
• Playlist showcases

Requirements

• OS: Linux (uses `lsof` command)
• OBS: Version 27.0 or higher with Python scripting enabled
• Python 3: Usually pre-installed on Linux
• Optional: `mutagen` library for better metadata reading

Installation
Step 1: Install Dependencies (Optional but Recommended)
pip3 install mutagen

Step 2: Add Script to OBS

1. Download vlc_now_playing.py
2. Open OBS -> Tools -> Scripts
3. Click the + (Plus) button
4. Select vlc_now_playing.py
5. Configure settings in the Script panel