dart_cast 0.4.2

dart_cast: ^0.4.2 copied to clipboard

Fixed #

• Proxy IP selection: MediaProxy now picks the local interface on the same subnet as the target cast device, fixing casting failures on devices with VPN, Docker, or virtual network adapters (e.g., proxy binding to 192.0.0.4 instead of 192.168.x.x)
• Concurrent loadMedia guard: All protocol sessions (Chromecast, AirPlay, DLNA) now ignore duplicate loadMedia() calls while one is already in progress, preventing multiple LOAD messages from being sent to the device
• Socket disconnect detection: Chromecast session now handles message stream errors and unexpected closures, transitioning to disconnected state so the app can react (previously the session stayed "connected" after a network drop)

Fixed #

• DLNA start position: seek now deferred until TV confirms PLAYING state (immediate seek was ignored by TVs still loading)
• Chromecast subtitles for local files: subtitle files now served via HTTP/1.1 with CORS headers (HTTP/1.0 path lacked Access-Control-Allow-Origin required by Shaka Player)
• Http10FileServer: returns 416 Range Not Satisfiable for invalid/out-of-bounds ranges
• SubtitleConverter.vttToSrt(): uses targeted regex for timestamp dots (no longer corrupts non-timestamp content), expands 2-component MM:SS timestamps to HH:MM:SS
• Removed stray response.close() after socket detach in synthetic content handler

New #

• Updated example app with optimistic slider state, keyboard shortcuts, mute toggle, and responsive layout
• Added protocol feature indicators in example device picker
• Updated README with "What Works Where" feature matrix, protocol notes, and DLNA local files guide

Breaking #

• DLNA file serving now uses HTTP/1.0 via raw sockets instead of Dart's HttpServer response. This fixes playback on TCL Google TV and other renderers that reject HTTP/1.1.
• Removed DLNA-specific HTTP headers (transferMode.dlna.org, contentFeatures.dlna.org, Connection: close) from file responses — these caused some DLNA renderers to reject content.
• Cleared Dart's default security headers (x-frame-options, x-xss-protection, x-content-type-options) from the proxy server.

New #

• Http10FileServer — reusable HTTP/1.0 file server class for DLNA compatibility
• CastMediaType.mkv — MKV container support for casting with embedded subtitles
• SubtitleConverter.vttToSrt() — WebVTT to SRT conversion
• SubtitleConverter.toAss() — VTT/SRT to ASS conversion with customizable styling (font, outline, shadow, margins)
• MediaProxy.registerSubtitleVariants() — registers both SRT and VTT subtitle variants for maximum TV compatibility
• DLNA subtitle variants: DIDL-Lite now includes both SRT and VTT subtitle URLs with proper format/type attributes
• DLNA seek instantly updates position without waiting for next polling cycle
• MKV content type detection and proxy URL extension support

Fixed #

• DLNA playback failing on TCL Google TV and similar renderers that reject HTTP/1.1 responses
• DLNA flags mismatch between DIDL-Lite protocolInfo (21500000) and HTTP headers (01700000) — now aligned to 01700000 matching VLC and MiniDLNA
• Missing DLNA.ORG_PN profile name in protocolInfo (AVC_MP4_HP_HD_AAC for MP4, MPEG_TS_HD_NA_ISO for TS)
• DLNA seeking not working — Range responses now correctly return 206 with Content-Range
• Subtitle file proxy URLs missing file extensions (.vtt, .srt) — some TVs need extensions to recognize subtitle files
• Synthetic content (subtitle playlists, converted subtitles) now served via HTTP/1.0 for DLNA compatibility

• Added protocol status table to README with testing coverage and known limitations
• Documented DLNA MP4 playback issues (TV-dependent, some reject proxy-served MP4)
• Documented DLNA subtitle limitations (sec:CaptionInfoEx not universally supported)
• Documented AirPlay video casting limitations (404 on some Google TV devices)
• Recommended Chromecast as the primary tested protocol for local file casting

Breaking changes #

