Skip to content

Releases

v0.1.0 — Initial Release: Offline In-Sync Movie Watching

Choose a tag to compare

@kvm404 kvm404 released this 04 Sep 08:43

RailReel v0.1.0 — Initial Release

RailReel brings offline, in-sync group movie-watching to Android. One host shares a local video file over a Wi-Fi hotspot; 4–6 friends watch in frame-accurate sync on their own devices with real-time reactions and chat. No internet connection, no accounts, and no streaming servers required.


🚂 Key Highlights

1. Zero-Internet Distributed Architecture

  • Local Video Distribution: The host serves video directly from local storage using an embedded Android HTTP server supporting RFC 7233 byte-range requests.
  • Independent Local Playback: Each device plays its own local cached copy via expo-video and ExoPlayer — video frames are never streamed across devices, ensuring maximum video quality with minimal network strain.
  • Zero-Conf Discovery: Join cabins effortlessly using tap-to-join via Android Network Service Discovery (mDNS) or by scanning the host's QR code.

2. High-Precision Synchronization Engine

  • NTP-Style Clock Alignment: Sub-millisecond clock synchronization over WebSocket with robust outlier rejection.
  • Continuous Thermal Drift Compensation: A rolling 8-sample NTP median window tracks physical quartz oscillator drift over long 2+ hour viewing sessions.
  • Smooth Two-Stage Drift Correction:
    • Inaudible Nudge Zone: Playback rates dynamically adjust (0.95× – 1.05×) to gently pull devices into alignment without pitch distortion.
    • Landing-Latency Compensated Seeks: Hard seeks occur only when drift exceeds the deadband, perfectly leading landing latency.
  • Progressive Start Gate: Smart buffer floor math allows participants to start playback while downloading if network throughput outruns playback bitrate, with automatic room holding for stragglers.

3. Native Android Data Plane (railreel-host)

  • Dedicated Android Foreground Service: Hosts run with WAKE_LOCK and high-performance Wi-Fi locks to maintain continuous throughput during screen-off and background transitions.
  • Non-Blocking Control Plane: Broadcast frames across WebSocket clients use non-blocking executor pools with strict global deadlines, immune to client socket stalls.
  • Intelligent Subnet Matching: Automatically prioritizes the 192.168.43. private SoftAP hotspot subnet and supports softap/tether multi-interface setups.

4. Cabin Social Experience & "Night Train Window" UI

  • Atmospheric Visual Design: Warm filament progress rings, split-flap boarding displays, and custom typography (Space Grotesk, Space Mono, Unbounded).
  • Floating Reactions & Cabin Chat: Send floating emoji reactions and chat messages directly over the playback screen.
  • Host Controls: Seamless playback override ("Play without {name}"), participant approval/eviction manifest, and automatic room resumption.

🛠 Stability & Hardening Highlights

This release incorporates comprehensive security and reliability fixes:

  • Start-Gate Deadlock Prevention: Graceful departure handling and disconnect events ensure leaving guests never block room departure.
  • Host Transport Lockout Resolution: Fixed auto-pause hold states to ensure host manual pause commands are always respected.
  • Memory & File Descriptor Protection: Closed flags and contract compliance in progressive proxy input streams prevent socket and FD leaks.
  • Security & Identity Enforcement: Strict roster identity checks prevent client ID spoofing and block unapproved guests from broadcasting chat or reactions.
  • Resilient Media Streaming: Mandatory FastStart preflight guards prevent premature playback stalls on non-stream-optimized MP4 files.

🧪 Verification & Test Coverage

  • Vitest Unit Tests: 135 passing tests across 9 test suites covering start-gate math, NTP clock estimation, drift correction, and protocol framing.
  • TypeScript & Linting: 100% clean check (tsc --noEmit and eslint).
  • Platform Compatibility: Designed exclusively for Android devices (React Native 0.85 / Expo SDK 56 / Android 10+).