updates and bug fixes

Author: dfallman

.DS_Store

@@ -22,3 +22,4 @@ target
 
 # Claude Code local project state — not meant to be shared
 .claude/
+docs

.gitignore

@@ -4,16 +4,20 @@ Spritz implements DLNA/UPnP AV directly instead of wrapping an existing library.
 
 ## Discovery (SSDP)
 
-Spritz sends `ssdp:alive` announcements to `239.255.255.250:1900` on startup, responds to `M-SEARCH` requests (honoring the client's `MX` delay per UPnP 1.0 §1.2.3), and sends `ssdp:byebye` on exit. Announcements repeat every 3 minutes, and each NT is sent three times with small gaps to survive datagram loss on WiFi.
+Spritz sends `ssdp:alive` announcements to `239.255.255.250:1900` (IPv4) and `[FF02::C]:1900` (IPv6) on startup, responds to `M-SEARCH` requests (honoring the client's `MX` delay per UPnP 1.0 §1.2.3), and sends `ssdp:byebye` on exit. Announcements repeat every 3 minutes, and each NT is sent three times with small gaps to survive datagram loss on WiFi. `LOCATION` URLs use `[ipv6]:port` when answering an IPv6 search.
 
 ## Device description
 
-`GET /upnp/description.xml` returns a `MediaServer:1` description advertising the ContentDirectory and ConnectionManager services. The `<dlna:X_DLNADOC>DMS-1.50</dlna:X_DLNADOC>` tag marks it as a DLNA DMS, which strict clients (tvOS Infuse, SenPlayer) require.
+`GET /upnp/description.xml` returns a `MediaServer:1` description advertising ContentDirectory, ConnectionManager, and Microsoft `X_MS_MediaReceiverRegistrar` (Xbox). The `<dlna:X_DLNADOC>DMS-1.50</dlna:X_DLNADOC>` tag marks it as a DLNA DMS, which strict clients (tvOS Infuse, SenPlayer) require.
 
 ## Browse (SOAP)
 
-`POST /upnp/control/contentdirectory` handles `Browse`, `GetSystemUpdateID`, `GetSearchCapabilities`, and `GetSortCapabilities`. The root has three children: `V` (Videos, flat), `A` (Music, flat), and `F` (By folder, recursive). Empty containers are hidden. `<res>` tags include `size=` and DLNA.ORG flags (`OP=01` byte-seek plus standard streaming flags); file responses set `transferMode.dlna.org: Streaming` and `contentFeatures.dlna.org` so Infuse will play them.
+`POST /upnp/control/contentdirectory` handles `Browse`, `Search`, `GetSystemUpdateID`, `GetSearchCapabilities`, and `GetSortCapabilities`. The root has three children: `V` (Videos, flat), `A` (Music, flat), and `F` (By folder, recursive). Empty containers are hidden. `<res>` tags include `size=`, `duration=` when the container header can be parsed, `DLNA.ORG_PN` for common profiles, and DLNA.ORG flags (`OP=01` byte-seek plus standard streaming flags). Matching sidecar subtitles (`.srt` / `.vtt` / `.ass`) are extra `<res>` URLs. Sidecar covers (`cover.jpg` / same-stem `.jpg`) appear as `<upnp:albumArtURI>` pointing at `/art/{index}`. File responses set `transferMode.dlna.org: Streaming` and `contentFeatures.dlna.org` so Infuse will play them.
+
+A `SUBSCRIBE` to an event URL is answered with a SID and an immediate HTTP `NOTIFY` carrying the current state variables (`SystemUpdateID` stays `1` because the library is scanned once at start).
+
+`GET /upnp/icon.png` is a 48×48 PNG listed in `iconList` on the device description.
 
 ## File serving
 
-Each source directory is mounted at `/m/{index}/` and served over HTTP with range support via `tower-http`'s `ServeDir`.
+Each source directory is mounted at `/m/{index}/` and served over HTTP with range support via `tower-http`'s `ServeFile`. Requests that leave the tree, follow a symlink, or use an unknown extension return 404. Sidecar subtitles sharing a stem with an indexed file are reachable so clients can fetch the extra `<res>` URLs. Album art is served at `/art/{index}` from `cover.jpg` / `folder.jpg` / a same-stem image next to the file.

ARCHITECTURE.md

@@ -4,6 +4,20 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+## [Unreleased]
+
+### Added
+
+- `--bind` and `--name` so a multi-homed host can pick an interface and a DLNA friendly name
+- ContentDirectory `Search` (title contains + video/audio class)
+- 48×48 PNG device icon at `GET /upnp/icon.png`
+- Sidecar subtitles (`.srt` / `.vtt` / `.ass`) served over HTTP and advertised as extra DIDL `<res>` tags
+- Access log (`info`) for `/m/`, `/upnp/`, and `/art/` requests
+- DIDL `duration` and `DLNA.ORG_PN` from file headers (MP4/MKV/WAV/FLAC) plus sidecar album art
+- UPnP event `NOTIFY` after `SUBSCRIBE` (ContentDirectory, ConnectionManager, MediaReceiverRegistrar)
+- Xbox `X_MS_MediaReceiverRegistrar` service (`IsAuthorized` / `IsValidated` always succeed)
+- IPv6 SSDP (`[FF02::C]:1900`) and dual-stack HTTP when `--bind` is unspecified
+
 ## [0.1.4] - 2026-04-22
 
 ### Added
@@ -27,12 +41,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
-- Add audio support and restructure DIDL hierarchy for Infuse tvOS
+- Cross-platform release binaries via cargo-dist
 
 ## [0.1.1] - 2026-04-22
 
 ### Added
 
-- Add audio support and restructure DIDL hierarchy for Infuse tvOS
+- Initial public release automation (release-plz)
 
 <!-- release-plz inserts new version sections below this line -->

CHANGELOG.md

@@ -30,7 +30,9 @@ DLNA clients — such as modern TVs, Apple TV (via Infuse or VLC), PS5, Xbox, Ko
 - Serves one or more folders (recursively — subdirectories are indexed automatically) from a single instance
 - Presents three browse views at the root: `Videos`, `Music`, and `By folder` (the on-disk structure)
 - Supports video and audio formats (MP4/MKV/AVI/MOV/… and MP3/FLAC/OGG/…)
-- Implements `ContentDirectory:1` and `ConnectionManager:1` for DLNA Browse
+- Implements `ContentDirectory:1` and `ConnectionManager:1` for DLNA Browse and Search
+- Advertises sidecar subtitles (`.srt` / `.vtt` / `.ass`) next to matching media files
+- Advertises duration, DLNA profile names, and sidecar album art (`cover.jpg` / matching stem)
 - Exposes an M3U playlist at `/spritz` for VLC, Infuse, and similar players
 - Sends `ssdp:byebye` on Ctrl+C so clients drop it immediately
 
@@ -80,6 +82,8 @@ Arguments:
 
 Options:
   -p, --port <PORT>  Port to listen on [default: 8080]
+      --bind <ADDR>  Address to bind [default: 0.0.0.0]
+  -n, --name <NAME>  Friendly name shown to DLNA clients [default: Spritz Media Server]
   -h, --help         Print help
 ```
 
@@ -97,6 +101,9 @@ spritz /mnt/nas/movies /mnt/nas/tv /mnt/nas/kids
 
 # Use a different port
 spritz --port 9000 /media/videos
+
+# Bind a specific interface and set the name TVs display
+spritz --bind 192.168.1.10 --name "Living Room" /media/videos
 ```
 
 ## Connecting a client
@@ -142,22 +149,35 @@ Point it at `http://<your-spritz-server-ip>:8080/spritz`.
 | `.wma`                  | `audio/x-ms-wma`|
 | `.aiff`, `.aif`         | `audio/aiff`    |
 
+**Subtitles** (sidecar files next to a video/audio item; not listed as their own library entries)
+
+| Extension      | MIME type     |
+|----------------|---------------|
+| `.srt`         | `text/srt`    |
+| `.vtt`         | `text/vtt`    |
+| `.ass`, `.ssa` | `text/x-ssa`  |
+
 ## Compatibility
 
 | Device                                | Status | Notes                                                              |
 |---------------------------------------|--------|--------------------------------------------------------------------|
 | Samsung (Tizen)                       | Works  | Requires `<dc:date>` on each DIDL item — included                  |
-| LG (webOS)                            | Works  | Shows an "unknown device" icon (no icon endpoint yet)              |
+| LG (webOS)                            | Works  | Device icon served at `/upnp/icon.png`                             |
 | Sony / Bravia                         | Works  | Strict about `Content-Type: text/xml; charset="utf-8"` — handled   |
 | Apple TV — Infuse (tvOS, iOS, iPadOS) | Works  | Requires the full DIDL treatment for tvOS playback                 |
 | Apple TV — VLC (tvOS, iOS, iPadOS)    | Works  | tvOS VLC sometimes misses SSDP; add the M3U URL manually           |
+| Xbox                                  | Works  | Advertises Microsoft `MediaReceiverRegistrar`                      |
 
 ## Troubleshooting
 
 DLNA is fiddly by nature, especially in combination with certain devices and operating systems (looking at you, Apple TV).
 
 If your client can't find Spritz, check your firewall rules first (on both the server and client side, but typically the server side): SSDP needs UDP 1900 open, and HTTP needs your serving port (8080 by default).
 
+On a VPN, Docker, or multi-homed machine, discovery may succeed while playback URLs point at the wrong address. Infuse and VLC using the M3U URL (`/spritz`) pick up the `Host` header; SSDP `LOCATION` tries to reply with the interface on the same subnet as the client.
+
+IPv6-only LANs: SSDP also joins `[FF02::C]:1900`. When `--bind` is the default unspecified address, HTTP tries a dual-stack socket so IPv6 clients can fetch `LOCATION`. Link-local (`fe80::`) addresses are not advertised.
+
 On Apple TV, Infuse tends to work better than VLC. If you're using VLC and can't find the share, you can bypass discovery entirely by pasting the M3U URL into VLC: `Media → Open Network Stream → http://192.168.X.X:8080/spritz`. If that plays, the server is fine and the issue is discovery.
 
 Restart VLC once Spritz is already running — VLC only scans at startup and on NOTIFY packets.
@@ -186,10 +206,10 @@ New-NetFirewallRule -DisplayName "Spritz SSDP" `
 
 Spritz implements DLNA/UPnP AV directly instead of wrapping an existing library. At a glance:
 
-- **Discovery (SSDP).** Sends `ssdp:alive` on startup, responds to `M-SEARCH`, and sends `ssdp:byebye` on exit.
-- **Device description.** `GET /upnp/description.xml` returns a `MediaServer:1` description advertising ContentDirectory and ConnectionManager.
-- **Browse (SOAP).** `POST /upnp/control/contentdirectory` handles `Browse` and related actions, exposing three root containers: Videos (flat), Music (flat), and By folder (recursive).
-- **File serving.** Each source directory is mounted at `/m/{index}/` and served over HTTP with range support.
+- **Discovery (SSDP).** Sends `ssdp:alive` on IPv4 and IPv6 on startup, responds to `M-SEARCH`, and sends `ssdp:byebye` on exit.
+- **Device description.** `GET /upnp/description.xml` returns a `MediaServer:1` description advertising ContentDirectory, ConnectionManager, and Xbox MediaReceiverRegistrar.
+- **Browse / Search (SOAP).** `POST /upnp/control/contentdirectory` handles `Browse`, `Search`, and related actions, exposing three root containers: Videos (flat), Music (flat), and By folder (recursive).
+- **File serving.** Each source directory is mounted at `/m/{index}/` and served over HTTP with range support. Only media, sidecar-subtitle, and album-art extensions are reachable; directory listings, other files, and symlinks are not.
 
 See [ARCHITECTURE.md](ARCHITECTURE.md) for the full protocol walkthrough.
 

Cargo.lock

@@ -11,10 +11,12 @@ authors.workspace = true
 anyhow = "1.0.102"
 axum = "0.8.8"
 dlna = { version = "0.1.4", path = "../dlna" }
-uuid = { version = "1", features = ["v4"] }
+uuid = { version = "1", features = ["v5"] }
+hostname = "0.4"
 spritz-core = { version = "0.1.4", path = "../core" }
 local-ip-address = "0.6.11"
 tokio = { version = "1.51.1", features = ["full"] }
+socket2 = "0.6"
 tower = "0.5"
 tower-http = { version = "0.6.8", features = ["fs", "set-header"] }
 tracing = "0.1"