theothernt / AerialViews

A screensaver for Android TV devices including Nvidia Shield, Fire TV, and Chromecast with Google TV. Inspired by Apple TV's video screensaver.
GNU General Public License v3.0
415 stars 32 forks source link
android android-tv chromecast exoplayer2 google-tv kotlin nvidia-shield screensaver

Aerial Views

Latest GitHub release GitHub Downloads Google Play Downloads Amazon Fire TV

API License

A screensaver for Android TV devices including Nvidia Shield, Fire TV, and Chromecast with Google TV. Inspired by Apple TV's video screensaver.

Please read if you have a Nvidia Shield, Chromecast with Google TV, onn. Google TV 4K Streaming Box or Amazon Fire TV

Features include...

Support the project

If you enjoy using the app, please consider buying me a coffee.

Ko-fi badge

How to get Aerial Views...

Google Play Store badge    Amazon Appstore badge

Or download the APK from the Releases page and install it manually

Translations

If Aerial Views is not available in your language but you have some free time to help translate menu text and video descriptions, please get in touch!

We use the Lokalise platform to coordinate translations for Aerial Views and thank them for their support of this open-source project.

Lokalise logo

Where to download videos for offline/local playback

Follow these links to download the videos from...

HDR videos don't seem to play, I only see black screen...

Apple's videos only support Dolby Vision HDR. Even if your TV supports HDR, it might not support Dolby Vision.

Here are some things to try...

Nvidia Shield users

If your device is running Android 11 (Shield Experience 9+) and you want to play videos from a USB storage device, make sure the following setting is enabled:

Settings > Device Preferences > Storage > Scan for media automatically

How to set Aerial Views as the default screensaver

The following devices have no user-interface to change the screensaver to a 3rd party one...

But it can be done manually. Here is an overview of the steps...

  1. Enable Developer mode and find the IP address of your device
  2. Use a Mac, iPhone, PC or Android phone with the required software or app
  3. Connect to your Android/Google/Fire TV device
  4. Run two ADB commands, one to set Aerial Views as the default screensaver, the other to set how long it takes the screensaver to start
Enable Developer Mode on your Android/Google TV   Navigate to the Settings menu on your device, then to the About screen. Depending on the device… `Settings > System > About` or `Settings > Device Preferences > About` Scroll down to __Build__ and select __Build__ several times until you get the message "You are now a developer!" Return to __Settings__ and look for the newly enabled __Developer options__ page. On the __Developer options__ page, look for the __USB debugging__ option and enable it. Next, find the __IP address__ of your device. Try looking in the Network & Internet settings of the device, check the properties of the current LAN or WIFI connection - that should list the current IP address eg. 192.168.1.105
Enable Developer Mode on Fire Stick/TV   Open __Settings__, then navigate to __My Fire TV__ then the __About__ screen. Highlight the first option on the list, which is usually your device's name, and press the action button on your remote seven times. You'll now see a message confirming "You are now a developer", and it'll unlock the __Developer Options__ in the previous menu. Navigate to the __Developer Options__ page, look for the __ADB debugging__ option and enable it. Next, find the IP address of your device and make a note of it. Navigate to the __About__ then __Network__ screen, which will show your current IP address eg. 192.168.1.120
Connect using an iPhone   Find an iPhone app that is capable of running ADB commands, [such as iSH Shell](https://ish.app/), which is free. Once installed, run the app and install the Android Tools with the following commands… ```sh apk update apk add android-tools ``` To check if the ADB command is working, try typing… ```sh adb version ``` After pressing return, you should see something like this ```sh Android Debug Bridge version 1.0.41 Version 31.0.0p1-android-tools ``` Now you can execute ADB commands.
Connect using an Android phone   Find an Android app that is capable of running ADB commands, [such as Remote Termux](https://play.google.com/store/apps/details?id=com.termux), which is free. Once installed, run the app and install the Android Tools with the following commands… ```sh pkg update pkg install android-tools ``` To check if the ADB command is working, try typing… ```sh adb version ``` After pressing return, you should see something like this ```sh Android Debug Bridge version 1.0.41 Version 34.0.0p1-android-tools ``` Now you can execute ADB commands.
Connect using a Mac   Download the official [SDK Platform Tools](https://developer.android.com/studio/releases/platform-tools) for Mac. Extract the files from the ZIP archive to a folder. Then open a Terminal or Command Prompt and navigate to the folder. To check if the ADB command is working, try typing… ```sh adb version ``` After pressing return, you should see something like this ```sh Android Debug Bridge version 1.0.41 Version 35.0.0-11411520 ``` Now you can execute ADB commands.
Connect using a PC with Windows   Download the official [SDK Platform Tools](https://developer.android.com/studio/releases/platform-tools) for Windows. An alternate option is [Tiny ADB and Fastboot Tool (Portable version)](https://androidmtk.com/tiny-adb-and-fastboot-tool) but they both work in the same way. Extract the files from the ZIP archive to a folder. Then open a Terminal or Command Prompt and navigate to the folder. To check if the ADB command is working, try typing… ```sh adb version ``` After pressing return, you should see something like this ```sh Android Debug Bridge version 1.0.41 Version 35.0.0-11411520 ```
ADB command - set Aerial Views as the default screensaver   Connect to your Android TV device and start a command shell... ```sh adb connect ``` :information_source: *Use the IP address of your device from earlier steps, it should be something like 192.168.1.98* ```sh adb shell ``` :information_source: *The first time you connect to your Android TV device, you will probably see a confirmation dialogue asking to "allow" the connection* Next, set Aerial Views as the default screensaver with this command… ```sh settings put secure screensaver_components com.neilturner.aerialviews/.ui.screensaver.DreamActivity ``` Optional: Confirm that the command was run successfully, as there is no confirmation when the command above is run. ```sh settings get secure screensaver_components ``` If set correctly, you should see... ```sh com.neilturner.aerialviews/com.neilturner.aerialviews.ui.screensaver.DreamActivity ```
ADB command - change the screensaver timeout   To change the default timeout use this command with a value in milliseconds. So, 5 minutes is 300000, 10 minutes is 600000 and so on. ```sh settings put system screen_off_timeout 600000 ```
How to revert back to the default screensaver   For whatever reason, if you would like to stop using Aerial Views and revert back to the original screensaver, there are two options… * Reset your device. Doing so will also reset the screensaver preference * Use an ADB commands to enable the default screensaver, depending on your device 1. Follow the instructions above to connect to your Android/Google TV device using an iPhone, Android phone, Mac, PC, etc 2. Run one of the following commands... ### To restore the default Google TV ambient screensaver ```sh settings put secure screensaver_components com.google.android.apps.tv.dreamx/.service.Backdrop ``` ### To restore the default Fire TV screensaver ```sh settings put secure screensaver_components com.amazon.bueller.photos/.daydream.ScreenSaverService ``` ### To restore the default (older) Android TV backdrop screensaver ```sh settings put secure screensaver_components com.google.android.backdrop/.Backdrop ```

Weather data

Thanks to OpenWeather for providing weather data to this and other open-source projects.

OpenWeather logo

About

Aerial Views is based on Aerial Dream, which was created by Daniel Cachapa in late 2015.

Aerial Views started in early 2020 as a fork with a couple of fixes and features to improve the experience on an old Sony Android TV. Around this time, Aerial Dream was not in active development anymore.

Shortly after putting the code on GitHub, others found the fork and started requesting new builds with fixes and additional features. This led to the eventual release of Aerial Views on the Google Play Store in 2022, and later, the Amazon Appstore.