Skip to content

New Compose UI

damontecres edited this page Jul 5, 2025 · 5 revisions

New UI using Jetpack Compose

The new UI is built using Jetpack Compose, which is a modern toolkit for building a native Android UI. The initial development was done in https://github.com/damontecres/StashAppAndroidTV/pull/525.

The new UI is the default starting with v0.6.6.

See #592 for known issues and planned enhancements.

Theming

The new UI supports dark and light modes. It also supports changing the overall aesthetic/coloring of the app using themes.

Changing the theme

This is a very alpha feature and is not guaranteed to work perfectly! It is also not guaranteed to be supported in the future.

The app uses the Material Design Color System.

You can create a new theme with https://material-foundation.github.io/material-theme-builder/

Once you've picked out the colors:

  1. Export the theme as a JSON file
  2. Open your Stash Web UI
  3. Create a new Tag with whatever name you want to call the theme
  4. Copy the contents of the JSON file and paste into the new Tag's description field, it will be very long!
  5. Save the Tag
  6. Open StashAppAndroidTV on your TV
  7. Go to Settings->More UI Settings->Theme
  8. Select search, find the tag created in step 3, and select it
    • A sample card with the selected theme is shown at the top
  9. Hit save!

The theme is saved locally on the device, so you can delete the tag from the web UI if you want to.

Note: The changing fonts and contrast themes is not supported and their values will be ignored.

TV variations

The Android TV color scheme differs slightly from standard Material Design. These can be altered using the "extended colors", but the app will fallback to a sensible default if not specified.

For example, the highlight color for the border of cards is not specified in the standard Material Design.

Name Fallback Description
Border inversePrimary Border around focused cards

Clone this wiki locally