Skip to content

Add Android TV guides - #137

Merged
MattiasBuelens merged 17 commits into
developfrom
feature/tv-guides
Oct 20, 2026
Merged

MattiasBuelens merged 17 commits into
developfrom
feature/tv-guides

Conversation

@MattiasBuelens

@MattiasBuelens MattiasBuelens commented Oct 19, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

Adds guides for the experimental android-ui-tv library, in a new "Android TV" subcategory at the end of Guides (docs/guides/android-tv/_category_.json, position: 4, icon 📺):

  • Getting started on Android TV (android-tv/getting-started.md): installation (android-ui-tv:1.+), TV manifest setup, THEOplayerTvTheme { Surface { DefaultUI(...) } }, remote control keys, live/ads, menus, subtitles, theming, using your own THEOplayerView, differences from mobile, and the demo app.
  • Making a custom TV UI (android-tv/custom-ui.md): TV UIController slots, controls, menus (openMenu, Menu), focus management, state holders, and the Nitflex example.

Also:

  • custom-ui.md: links to the TV guide; fixes the Player.kt link (moved to ui-common).
  • localization.md: string resources moved to ui-common; they also apply to android-ui-tv.
  • chromecast.md: notes that android-ui-tv has no Chromecast support.
  • README.md: new "Works on phones and tablets, with experimental support for Android TV" feature bullet, and an "Android TV" usage section after "Custom UI", linking to the guide and the TV demo app.

All Kotlin snippets were compiled in a scratch file in :app (since removed).

Screenshots

Captured on an Android TV emulator in the TV demo app, scaled to 1920×1080:

  • docs/assets/tv-default-ui.png: Default theme, Bip Bop (HLS), controls visible.
  • docs/assets/tv-default-ui-live.png: Default theme, DASH-IF Livesim, no seek bar, focus on Play.
  • docs/assets/tv-language-menu.png: Default theme, Subtitles side panel open, a subtitle track focused.
  • docs/assets/tv-settings-menu.png: Default theme, Settings side panel open, Quality focused.
  • docs/assets/tv-nitflex-ui.png: Nitflex theme, Sintel (DASH), controls visible, center Play focused.
  • docs/assets/tv-demo-home.png: TV demo home screen, stream carousel and theme chips.

Link to Devin session: https://dolby.devinenterprise.com/sessions/edf7b16cd28344f695cd947531a8ad1f
Open in Devin Desktop: https://dolby.devinenterprise.com/desktop/session/edf7b16cd28344f695cd947531a8ad1f?variant=devin
Requested by: @MattiasBuelens

MattiasBuelens and others added 3 commits October 19, 2026 15:06
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@devin-ai-integration

Copy link
Copy Markdown
Contributor

I'll fix CI failures and address comments from users with write access. I'll skip comments containing "(aside)".

  • Disable automatic comment, CI, and merge conflict monitoring

MattiasBuelens and others added 11 commits October 19, 2026 15:10
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@MattiasBuelens MattiasBuelens added the documentation Improvements or additions to documentation label Oct 20, 2026
MattiasBuelens and others added 3 commits October 20, 2026 08:33
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@MattiasBuelens
MattiasBuelens merged commit 30d2fca into develop Oct 20, 2026
1 check passed
@MattiasBuelens
MattiasBuelens deleted the feature/tv-guides branch October 20, 2026 08:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant