Skip to content
@StreamMusicViewer

Stream Music Viewer

Organisation for the StreamMusicViewers and the things around it

OBS Stream Music Viewer (OSMV)

Status Platform Windows Platform Linux C++ Qt

Welcome to the StreamMusicViewer organization! This is the flagship "Now Playing" widget for OBS. Built in C++ with Qt 6, it's designed to be elegant, lightweight, and high-performance.

Features

  • Real-time updates — Detects currently playing music every second
  • Album artwork — Displays full-resolution album covers
  • Dynamic color — Widget background matches the album cover palette
  • Audio visualizer — Animated bars in OBS (beta)
  • Discord Rich Presence — Shows what you're listening to on Discord
  • Background operation — Minimize to system tray
  • Multi-app support — Spotify, Apple Music, Firefox, Chrome, VLC, and more

How It Works

graph TD
    A[Music Player] -->|MPRIS2 / WinRT| B[OSMV Qt App]
    B -->|Writes JSON| C[current_song.json]
    C -->|Polled by| D[OBS Browser Source]
    D -->|Renders| E[OBS Overlay]
Loading

Quick Start

Windows

  1. Go to the Releases page and download the latest .zip.
  2. Extract and place osmv.exe, index.html, and style.css in a folder.
  3. Double-click osmv.exe.
  4. Configure OBS (see below).

Linux

Install dependencies:

sudo pacman -S qt6-base playerctl   # Arch / Manjaro
# or
sudo apt install qt6-base-dev playerctl   # Ubuntu 24.04+
  1. Go to the Releases page and download the latest Linux binary.
  2. Place osmv, index.html, and style.css in the same folder.
  3. chmod +x osmv && ./osmv — an icon appears in your system tray.
  4. Configure OBS (see below).

Configure OBS

  1. In OBS, add a new Browser source.
  2. Check "Local file".
  3. Browse and select index.html from the folder containing the app.
  4. Set dimensions: Width: 500, Height: 140.
  5. Click OK.

As long as the application is running, your OBS widget updates automatically.


Our Repositories

Repository Description
OSMV (Full) The complete experience with album art, color adaptation, Discord RP, and visualizer.
OSMV Lite The minimal version for maximum broadcast performance.

Links & Creator


Built for streamers who care about every detail of their broadcast.

Pinned Loading

  1. OSMV OSMV Public

    Local "Now Playing" Extension for OBS made in C++ (for windows and linux)

    C++ 2

  2. OSMV-lite OSMV-lite Public

    Local extension for OBS made in C# for displaying your actual music with Windows Media Control

    C# 4

Repositories

Showing 4 of 4 repositories

Top languages

Loading…

Most used topics

Loading…