# TiviLux Native v0.4.25

**Google TV remote compatibility + VOD movie recovery + category/channel organization — versionCode 39.**

This is an incremental upgrade of the supplied TiviLux Native v0.4.22 source. Package identity, Xtream login, hidden provider URL behavior, profiles, Favorites Guide, manual Guide ordering, Sports Hub, updater, SmartTune/Turbo Tune, shared Live player, HOME/background-audio shutdown, and Clear Cache are preserved.

## v0.4.25 highlights
- Fullscreen Live TV `DPAD_UP` / `DPAD_DOWN` and Android `CHANNEL_UP` / `CHANNEL_DOWN` now surf channels without opening the HUD.
- Fullscreen Live TV `BACK` returns directly to the TV Guide.
- Movies/episodes use validated Xtream VOD stream candidates with provider direct-source support plus extension fallback to MP4/MKV/TS when a primary URL fails.
- Settings now includes **Channels & Categories** for profile-scoped category reorder and hide/show across Live TV, Movies and Series.
- Live channels can be hidden from the Guide and restored from Settings; hidden content is removed from normal browsing/surf/search surfaces without deleting provider data.

See `UPDATE-NOTES-v0.4.25.txt` and `BUILD-CHECKLIST-v0.4.25.txt`.

## Build identity
- versionName `0.4.25`
- versionCode `41`
- application ID `tv.tivilux.nativeplayer`
- minSdk 23 / targetSdk 35
- expected APK `TiviLux-Native-v0.4.25.apk`

Use the same signing certificate/keystore as the currently installed TiviLux APK so Android accepts it as an update. The supplied source archive does not contain a Gradle wrapper, so use the existing external APK-builder/Android build workflow.

---

## Previous project notes

# TiviLux Native v0.3.1

Android TV / Google TV / Fire TV native Xtream player.

## v0.3.1 focus

This release tightens the fullscreen live-player remote flow, fixes guide return behavior, normalizes the Live TV header actions, and gives first-run startup a cleaner/faster 0-100% experience.

### Fullscreen Live TV
- BACK with hidden controls restores the bottom control tiles.
- BACK again while the tiles are visible returns to the TV Guide.
- The top-left channel/program information disappears with the bottom tiles for clean fullscreen viewing.
- Duplicate BACK routing was removed and player-exit navigation is guarded to reduce intermittent crashes.

### Sports / guide return
A stream launched from Sports returns to its real Live TV category and the guide automatically scrolls/focuses the exact playing channel.

### Guide layout and speed
- Favorite and Watch Full Screen buttons are responsive so they do not crop on narrower category layouts.
- Guide channel ordering is memoized instead of repeatedly sorting thousands of channels during EPG time updates.
- Full EPG indexing is still completed in the background, but first-run startup no longer waits longer than about 2 seconds for the bulk EPG fast path.

### Startup
Startup now presents one smooth 0-100% progress display with Live TV, TV Guide, and Movies + Series stage cards. Exact counts are still maintained internally and in the app after loading, but they no longer clutter or slow the startup experience.

## Update server
The updater checks:

`https://play.theappdrop.store/tivilux-updates/latest.json`

Build the signed APK with the same signing key, upload it as:

`/tivilux-updates/TiviLux-Native-v0.3.1.apk`

and publish `latest.json` with versionCode 15.

## Build
- `versionName 0.3.1`
- `versionCode 15`
- application ID `tv.tivilux.nativeplayer`
- minSdk 23
- targetSdk 35
- Media3 / ExoPlayer
- Jetpack Compose TV-oriented UI

Use the same keystore/signing certificate as the currently installed TiviLux APK so Android accepts it as an update.


## v0.4.2 hotfix
The in-app update card now runs in its own modal TV focus window so D-pad focus cannot escape into Home-screen tabs.


## v0.4.2 Sports Turbo
Sports no longer scans every sports feed one-by-one when the tab opens. It renders immediately from the indexed playlist and cached/bulk EPG, then fills only small league-specific gaps in the background.


## v0.4.4 GUIDE ULTRA
Normal Live TV entry starts at the top of the sorted list. Player/Sports returns still anchor to the active channel. Guide key-repeat now suspends EPG/cache work and heavy maintenance is deferred off latency-sensitive screens.


## v0.4.5 GUIDE CORE / INSTANT TV
The Live TV guide focus architecture was rebuilt for sustained held-D-pad navigation. Logos and EPG remain visible during scrolling, cached XMLTV can hydrate while Live is open, the Home rail is on-demand, TV Guide supports BACK-BACK to exit, and the persistent live TextureView keeps its preview bounds across fullscreen transitions to reduce black flashes.


## v0.4.5 GUIDE CORE / TIVIMATE-STYLE NAVIGATION
The TV Guide now uses a single-focus cursor for held-D-pad stability. LEFT opens Live Groups, LEFT again opens the main TiviLux menu, and HOLD OK opens a right-side Guide Settings panel. BACK-BACK exits from the guide. The guide remains warm behind fullscreen Live TV so the shared TextureView can resize back to preview without rebuilding the guide or intentionally blanking the player.


## v0.4.6 GUIDE POLISH / PREVIEW RESTORE
The Live TV preview is permanent again, the highlighted guide row stays centered during held scrolling, OK tunes then OK again opens fullscreen, and the old Favorite / Watch Full Screen guide-header buttons have been removed so the header is dedicated to EPG information.
