# RadioDJViewer v1.15.1

**RadioDJViewer** is a Windows desktop app that reads Now Playing data from the RadioDJ REST API and publishes it to:

- local output files (`.txt` + album-art image)
- an embedded HTTP widget server for OBS/browser overlays
- Windows media integrations (SMTC + optional track-change toasts)

## What Changed Since the Old `v1.8.0` README

This project has moved beyond the original web-server-focused release notes. The app now includes:

- **Version update:** now documented at **v1.15.1**.
- **Profile-level toggles** for:
  - Web server enable/port
  - Clock visibility
  - Toast notifications
  - SMTC publishing
- **Expanded web endpoints** for time/playback state, not only title/artist/artwork.
- **SMTC integration** with metadata, artwork, playback status, and timeline behavior.
- **Live-stream SMTC handling** (`Duration <= 0`) that keeps playback reported as active.
- **Track-change toast notifications** with generated hero artwork.
- **Polling-rate support** per profile.
- **UI status behavior** remains tri-state (Disconnected/API/Web+API).

---

## Core Features

- Connects to RadioDJ REST API and parses:
  - `Title`
  - `Artist`
  - `Album`
  - `AlbumArt`
  - `Elapsed`
  - `Duration`
- Writes metadata output files for broadcast workflows.
- Serves a browser widget over HTTP from embedded resources.
- Caches metadata and artwork in memory for low-latency serving.
- Supports multiple saved profiles in `profiles.json`.
- Supports dark-mode theming in the app/settings UI.

## Playback and Time Behavior

The app tracks playback state from API `Elapsed` + `Duration` values.

- For normal tracks (`Duration > 0`):
  - elapsed/duration time is calculated and exposed
  - paused state can be inferred from unchanged elapsed progression
- For live streams (`Duration <= 0`):
  - treated as live (non-scrubbable)
  - SMTC is forced to active `Playing`
  - play/pause controls are disabled for read-only behavior
  - fixed-length timeline updates are bypassed

## Windows Integration

### SMTC (System Media Transport Controls)

When enabled per profile, the app publishes:

- title + artist
- current artwork thumbnail
- playback status (`Playing`/`Paused`/`Stopped`)
- timeline properties for fixed-duration tracks

Live-stream mode is intentionally read-only and continuously reported as playing for system widgets/tools that depend on active media state.

### Toast Notifications

When enabled per profile, track-change toasts can be shown with:

- title
- artist
- attribution line (date/time)
- generated 16:9 hero artwork image

## Embedded Web Server

When enabled, the app starts an HTTP listener on the profile-configured port.

### Main Widget

- `http://127.0.0.1:<port>/`
- `http://127.0.0.1:<port>/index.html`

### Metadata / State Endpoints

- `http://127.0.0.1:<port>/title.txt`
- `http://127.0.0.1:<port>/artist.txt`
- `http://127.0.0.1:<port>/time.txt`
- `http://127.0.0.1:<port>/elapsed`
- `http://127.0.0.1:<port>/duration`
- `http://127.0.0.1:<port>/clock-visibility`
- `http://127.0.0.1:<port>/status.json`

### Assets

- `http://127.0.0.1:<port>/Album-Art.png`
- `http://127.0.0.1:<port>/album-art.png`
- `http://127.0.0.1:<port>/style.css`
- `http://127.0.0.1:<port>/script.js`

The widget JavaScript supports refresh tuning via query string:

- `?refreshrate=<seconds>`

## Status Indicator (App UI)

- 🔴 **Red**: Disconnected
- 🟢 **Green**: Connected to API, web server off
- 🔵 **Blue**: Connected to API + web server running

## Requirements

- Windows
- **.NET Framework 4.7.2**
- RadioDJ with REST API/plugin access configured

## Setup

1. Launch `RadioDJViewer.exe`.
2. Open settings and create/load a profile.
3. Configure API values (`IP`, `Port`, `Password`, URL format).
4. Configure output folder and images folder.
5. Optional: configure polling rate, web server port, clock visibility, toast, and SMTC.
6. Connect to API.

## Repository

- `https://git.smartcraft.me/minster586/RadioDJViewer`

## Credits

Built and maintained by Smartcraft Media Group.

---

If you find an issue or need a feature adjustment, open an issue in the repository.