HeinPlay

Project Overview

HeinPlay is a cross-platform video playback app built with Flutter. The TV build is optimized for Android TV and large screens with remote-focused navigation, the tvLegacy build supports old TVs running Android 5.0+, and the mobile build offers a portrait touch UI. Desktop builds include Web, Windows and Linux, with Linux shipped as a single AppImage aimed especially at handhelds such as the Steam Deck; a HarmonyOS NEXT build is in development. All builds share one business layer, and the playback backend can switch between ExoPlayer and fvp.

One codebase spans TVs, phones and handhelds, with both on-demand and live playback.

Key Features

• Video browsing: a home feed plus movie, TV, variety and anime channels, with filtering, sorting and poster grids
• Details and episodes: synopsis, ratings, cast and episode lists, with multiple playback sources and auto-play
• Full-screen playback: play/pause, seek, progress dragging, volume and brightness control, and aspect ratio switching
• Multiple backends: ExoPlayer by default on Android, fvp on tvLegacy and desktop, with vlc kept as a fallback on Windows
• Live TV and catch-up: built-in live sources plus custom M3U/TXT sources, with EPG schedules and time-shift playback
• WAN/LAN switching: configure separate internet and LAN server addresses, with automatic speed tests to pick the best one
• IPv6 preference: can prefer IPv6 for the internet server and fall back to IPv4 automatically
• Dual accounts and web admin: one-tap switching between primary and secondary accounts, plus a built-in phone admin page on port 5025 for TV
• Gamepad support: Android TV, tvLegacy, Windows and Linux all support gamepad operation
• Dual-channel updates: a domestic channel by default with an optional GitHub channel, including download progress and auto-install

Target Audience

• Users of Android TVs or TV boxes
• Users still on older Android TVs
• Users who want to watch on handhelds or desktops
• Users who want live and on-demand in one app
• Users who prefer gamepad controls

Quick Start

1. On the Releases page, pick the package for your device: TV or tvLegacy for TVs, mobile for phones, the portable zip for Windows, and the AppImage for Linux handhelds
2. Install and open the app, then fill in the internet and LAN server addresses under "My -> Server management"
3. On launch the app runs a speed test and picks the lowest-latency address, shown in the top status bar
4. Find a title on the home feed, categories or search, then open its detail page to choose a source and episodes
5. For live TV, open the live page and use a built-in source or import your own M3U/TXT source, then fetch the EPG schedule
6. Linux handheld users can run the install script in the repo to deploy the AppImage; running it again performs an upgrade

Core Advantages

• One codebase, many devices: TVs, phones, Windows and Linux handhelds share one business layer and interaction model
• Robust playback: multiple switchable backends plus buffering and speed-test tuning make startup faster
• Handheld-optimized: the Linux build is a single AppImage that goes full-screen under SteamOS game mode
• Complete live experience: full EPG schedules, time-shift playback and backup source switching keep live TV smooth

System Requirements

Item	Requirement
Android TV	Android 7.0 (API 24) or later
Legacy TVs	Android 5.0 (API 21) or later, using the tvLegacy build
Phones / tablets	Android 7.0 (API 24) or later
Windows	Windows 10 1809 or later, unzip and run
Linux	Desktop Linux x86_64 with reasonably recent GTK3 / ALSA system libraries

Notes

• Web build limited: the Web build is for local testing only and is subject to browser CORS limits, so some remote images may not load
• Update lag: the domestic channel may lag behind GitHub; switch to the GitHub channel if you want the newest build
• Rendering differences: the standard TV build uses Vulkan by default; switch to tvLegacy if an older device crashes or stutters
• HarmonyOS unreleased: the HarmonyOS NEXT build is still in development with no Release package yet