The Ultimate Open-Source Media Player for Android TV & Mobile

Bring your media sources to life with artwork, rich metadata, subtitle management, and seamless cross-device playback.

---

🔥 What's New in This Fork (Exclusive Features)

This fork introduces custom enhancements that elevate the viewing experience beyond the upstream project:

📺 Apple TV-Inspired Smart Subtitles Automation

Missed a line of dialogue or muted your TV? Subtitles got you covered!

Inspired by the polished user experience of Apple TV (tvOS), NuvioTV includes intelligent subtitle automation:

• Auto-Enable on Rewind: Automatically turns on subtitles whenever you seek backward (rewind) if subtitles are disabled.
• Auto-Enable on Mute: Automatically shows subtitles when audio is muted or volume is set to 0. Unmuting smoothly restores original subtitle status.
• Smart Accumulated Duration: Rewinding multiple times (20s, 30s+) dynamically accumulates and extends subtitle display time to match your rewind distance.
• Minimal Bottom-Right Indicator: Displays a clean, minimal "Rewind Subtitle On" or "Subtitles On (Muted)" badge in the bottom-right corner.
• Dynamic Player Control Shift: The notification badge smoothly lifts upward when player controls are active so it never overlaps seek bars or controls.
• Smart Language Selection: Automatically selects your preferred subtitle language or the best available track.
• User Customizable: Toggle both features independently under Settings > Subtitles.

---

✨ Key Features

• 📱 Designed for Big Screens & Mobile: Built natively using Jetpack Compose for TV and Material 3.
• ⚡ Dual Video Engines: Seamless integration of libmpv (for hardware acceleration & complex subtitle rendering) and AndroidX Media3 / ExoPlayer.
• 💬 Advanced Subtitle Support: Full support for ASS/SSA styling via libass, sidecar addon subtitles (OpenSubtitles / Stremio addons), custom timing offset, and outline customization.
• 🔊 Audio Features: Multi-channel downmixing, audio track selection, dynamic audio amplification, and offset synchronization.
• 🎨 Glassmorphism & Modern UI: Smooth motion design, dynamic preview scrubbing, TV remote navigation, and custom controls.

---

🛠️ Build from Source

Prerequisites

• Android Studio (Ladybug or newer recommended)
• JDK 17 or higher
• Android SDK (API level 34+)

Build Commands

Clone the repository and build the debug APKs:

# Clone the repository
git clone https://github.com/TheAceOfficials/Nuvio-TV.git
cd NuvioTV

# Build Android TV / Mobile Debug APK
./gradlew :app:assembleFullDebug

Output APK location: app/build/outputs/apk/full/debug/app-full-debug.apk

---

📄 License

Distributed under the GNU General Public License v3.0. See LICENSE for details.