========================================
   PULSE TUNES - Music Overlay
   by nailedeet
========================================

WHAT IT DOES
------------
Shows what's playing on your PC directly on your OBS stream.
Dynamic accent colors automatically match your album art for a premium look.


HOW TO USE
----------
1. Run PulseTunes.exe
2. It will appear in your system tray (bottom right, near the clock)
3. Go to https://nailedeet.com/tools/music-widget-settings/
4. Customize your widget design
5. Click "Copy OBS URL"
6. In OBS, add a Browser Source and paste the URL
7. Browser Source size Width 650 x Height 200 for best results
8. Done! Your music will now show on stream


SUPPORTED PLAYERS
-----------------
✅ Spotify
✅ YouTube (browser)
✅ Windows Media Player
✅ Most modern media apps


TRAY ICON
---------
Right-click the tray icon for options:
  🎨 Configure Widget - Opens the design page
  🎵 Show Current Song - Displays what's playing
  📋 Copy Song Info - Copies song to clipboard
  ℹ️ About - Version info
  ❌ Exit - Closes the app


VERSION HISTORY
---------------
Version 1.9.1 (Current)
  - Fixed Spotify not detected when launched after PulseTunes
  - Added automatic session refresh every 5 seconds
  - Start apps in any order — PulseTunes will find them

Version 1.9
  - Fixed port 8080 getting stuck when app is closed
  - Added graceful shutdown of WebSocket connections
  - Added error message if another instance is already running
  - Better cleanup on application exit

Version 1.8
  - Initial release with WebSocket bridge
  - System tray integration
  - Real-time album art support
  - OBS browser source compatibility


TROUBLESHOOTING
---------------

"Port already in use" or app won't start:
-----------------------------------------
If you were using version 1.8 and closed the app, port 8080 may still be locked.
Version 1.9+ fixes this going forward, but to fix it right now:

Option 1 - Restart your computer (easiest)

Option 2 - Close it manually:
  1. Open Command Prompt as Administrator
  2. Run: netstat -ano | findstr :8080
  3. Find the PID number in the last column (LISTENING line)
  4. Run: taskkill /PID [PID_NUMBER] /F
     Example: taskkill /PID 26864 /F
  5. Launch PulseTunes again

Option 3 - Task Manager:
  1. Press Ctrl+Shift+Esc
  2. Find any "PulseTunes" or "MusicNowPlaying" processes
  3. End Task on all of them
  4. Launch PulseTunes again


Widget not showing music:
-------------------------
- Check your OBS Browser Source URL matches what's in the config page
- Restart PulseTunes (right-click tray icon → Exit, then launch again)
- Refresh your OBS browser source


Spotify not detected:
---------------------
- For best results, start PulseTunes BEFORE any music app
- Version 1.9.1+ automatically checks for new music apps every 5 seconds
- Still not working? Completely close Spotify (including system tray), then relaunch it


Album art not appearing:
------------------------
- Give it a moment — album art can take a few seconds to load
- Try switching songs to trigger a refresh


Firewall blocking the connection:
---------------------------------
- PulseTunes only uses localhost (127.0.0.1), so no internet access needed
- If prompted by firewall, allow access for local network


NEED HELP?
----------
Website: https://nailedeet.com
Widget config: https://nailedeet.com/tools/music-widget-settings/


Version 1.9.1 | Made with ❤️ for the community