Skip to content

Tips & Tricks

Jump to bottom
damontecres edited this page Jul 5, 2025 · 17 revisions

General playback issues

If scenes don't seem to play right or the controls don't respond like you expect, try following these steps:

  1. Try forcing a transcode with the Play with Transcoding option
    1. Find this on the scene details page under More
  2. Try disabling video filter and/or experimental features in Advanced Settings
  3. Try different Stream options in settings
    1. HLS & DASH usually work best
  4. Update to the latest app version

Still having issues? File an issue with details including the file's video codec, audio codec, resolution, etc.

Scene audio plays, but not video (or vice versa)

This probably means that the device thinks (or a preference overrides) that it can direct play the video. There are some other advanced settings that can be checked as well.

You can try:

  1. Force a transcode the Play with Transcoding
  2. Change codec overrides configured in advanced settings
  3. Disable video filters in advanced settings
  4. Disable experimental features in advanced settings

Images are cropped weirdly

Legacy UI only

By default, images on cards (studios, performers, etc) are center cropped to fit. Often this isn't great.

You can turn off the crop and scale the images down instead: go to Settings->Advanced and turn off "Card image handling"

Read only mode

Starting in v0.5.3, the app supports a read only mode!

See Read Only Mode for details!

The app crashed!

Oh no! It can be difficult to account for all possible varieties of data that you can add to Stash, so crashes can happen! Please file a bug report so the developers can investigate.

Starting with v0.3.3, when the app crashes, a dialog will give the option to send the crash report to your Stash server. This only works if the StashAppAndroidTV companion plugin is installed on the server though.

See Gathering App Logs for more information.

I can't submit the server URL when using a remote phone app

See this issue for some possible workarounds.

Connection problems with a large server

If you have a Stash server with a lot of items (more than ~50,000-100,000 items, but can vary!), queries may take longer than the default 15 second timeout.

You can try adjusting the advanced setting Network timeout in seconds (#253), to increase or remove the network timeout.

Direct play vs transcode

If encountering issues, users can override the decision by selecting the option at the bottom of a scene's details page.

The app checks the device's codec support against the scene's primary file metadata comparing the video codec (eg HEVC, H264), audio codec (eg AC3, MP3), and container format (eg AVI, MP4). If the app believes the device supports all three, the file will be played directly without transcoding.

The app is not always able to determine every supported codec or format perfectly, so some formats are assumed to be supported, such as AC3 audio or MP4 containers. These assumptions can be adjusted in advanced settings.

See also #273 and #274

Develop build

This build is the current work-in-progress. It has the latest features, but may be unstable or have bugs!

You can install the latest development debug build from the develop pre-release using the same install methods. The short code is 505547 or URL: https://aftv.news/505547

You can also use the in-app updater for development builds by changing the URL in Settings->Advanced->Update URL to https://api.github.com/repos/damontecres/StashAppAndroidTV/releases/tags/develop (replace latest with tags/develop).

Clone this wiki locally