RaxFlix Smart TV Application

RaxFlix is a native Android TV application engineered to render the RaxFlix streaming platform (dulo.cx) on Smart TVs, Google TV, Fire TV, and Android TV boxes. It provides a lightweight, hardware-accelerated runtime with full Smart TV remote control (D-Pad) spatial navigation and automatic HTML5 video fullscreen support.

---

Technical Overview

RaxFlix is built using native Android SDK components to minimize RAM footprint and CPU overhead on Smart TV processors. Unlike cross-platform canvas frameworks, RaxFlix interfaces directly with native Android WebKit and hardware media decoders.

• Primary Language: Java (Android SDK 34)
• Target Platform: Android TV / Leanback (API Level 21+)
• Web Engine: Hardware-Accelerated Android WebKit
• Remote Control Protocol: Native D-Pad KeyEvent Dispatcher + Spatial Focus Handler
• Binary Format: Signed Release APK

---

Core Features

1. Cinematic Intro Animation

The application features a native vector-based intro animation sequence upon launch:

• Overshoot scaling of the RaxFlix emblem.
• Dynamic letter-spacing expansion on title text.
• Synchronized crossfade into the web runtime upon initial network load completion.

2. Smart TV Remote (D-Pad) Engine

• Active Focus Indicator: Applies a high-visibility focus ring (3.5px solid accent border with spatial glow) to interactive elements when targeted via TV remote arrow keys.
• Smooth Center Alignment: Automatically scrolls targeted cards, buttons, and media thumbnails into the vertical and horizontal center of the viewport.
• Scrollbar Elimination: Removes native browser scrollbars to maintain a clean TV presentation.
• Fallback Page Scrolling: Allows continuous vertical scrolling when navigating unstructured web grids.

3. Fullscreen Media Player Integration

• WebChromeClient custom view container automatically expands video playback elements into true 16:9 fullscreen mode when media playback starts.
• Native Android System UI flags (IMMERSIVE_STICKY) hide status and navigation overlays during playback.

4. Connection Resilience

• Automated network state monitoring via ConnectivityManager.
• Displays a native offline recovery screen with remote-focusable retry action if network connectivity is interrupted.

---

Installation

Pre-compiled Release APK

Download the latest signed release binary from the GitHub Releases page:

• Repository: Raxcore-dev/RaxFlix
• Release Tag: v1.0.0
• File: RaxFlix-v1.0.0-release.apk

Installation via ADB

Connect your workstation to the target Android TV device over local network:

adb connect <TARGET_TV_IP_ADDRESS>
adb install RaxFlix-v1.0.0-release.apk

Installation via USB Drive

1. Copy the APK file to a USB flash drive.
2. Connect the drive to the TV USB port.
3. Open any file management utility on the TV and select the APK file to initiate installation.

---

Building from Source

Prerequisites

• JDK 17
• Android SDK (API 34, Build-Tools 35.0.0)
• Gradle 8.5+

Build Steps

1. Clone the repository:

git clone https://github.com/Raxcore-dev/RaxFlix.git
cd RaxFlix

2. Compile the Debug APK:

./gradlew assembleDebug

3. Compile the Signed Release APK:

./gradlew assembleRelease

Output binaries will be generated at:

• Debug: app/build/outputs/apk/debug/app-debug.apk
• Release: app/build/outputs/apk/release/app-release.apk

---

Repository Structure

RaxFlix/
├── app/
│   ├── src/
│   │   └── main/
│   │       ├── java/com/raxflix/tv/
│   │       │   └── MainActivity.java
│   │       ├── res/
│   │       │   ├── drawable/
│   │       │   ├── layout/
│   │       │   ├── mipmap-*/
│   │       │   └── values/
│   │       └── AndroidManifest.xml
│   └── build.gradle
├── build.gradle
├── settings.gradle
└── gradle.properties

---

License

Copyright RaxCore Inc. All rights reserved.