• DefaultMediaTransformer no longer wraps local TS files in HLS — it serves them directly via the proxy. Use TsHlsMediaTransformer or FfmpegMediaTransformer for Chromecast-compatible local TS casting.
• CastMedia.useChunkedHls is deprecated and will be removed in a future release. TsHlsMediaTransformer always uses chunked HLS.
• ChromecastSession now defaults to TsHlsMediaTransformer instead of DefaultMediaTransformer.

New #

• TsHlsMediaTransformer — wraps local TS files in keyframe-aligned HLS playlists for Chromecast compatibility
• MediaProxy.setPatPmt() / MediaProxy.setFirstPts() — enable correct PAT/PMT prepending and PTS offset for virtual HLS segments
• FfmpegMediaTransformer reference implementation in example app — remuxes TS→MP4 via ffmpeg with progress callbacks and mobile platform support
• doc/LOCAL_FILE_CASTING.md — comprehensive guide covering remux, HLS wrapping, and transcode approaches with tradeoffs

Migration guide #

Replace direct DefaultMediaTransformer usage for local TS files:

// Before (0.2.x) — DefaultMediaTransformer handled local TS→HLS internally
final session = await device.connect();

// After (0.3.0) — choose your transformer explicitly
// Option A: FFmpeg remux (recommended)
final session = await device.connect(
  mediaTransformer: FfmpegMediaTransformer(),
);

// Option B: Built-in HLS wrapping (no external tools)
final session = await device.connect(
  mediaTransformer: TsHlsMediaTransformer(),
);

Local file casting #

• Local file support with CastMedia.file() constructor
• MediaTransformer interface for extensible media format preparation
• TsKeyframeScanner for keyframe-aligned HLS segment boundaries
• Virtual segment URLs for Chromecast compatibility (replaces EXT-X-BYTERANGE)
• useChunkedHls flag for chunked vs single-segment HLS
• Local subtitle support with automatic SRT-to-VTT conversion

Chromecast fixes #

• Fixed local file casting — HLS playlists and file routes were destroyed by cleanup before the device could fetch them
• CORS preflight (OPTIONS) handler for HLS segment requests
• RFC 8216-compliant TARGETDURATION calculation
• Consistent application/x-mpegURL content type across all HLS responses
• File extension on proxy URLs for HLS player format detection
• Volume updates via RECEIVER_STATUS instead of optimistic update

DLNA improvements #

• Duration metadata via DIDL-Lite <res duration="HH:MM:SS"> attribute
• DLNA-specific HTTP headers (transferMode.dlna.org, DLNA.ORG_OP=01 flags)
• Serve local TS files directly (not piped through HLS)

Other #

• Retry mDNS queries 3 times for slow-responding devices
• Comprehensive logging for all discovery providers and sessions
• Subtitle proxy for Chromecast (CORS + SRT conversion)
• Log viewer and custom media input in example app

• AirPlay feature flag detection via mDNS TXT records (AirPlayFeatures class parses features/ft bitmask)
• AirPlayMediaController with V1/V2 /play format auto-negotiation (V1 binary plist → V1 text/parameters → V2 with RTSP SETUP)
• UnsupportedFeatureException thrown immediately when a device lacks video support bits (0 and 49)
• PlaybackException thrown when all /play format attempts are rejected by the device
• Breaking: HapSession no longer has play, stop, scrub, or rate methods — use AirPlayMediaController instead
• Added docs/PROTOCOL_REFERENCES.md with links to AirPlay, Chromecast, and DLNA specs
• Added docs/FUTURE_WORK.md documenting AirPlay screen mirroring and RAOP audio streaming roadmap

• Initial release
• Chromecast (CASTV2) protocol support with default media receiver
• AirPlay 1 video casting support
• DLNA/UPnP protocol support with AVTransport and RenderingControl
• Built-in HTTP proxy server for custom header injection
• HLS m3u8 playlist URL rewriting through proxy
• Local file serving for downloaded content
• Subtitle support across all protocols (WebVTT, SRT)
• Cross-platform: Android, iOS, macOS, Windows, Linux
• Pluggable device discovery (default: multicast_dns, injectable: bonsoir)
• 366+ tests with mock servers for each protocol
• Flutter example app with device picker and remote control