Android TV Automation Tool with GUI

Overview

This is an automation tool based on DAAF framework, atvAuto added a Graphical User Interface to be able to see clearly the current test case running

How to use:

Requirements:

Python3 and Android Platform tools (ADB) are installed and in PATH.
Clone or Download this Repo

Running Script:

All the Python file in root folder are pre-made script, simply run it via Python terminal
```
c:\atvAuto> python demo.py
```
You should see the screen below; Enter how many loops you want the script to repeat then click "Start" button

How to make your own:

Create a new python file inside the root folder /atvAuto.
Copy the code from the file template.py to your new script file.

Update the boilerplate like below:

First the __init__ function, change the "Template" text, this will be the Title Header of the script. And set the self.playback_time based on long you want the script to playback the content. (this takes a number equivalent to minutes of playback)

def __init__(self, tkRoot):
  """ Initialize the UI and then Set Title Header"""
  # Update the string "Template" to your desired Title
  super().__init__(tkRoot, "Template")

  # this is in minutes
  self.playback_time = 1

Second, the testCaseInfo function, this contains the instruction shown on the left side of the script, Each call of the 'makeInstructionLabel' function is one new line.

def testCaseInfo(self):
        """ 
        Set the test case info
        This is the one that shows on the left side of the screen
        Each call of the 'makeInstructionLabel' is one line
        """
        self.makeInstructionLabel("Press Power Key")
        self.makeInstructionLabel("Wait 5 seconds")

Lastly, the runThis function, is where the test cases will be assembled: For more info about the test cases see the documentation below.

def runThis(self):
        """
        Below is where you assemble test cases
        """

        # Press RC POWER Key
        self.press_rc_key("POWER")
        self.wait_second(3)

Documentation:

Below is a list of pre-defined test cases that you can use for creating an automation script inside the function runThis

Pause and Input
- self.wait_second(time) - Pause for a specified time as seconds.
- self.wait_minute(time) - Pause for a specified time as minutes.
- self.launch_tv_input() - Press TV RC key.
- self.launch_hdmi_input("INPUT KEYCODES") - Launch the specified HDMI keycode. Must be a string. (Check the Special keycodes for input in the List of RC Keycodes)
Press RC Keys
- self.channel_down() - Press Channel Down RC key.
- self.channel_up() - Press Channel Up RC key.
- self.volume_down() - Press Volume Down RC key.
- self.volume_up() - Press Volume Up RC key.
- self.press_home() - Press Home RC key.
- self.press_ff() - Press Fast Forward RC Key.
- self.press_rw() - Press Rewind RC Key.
- self.press_play() - Press Play RC Key.
- self.press_rc_key("RC KEYCODE") - Press the specified RC keycode, must be a string. Check RC Keycodes below (SonyRCKey)
Launch and Playback Apps
- self.launch_netflix() - Launch Netflix using ADB am start command, this will clear the app from memory before launching it.
- self.select_netflix_content() - Select a content for netflix then start playback.
- self.playback_netflix(time) - Pause the script to let the content plaback for the specified time as minutes.
- self.launch_amazon() - Launch Netflix using ADB am start command, this will clear the app from memory before launching it.
- self.select_amazon_content() - Select a content for amazon then start playback.
- self.playback_amazon(time) - Pause the script to let the content plaback for the specified time as minutes.
- self.launch_hulu() - Launch Netflix using ADB am start command, this will clear the app from memory before launching it.
- self.select_hulu_content() - Select a content for hulu then start playback.
- self.playback_hulu(time) - Pause the script to let the content plaback for the specified time as minutes.
- self.launch_vudu() - Launch Netflix using ADB am start command, this will clear the app from memory before launching it.
- self.select_vudu_content() - Select a content for vudu then start playback.
- self.playback_vudu(time) - Pause the script to let the content plaback for the specified time as minutes.
- self.launch_youtube() - Launch Netflix using ADB am start command, this will clear the app from memory before launching it.
- self.select_youtube_content() - Select a content for youtube then start playback.
- self.playback_youtube(time) - Pause the script to let the content plaback for the specified time as minutes.
- self.launch_psvue() - Launch Netflix using ADB am start command, this will clear the app from memory before launching it.
- self.select_psvue_content() - Select a content for psvue then start playback.
- self.playback_psvue(time) - Pause the script to let the content plaback for the specified time as minutes.

List of RC Keycodes