This is an Android TV app for browsing images and playing scenes from a Stash server. Many devices running Android TV are supported, including Amazon Fire TV devices. See device compatibility for more information.
The app supports browsing, searching, and filtering just about everything including scenes, images, performers, tags, etc. The app also supports video hardware decoding when available so your server can transcode less.
The app is not intended to perform administrative functions such as scraping or editing details. Some curation tasks are available though such as adding tags or performers to scenes.
Make sure your Stash server is running and that you can access it over the network (not localhost).
Check the Tips & Tricks page for some common issues and solutions!
- Enable side-loading "unknown" apps
- https://androidtvnews.com/unknown-sources-chromecast-google-tv/
- https://www.xda-developers.com/how-to-sideload-apps-android-tv/
- https://developer.android.com/distribute/marketing-tools/alternative-distribution#unknown-sources
- https://www.aftvnews.com/how-to-enable-apps-from-unknown-sources-on-an-amazon-fire-tv-or-fire-tv-stick/
- Install the APK on your Android TV device with one of these options:
- Install a browser program such as Downloader, use it to get the latest apk with short code
745800or URL: https://aftv.news/745800 - Download the latest APK release from the releases page or https://aftv.news/745800
- Put the APK on an SD Card/USB stick/network share and use a file manager app from the Google Play Store / Amazon AppStore (e.g.
FX File Explorer). Android's preinstalled file manager probably will not work! - Use
Send files to TVfrom the Google Play Store on your phone & TV - (Expert) Use ADB to install the APK from your computer (guide)
- Put the APK on an SD Card/USB stick/network share and use a file manager app from the Google Play Store / Amazon AppStore (e.g.
- Install a browser program such as Downloader, use it to get the latest apk with short code
- Configure the app
- Optionally, install the StashAppAndroidTV Companion plugin on your server to enable additional features
- Search for
StashAppAndroidTV Companionon your server's Settings->Plugins page - Alternatively, trigger an install from the Android TV app in
Settings->Advanced->Install companion plugin
- Search for
After the initial install above, the app will automatically check for updates which can then be installed in settings.
The first time you attempt an update, the Android TV OS should guide you through enabling the required additional permissions for the app to install updates.
The first time you open the app, follow the prompts to configure the app to connect to your Stash server.
- Enter the full URL of your Stash server (e.g.
http://192.168.1.122:9999)- Don't use
localhost; use the IP address or domain of your Stash server - Don't forget to include the port which 9999 by default
- If you have configured HTTPS/SSL/TLS, make sure to use
https://instead ofhttp://
- Don't use
- If you have enabled authentication on your Stash server, you will be prompted to enter the API Key
- Use your phone to browse to your Stash server and copy the API Key from the Settings->Security page (e.g. http://192.168.1.122:9999/settings?tab=security)
- Use your phone's virtual remote control or the
Amazon Fire TVapp to paste the API Key into the TV app
- If you have trouble submitting the URL or API Key using the virtual remote control, see some tips here
You can configure multiple servers in the app. To add, remove, or switch servers, use the Manage Servers option in the settings or click the Stash icon on the main page.
The app strives to be compatible with the latest released version of Stash.
Currently, the minimum supported/tested server version is Stash 0.27.0.
The app supports many devices running Android TV OS, such as the NVIDIA Shield, Amazon Fire TV devices (Fire OS 6 or greater), or Chromecast with Google TV.
See Device Compatibility for more information.
The StashAppAndroidTV Companion plugin enables additional features in the app. It is not required to use the app, but it is recommended especially if you run into issues.
Currently, the plugin only supports receiving crash reports and logs from the app. But, this can help diagnose issues and improve the app.
Issues and pull requests are always welcome! UI/UX improvements are especially desired!
Please check before submitting that your issue or pull request is not a duplicate.
If you plan to submit a pull request, please read the contributing guide before submitting!
