Skip to content

mrgogo7/NowPlaying.WebSocket

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

37 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŽง NowPlaying.WebSocket

Real-time Windows Now Playing data + Audio Visualizer JSON over WebSocket

NowPlaying.WebSocket is a lightweight Windows application that:

  • Streams Now Playing media data
  • Streams real-time Audio Visualizer data
  • Exposes everything via local WebSocket (JSON)
  • Works as a standalone desktop media controller

App Main ScreenShots

Settings UI

Flyout UI

๐Ÿ”ฅ Why this project exists

Most tools can show Now Playing.

Very few provide:

  • Real-time Audio Visualizer data
  • Clean JSON over WebSocket
  • Easy integration for browser apps, overlays, or OBS

This app focuses on all of them together.


โšก Core Features

๐ŸŽต Real-Time Audio Visualizer (WebSocket)

The main feature.

The app streams live audio analysis data:

  • Volume level
  • Bass / Mid / Treble
  • Frequency spectrum array

Perfect for:

  • Audio visualizers
  • Reactive UI
  • OBS browser sources
  • Web-based overlays
  • Stream tools

๐Ÿ“ก Endpoint: ws://localhost:27871


๐ŸŽง Now Playing Data (Live JSON)

Real-time media information:

  • Title
  • Artist
  • Album
  • Playback state
  • Timeline (position / duration)
  • Album art URL

๐Ÿ”Š Example: Audio Visualizer

{
  "Type": "audioVisualizer",
  "Volume": 35,
  "Bass": 59,
  "Mid": 43,
  "Treble": 40,
  "Spectrum": [50,36,42,40,41,38,37,42,38,41],
  "UpdatedAt": "21:18:20"
}

๐ŸŽต Example: Now Playing

{
  "Type": "nowPlaying",
  "Title": "Come Together - Remastered 2009",
  "Artist": "The Beatles",
  "Album": "Abbey Road (Remastered)",
  "Playback": "Playing",
  "IsPlaying": true,
  "PositionSec": 74,
  "DurationSec": 259,
  "PositionText": "1:14",
  "DurationText": "4:19",
  "AlbumArtUrl": "http://localhost:27871/album-art"
}

๐Ÿ–ฅ๏ธ Desktop App Features

Not just a WebSocket server a full Windows app.

๐ŸŽฎ Media Controls
  • Play / Pause
  • Next / Previous
  • Mute / Unmute
  • Volume control (slider + mouse wheel)
๐Ÿงฉ Smart UI & Tray
  • Tray icon with quick access
  • Click to open flyout panel
  • Lightweight, always accessible
โœจ Quality of Life
  • Click Title / Artist / Album โ†’ copy to clipboard
  • Always on top (optional)
  • Run at startup
  • Start minimized to tray
  • Dark theme
  • Hide tray icon
๐Ÿ”Š Audio Capture & Devices
  • Automatic loopback capture
  • Manual device selection:
    • Speakers
    • Headphones
    • Microphones (WASAPI)
๐ŸŽš๏ธ Visualizer Interval

Control update speed:

  • Lower = smoother animation
  • Higher = lower CPU usage

Useful for fine-tuning real-time visualizers.

๐Ÿ–ผ๏ธ Album Art: http://localhost:27871/album-art

Use directly in:

  • <img>
  • Canvas apps
  • Overlays

๐ŸŒ Built for Developers

Designed for:

  • Frontend developers
  • OBS users
  • Stream tool creators
  • Dashboard builders

๐ŸŒ Examples (Ready-to-Use HTML)

This repository includes ready-to-use HTML examples that connect to the WebSocket server and visualize real-time data.

๐Ÿ‘‰ Just open them in your browser while the app is running.

๐ŸŽต Basic Now Playing

  • Displays title, artist, album
  • Shows playback state
  • Timeline & progress bar
  • Live JSON stream

๐Ÿ“„ File: examples/basic-nowplaying.html

โšก Advanced Audio Visualizer

  • Adaptive bars
  • Beat punch effect
  • Radial visualizer
  • Smoothing & gain control

๐Ÿ“„ File: examples/advanced-plus-audio-visualizer.html

๐Ÿ’ก Use Cases
  • Audio Visualizer (web)
  • OBS browser source
  • Desktop widgets
  • Music dashboards
  • Stream overlays
  • Web-based music UI

๐Ÿ“ฆ Download

Latest version: https://github.com/mrgogo7/NowPlaying.WebSocket/releases/download/v6.4.30/NowPlaying.WebSocket_v6.4.30.0.exe

๐Ÿ” Privacy

  • No personal data collected
  • No media content sent externally
  • Everything runs locally Optional: Anonymous usage analytics (can be disabled)

โ˜• Support

If you find this useful: "Buy Me A Coffee"

โš ๏ธ Notes

This repository contains compiled application only Source code is not included

๐Ÿ“„ License

Free for personal use. Commercial use requires permission.

About

Real-time Windows Now Playing + Audio Visualizer data over WebSocket (JSON). Perfect for OBS overlays, dashboards, and web apps.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors