Repository navigation
Releases
Releases · kvm404/railreel
v0.1.0 — Initial Release: Offline In-Sync Movie Watching
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-videoand 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_LOCKand 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 supportssoftap/tethermulti-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 --noEmitandeslint). - Platform Compatibility: Designed exclusively for Android devices (React Native 0.85 / Expo SDK 56 / Android 10+).