Android TV OS (ATV OS) device set up

This guide will walk you through the process of setting up your Android device, whether it’s a Set-Top Box (STB) or a Smart TV, to work seamlessly with our IPTV apps (Webplayer and Rover app).

To ensure smooth operation, it's important to follow specific steps for configuration, including installing necessary applications, enabling developer settings, and optimizing the device to boot directly into the IPTV apps. This guide covers everything from the initial setup to troubleshooting common issues, tailored to various brands and models.

Table of contents:

1 Applicable devices for this manual

This manual covers the setup of Set-Top Boxes (STBs) with ATV OS. The same instructions apply to Smart TVs with Android TV OS or any device running ATV OS.

Devices tested successfully with our Rover and WebPlayer apps:

• Nevron s905x STB with casting feature

• Dahua DS Player TV*

• TCL*

• Sharp*

• Hisense*

• Sony*

Note*: Testing is essential because some models have insufficient RAM, causing our apps to be terminated to free up memory for the OS and some models are preventing installing unknown apps from the USB.

2 Preparing an android device with the proper settings

To install apps on your device, you'll need to log in to a Google account. If you don't have one, you can create a new account or check with your project team if they have a shared account available. Once the apps are installed, they will remain on the device and continue to work even if you log out of the account.

Steps to follow:

1. Connect the STB/TV to the Internet.

2. Log in to your Google account (or client’s account). This step is crucial as you won't be able to proceed without it. You can delete the Google account later if needed.

3. Install a File Manager:

   • Open the Google Play Store and search for the File Manager app (blue folder icon).

   • Install the File Manager app on your device.

4. Activate Developer Mode:

   • Go to Settings → Device Preferences → About.

   • Tap on the build version more than 7 times consecutively. You will see a message indicating you are now in developer mode.

5. Enable USB Debugging:

   • Once Developer Mode is activated, go to Device Preferences → Developer Options → USB Debugging.

   • Enable USB Debugging by checking the box.

   • While you are there, enable Stay awake option

6. Disabling the Screensaver

• To disable the screensaver, follow these steps in two different locations.

1. Go to Device Preferences → Screensaver.

   1. Set the Screen saver option to "TURN OFF".

   2. Adjust the When to start setting to "After 2h".

   3. Set the Sleep option to "NEVER".

By following these steps, you'll effectively prepare the device for our IPTV apps, disabled the original android screensaver and enabled awake option. In the next step you will install our apps.

3 Installing Nevron IPTV apps

Follow these steps to install the Nevron IPTV apps on your device:

Step 1: Obtain the Apps

1. Contact Nevron support at support@nevron.eu to get the latest versions of the Webplayer app and Rover app.

Step 2: Prepare the USB stick

1. Use a USB 2.0 stick, as most TVs do not accept USB 3.0.

2. Transfer the Webplayer app and Rover app files to the USB stick.

Step 3: Access the File Manager app

1. Insert the USB stick into the device.

2. Open the File Manager app on your device.

Step 4: Uninstall the default Webplayer app

1. Go to Settings.

2. Select Apps.

3. Look for System apps and find the Webplayer app.

4. Select the Webplayer app and uninstall it.

Step 5: Install the new apps

1. In the File Manager app, locate the Webplayer app and Rover app files on the USB stick. When it asks for permission to install unknown apps from the File manager you set Yes.

2. Then install the Rover app. Wait for the confirmation that it is installed.

3. Install the Rover Modules app. This is needed only if Rover app would fail the installation.

4. Finally, install the Webplayer app. Wait for the confirmation that is is installed.

By following these steps, you will have successfully installed the Nevron IPTV apps on your device.

4 Setting the Homepage on the Nevron Webplayer App

Follow these steps to set the homepage on the Webplayer app. App is basically the web browser app and we need to set which webpage URL it needs to open.

Step 1: Webplayer app configuration

1. Webplayer app version: a newer version. Web-player-nevron-2.15-R6-release.zip or a newer version includes a built-in default webpage link to <http://stv.base.ntv.> which means it should connect to the IPTV server by default. Otherwise the app will show black screen and you need to set the URL manually with the commands from the server (only from the server).

2. Edit homepage URL on newer Webplayer:

   • Open the newer Webplayer app.

   • Press the button 1590 to view and edit the homepage URL.

   • The screen should look like this and it means it has a default URL set.

Open

Step 2: Set manually the homepage on the Webplayer App

