This guide will tell you everything you need to know on your android device.

Tested devices

• X96H
  

Q-Play android device requirements

1. Android 7 and above
2. Android WebView is Chrome WebView and version is equal or above version 75.0

Prerequisites for script install and uninstall routine

1. PC
2. An rooted Android device (with available space)
3. Q-Play Android install package. The download link HERE
4. Python v.3. The download link HERE (Remember to check the box "add to path")
5. EX96h requires USB TYPE A-A (Male Male) - Use USB port in the rear.

Disclaimer:

• It is customers own responsibility device is kept up-to-date with security and and Chrome WebView updates.

Initial device setup (Based on X96H)

0. Install newest Python if not already installed on PC

1. Unzip the Q-Play install package on PC

2. Open a terminal or windows command prompt and navigate to location of the unzipped Q-Play install package

3a. Connect USB cable  between Android device and PC, as well as connecting an Ethernet cable to the Android Device.

    Beware: if the device has multiple USB ports, often only one of them is enabled for USB debugging. In example on the X96H only the USB port in the rear works.

3b. Connect PC to Android device via the same network (via WiFi or Ethernet).

    Beware: Android device must support this option and both PC and Android device need to be connected to the same network. On some devices an extra option need to be enabled in Android Developer menu.

4. On the most android devices and X96H enable Developer Mode by entering Device Settings > About and scroll down to the Build Number, highlight the number and press until a message to the effect of "You are now a developer" is prompted. Then exit About and enter Developer Options and scroll down to USB Debugging and make sure that it is enabled along with the USB option beneath it.

5. Type in click the file / script in AndroidInstallPackage where the filename match operating system. Then follow the steps. If no devices is listed below "List of devices attached". Type in 'q' or 'Q' to abort install process.

   Troubleshooting missing device:

    1. Then check connection between PC and Android device

    2. Check Developer mode is enabled.

    3. If multiple USB ports on device, try another USB port.

    4. Check cable or change cable, some devices require the USB to be and OTG cable.

    5. Check the Android device IP, i the same that was used in step 3b.

    Every time check if the device is available, just start over step 5.

Ex. of how the setup should look like if a device is connected. In this example a device called X96H is connected. I have marked the transport ID in bold below:

List of devices attached

fc00140a088646f2391    device usb:339935232X product:petrel_h603 model:X96H_PRO device:petrel-h603 transport_id:187

6. In the install steps you will be prompted a second time for device "transport ID" after the devices has rebooted. During the install the device will be rebooted two times. It is important to complete the reboot during the install process to be complete.

7a. Install: After the second manual reboot, if Q-Play automatically starts the device is ready for use. In the control panel it is possible to setup WiFi connection.

7b. Un-install: When un-install is selected, it will reboot once when the un-install process is complete.

Deploy guide

Requirements

• Target-device: Android. The devices on which you want to install the Q-Play Android App on
• Host-device: Android device. This device will be used as a controller for deploying the app.
   On this we install a 3.rd party app called Bugjaeger. This creates and ADB (Android Debug Bridge) to the target device.
• USB OTG-cable

First-time step. (To prepare HOST device)

Initially (only needed first time you prepare your HOST-device that will be used to deploy)

1. Install 3.rd party app: Bugjaeger on HOST-device
   https://play.google.com/store/apps/details?id=eu.sisik.hackendebug&hl=en_US
2. Download the Q-play app so it is available on HOST-device.
   https://1.playerapi.q-play.net/releases/android/q_play_player-0.38.15.apk
3. Open Bugjaeger. Select menu-element: COMMANDS. Click (+) to create a script
   Name the script: “Q-play device owner”
   In the shell-script type: dpm set-device-owner net.q_play.player/.DevAdminReceiver
    Click save.

Deploy Q-Play on a target-device

1. Enable USB debugging on target-device.
   1. Enable the USB Debugging option under Settings > Developer options.
   2. For Android 4.2 and newer, Developer options is hidden by default; use the following steps:
   3. On the device, go to Settings > About <device>.
   4. Tap the Build number seven times to make Settings > Developer options available.
2. Connect USB OTG-cable between target-device and host-device.
    A popup will appear on host-device. Click OK to allow Bugjaeger to access the USB device.
3. Open Bugjaeger App on HOST-device
4. Ensure that the device appears in upper-right menu. (Otherwise try Restart ADB server + refresh device list in upper-right menu).
5. Select menu-element: PACKAGES
6. Click (+)
7. Choose “Select APK file”
8. Navigate to “DOWNLOAD” folder. (Or just recent if this is not the first install)
9. Select Q_play_player apk file
10. The APP will now be installed on target.
11. Next – we need to set device-admin-owner on target to Q-play app
12. In Bugjaeger. Select menu-element: COMMANDS
13. Scroll down and select play button on the script “Q-play device owner”

ViewSonic TV with android 8 

Before you start, please make a USB drive ready with min. 256MB or FAT32 format.

1. Download the latest version of q-play android player and save it on your USB drive.
   - The filename will look alike this: Q-play-2.1.1.apk
   
   
2. Place the USB drive in the first USB port baved in your viewSonic screen
   
   
3. Turn on the TV and make sure that you are on the main menu
   - You can navigate in the menu by using the arrow on the remote. You can also connect a wireless keyboard or a mouse on the other available USB port for easier navigation
   
   
4.  Open folders and navigate the usb storage where you can find the Q-play apk file
   
   
   
5. Click on the file and follow the instructions on the screen
   
   
   
   
6. The Q-play android app is now ready to be used. 
   
   
7. Follow our setup guide if it your first time using our app.

Do you experience problems with the installation? Please see the producents guide HERE

Please note - ViewSonic isn't approved as official Q-play hard

How to delete Q-play.

1. Press on the OK bottom on your remote
   
   
2. Enter the code 8920 as pin code
   
   
3. Press exit/close the app
   
   
4. Go to your apps
   
   
5. Find Q-play
   
   
6. Delete Q-play