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 accessible.

🔧 Installation & Setup

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

🌐 Network & Firewall Setup

To access the widget from another device (like a phone or second PC), you must open a port in the Windows Firewall:

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

📝 Project Background

This project was born from a desire to move away from purely web-based external tools and create a native Windows utility for stream overlays. Special thanks to Roderick's RadioDJ Tutorials for the inspiration and initial logic concepts.

This program was developed as a learning journey into C# and .NET, with significant 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.