1. Check current homepage:

   • Ensure your TV is visible on the Rover tool and check its current homepage using the following command:

     rstb all get fw

   • Locate your device's MAC or IP address from the results.

Open

2. Set the homepage:

   • Use the commands below to set the homepage (replace 192.168.200.10 with your device's IP address). Note: PROP works on older OS versions, while CONF works on newer ones.

     rstb all get prop:persist.nevron.webp.home rstb all get conf:persist.nevron.webp.home

   • If the homepage field is empty or you want to edit it, set it using:

     rstb 192.168.200.10 set conf:persist.nevron.webp.home http://stv.base.ntv/

3. Enable ADB mode for future access

1. Enable ADB Mode:

   • Execute the following commands to enable ADB mode on your STB (replace 192.168.200.10 with your device's IP address):

     adb disconnect adb connect 192.168.200.10

   • On your TV, select the checkmark for "Always" and press the Confirm button.

By following these steps, you will have successfully set the homepage on the Webplayer app and configured the STB for future access.

5 Setting our apps to boot automatically

To hide the original Android dashboard and boot directly into the Nevron Web Player app, follow these steps. This configuration is ideal for hotels, but residential users may prefer to keep the Android dashboard visible.

General commands:

Replace "192.168.200.10" with the IP of your STB (this is just an example):

After executing these commands, your STB should boot directly into the Web Player app. The STB will appear in our IPTV Administration under the Devices menu. If you have DHCP limited, register the STB in Device Registration first.

Specific TV brands:

Some TV brands use different operating systems and require different commands. Try each command using the ADB tool and RSTB tool to see which one works. Once you find the correct command, document it in the project list or search for updated commands online.

Sharp Smart TV:

JSW:

TCL:

By following these steps, you can configure your STB or TV to boot directly into the Web Player app, ensuring a seamless user experience for IPTV.

3 Linking installed apps

With our IPTV Administration, you have the flexibility to link any installed app to your IPTV dashboard. This means that you can install any desired apps from the Google Play Store and then collect their package names. (Mostly used are games apps, news apps, weather apps or tools like VLC or Kodi.) Subsequently, you can insert the app package names in our IPTV Administration, specifically under the Services → Entertainment → Apps menu.

To link an installed app to your Smart TV, follow these steps:

1. Obtain the app's package name, such as [A]com.google.android.youtube.tv.

Note: You can google for package name or see it in Google Play Store link. After the = mark in the link is a package name. Use YouTube as an example to check. There is also a command to check on device ( rstb IP apk.list ).

1. Access the IPTV Administration and navigate to the Services → Entertainment → Apps menu.

2. In the "App links - Smart TV" column, add the app package name following the specified format.

By utilizing this feature, you can easily integrate your preferred apps into the IPTV dashboard, offering seamless access to a wide range of content.

Open

4. Additional info

• BT remotes: If the device utilizes Bluetooth technology for communication with the remote control, it provides the flexibility to pair any Bluetooth remote with the TV. This means you have the option to purchase and use any Bluetooth remote that is compatible with the device.

  In some cases, we may include our simplified Bluetooth remotes as part of the project. These remotes are designed to have fewer buttons and offer a more streamlined user experience.

  By leveraging Bluetooth connectivity, you have the freedom to choose a remote control that suits your preferences and requirements, providing convenience and flexibility in controlling your TV.

• ATV OS versions: Android operating systems can have different versions, and one of them is the OEM (Original Equipment Manufacturer) version.

  The OEM version of Android is typically customized and tailored by the device manufacturer to suit their specific hardware and software requirements. It often includes modifications, optimizations, and additional features specific to that particular device or brand. These modifications can include changes to the user interface, pre-installed apps, system settings, and more. They may restrict things, for example in Philips commercial ATV you are not allowed to install apps other than over Play Store.

  On the other hand, the non-OEM version of Android, often referred to as the "stock" or "vanilla" Android, is the version provided by Google. It is the base version of Android without any customizations or modifications made by device manufacturers.

  It's important to be aware of the specific version and variant of Android you're using, as it may impact the available features, settings, and compatibility with certain apps or configurations.

5. Additional commands:

• Check what home page is set:

• Enable Android original Dashboard

• Uninstall Rover: To uninstall Rover using ADB, execute the following command:

• Launch Rover over ADB: Use the following command to launch Rover via ADB:

• Enable Android Dashboard: If you want to enable the Android Dashboard on the STB, use the following command (replace "192.168.200.10" with the IP of your STB):

 Related articles