aio_androidtv.firetv module

Communicate with an Amazon Fire TV device via ADB over a network.

ADB Debugging must be enabled.

class aio_androidtv.firetv.FireTV(host, port=5555, adbkey='', state_detection_rules=None)

Bases: aio_androidtv.basetv.BaseTV

Representation of an Amazon Fire TV device.

Parameters

• host (str) – The address of the device; may be an IP address or a host name

• port (int) – The device port to which we are connecting (default is 5555)

• adbkey (str) – The path to the adbkey file for ADB authentication

• state_detection_rules (dict, None) – A dictionary of rules for determining the state (see BaseTV)

DEVICE_CLASS = 'firetv'

async get_properties(get_running_apps=True, lazy=False)

Get the properties needed for Home Assistant updates.

This will send one of the following ADB commands:

• aio_androidtv.constants.CMD_FIRETV_PROPERTIES_LAZY_RUNNING_APPS

• aio_androidtv.constants.CMD_FIRETV_PROPERTIES_LAZY_NO_RUNNING_APPS

• aio_androidtv.constants.CMD_FIRETV_PROPERTIES_NOT_LAZY_RUNNING_APPS

• aio_androidtv.constants.CMD_FIRETV_PROPERTIES_NOT_LAZY_NO_RUNNING_APPS

Parameters

• get_running_apps (bool) – Whether or not to get the running_apps() property

• lazy (bool) – Whether or not to continue retrieving properties if the device is off or the screensaver is running

Returns

• screen_on (bool, None) – Whether or not the device is on, or None if it was not determined

• awake (bool, None) – Whether or not the device is awake (screensaver is not running), or None if it was not determined

• wake_lock_size (int, None) – The size of the current wake lock, or None if it was not determined

• current_app (str, None) – The current app property, or None if it was not determined

• media_session_state (int, None) – The state from the output of dumpsys media_session, or None if it was not determined

• running_apps (list, None) – A list of the running apps, or None if it was not determined

async get_properties_dict(get_running_apps=True, lazy=True)

Get the properties needed for Home Assistant updates and return them as a dictionary.

Parameters

• get_running_apps (bool) – Whether or not to get the running_apps() property

• lazy (bool) – Whether or not to continue retrieving properties if the device is off or the screensaver is running

Returns

A dictionary with keys 'screen_on', 'awake', 'wake_lock_size', 'current_app', 'media_session_state', and 'running_apps'

Return type

dict

async running_apps()

Return a list of running user applications.

Returns

A list of the running apps

Return type

list

async turn_off()

Send SLEEP action if the device is not off.

async turn_on()

Send POWER and HOME actions if the device is off.

async update(get_running_apps=True)

Get the info needed for a Home Assistant update.

Parameters

get_running_apps (bool) – Whether or not to get the running_apps() property

Returns

• state (str) – The state of the device

• current_app (str) – The current running app

• running_apps (list) – A list of the running apps if get_running_apps is True, otherwise the list [current_app]