RadioDJViewer v1.8.0

RadioDJViewer is a high-performance Windows application designed to bridge the gap between RadioDJ and your broadcast visuals. It fetches live "Now Playing" data from the RadioDJ REST API and serves it simultaneously to physical local files and a built-in network web server.

🚀 New in v1.8.0: The Web Update

Integrated Web Server: Hosts a live, high-performance web widget for OBS Browser Sources.
Tri-State Status Indicator:
- 🔴 Red: Disconnected from RadioDJ API.
- 🟢 Green: Connected to API (Web Server Off).
- 🔵 Blue: Full Broadcast Mode (API Connected + Web Server Live).
Memory-Caching: Data is served to the web widget directly from RAM for zero-latency updates and reduced disk wear.
Network-Wide Access: View your "Now Playing" widget on any device (Phones, Tablets, or second PCs) on your local network.

🛠 Features

Connects to RadioDJ REST API to acquire real-time song info.
Displays title, artist, and album (with scrolling marquee for long text).
Dual-Output: Exports .txt and .png files for legacy GDI+ sources while hosting the web stream.
Supports multiple profiles for different RadioDJ instances.
Auto-regenerates missing profiles.json and fallback images.

🌐 Web API Endpoints

Once the server is active (Blue Status), you can access the following data URLs locally or over your network:

Resource	URL (Localhost)	Purpose
Main Widget	`http://127.0.0.1:8181/`	Loads the full HTML/CSS/JS widget for OBS.
Song Title	`http://127.0.0.1:8181/title.txt`	Returns the raw text of the current song.
Artist Name	`http://127.0.0.1:8181/artist.txt`	Returns the raw text of the current artist.
Album Art	`http://127.0.0.1:8181/Album-Art.png`	Serves the current album art image bytes.

Note: Replace 127.0.0.1 with your computer's local IP address to access these from other devices.

📋 Requirements

Windows 7 or later.
.NET Framework 4.7.2.
RadioDJ with the REST Server Plugin enabled and configured.

🔧 Installation & Setup

Download & Extract: Run the RadioDJViewer.exe.
Run as Administrator: This is required for the Web Server to bind to your network port.
Configure API: Enter your RadioDJ IP, Port, and Auth Key in the settings.
Set Output: Choose a folder for your physical text and image files (e.g., H:/RDJ-Output/).
Connect: Click Connect. Your status box should turn Blue when everything is active.

🌐 Network & Firewall Setup

To allow other devices to see the widget, you must open the port in the Windows Firewall:

Open Windows Firewall with Advanced Security.
Create a New Inbound Rule -> Port -> TCP.
Enter Port 8181 (or your chosen port) and select Allow the connection.

📝 Credits

This program was developed as a learning journey into C# and .NET, with collaborative assistance from Microsoft Copilot and Google Gemini to refine the API parsing and web server logic.

🔗 Links

Repository: https://git.smartcraft.me/minster586/RadioDJViewer
Contact/Stream: https://links.smartcraft.me/@minster586

For questions or issues, please open an issue on the repository or contact the maintainer.

3.4 KiB Raw Permalink Blame History