[{"_1":2,"_161":-5,"_162":-5},"loaderData",{"_3":4,"_17":18,"_25":26,"_140":141},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7,"_13":14,"_15":16},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","theme","system","contrast","normal","routes/_layout",{"_19":-5,"_20":21,"_22":21,"_23":11,"_24":21},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_27":28,"_29":-5,"_30":11,"_31":11,"_32":33,"_34":35,"_36":-5,"_37":11,"_38":39,"_88":-5,"_89":90,"_129":-5,"_130":11,"_131":21,"_132":11,"_133":-5,"_134":11,"_135":-5,"_136":137,"_138":91,"_139":-7},"canonicalUrl","https://hub.docker.com/r/arraylabs/python-firetv/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","arraylabs","reponame","python-firetv","cloudBuildSource","isAutobuildsAvailable","repo",{"_40":41,"_42":43,"_45":46,"_47":48,"_49":11,"_50":51,"_52":53,"_54":55,"_57":35,"_32":33,"_58":59,"_60":-5,"_61":62,"_63":64,"_65":66,"_67":-5,"_68":62,"_69":70,"_71":11,"_72":33,"_73":74,"_79":21,"_80":81,"_85":33,"_86":87},"categories",[],"content_types",[44],"image","date_registered","2016-12-16T22:04:58.687688Z","description","python-firetv server","is_private","last_updated","2016-12-16T22:31:27.195933Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[56],"application/vnd.docker.container.image.v1+json","name","pull_count",144,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","# python-firetv\n\n`firetv` is a Python 2.x package that provides state information and some control of an Amazon Fire TV device over a network. This is achieved via ADB, so therefore requires [ADB Debugging](https://developer.amazon.com/public/solutions/devices/fire-tv/docs/connecting-adb-over-network) to be turned on. It includes `firetv-server`, an HTTP server to facilitate RESTful access to configured devices.\n\n## Installation\n\nInstall the following ADB dependencies via your package manager:\n\n`swig libssl-dev python-dev libusb-1.0-0`\n\nBe sure you install into a Python 2.x environment.\n\n`pip install firetv --process-dependency-links`\n\nIf you want the HTTP server component installed as a script, use:\n\n`pip install firetv[firetv-server] --process-dependency-links`\n\n## Server\n\nTo run the server when installed as a script:\n\n`firetv-server`\n\nIf you want to set a default Amazon Fire TV device:\n\n`firetv-server -d X.X.X.X:5555`\n\nIf you want to run on a port other than `5556`:\n\n`firetv-server -p XXXX`\n\n\n### Persistence\nTo store multiple Amazon Fire TV devices persistent, you can load a yaml config file:\n`firetv-server -c some/config/file.yaml`\n\nThe config file has to be in the following format:\n```yaml\ndevices:\n sleepingroom:\n host: 192.168.0.13:5555\n livingroom:\n host: 192.168.0.16:5555\n```\n\n*Note: If you use -d and -c option together you must not name one of the devices in config file `default` or give one of the devices the same host as in -d option.*\n\n### Routes\n\nAll routes return JSON.\n\n- `GET /devices/list` (list all registered devices and state)\n- `GET /devices/connect/` (force connection attempt)\n- `GET /devices/state/` (return state)\n- `GET /devices/action//` (request action)\n- `GET /devices//apps/running` (return running user apps)\n- `GET /devices//apps//start` (start an app)\n- `GET /devices//apps//stop` (stop an app)\n- `GET /devices//apps//state` (check app state)\n- `GET /devices//apps/state/` (check app state, deprecated format)\n- `POST /devices/add` (see below)\n\n#### Add A Device\n\nIf you use the `-d` option, the specified device is added automatically with the device identifier `default`. If you want to add further devices, or don't want to use the command line option for the initial device, use the `POST /devices/add` route. The device identifier can be any string meaningful to you, matching [`[-\\w]`](https://docs.python.org/2/library/re.html) (any alphanumeric character, plus `-`).\n\nPOST JSON in the following format with the HTTP header `Content-Type: application/json`:\n```json\n{\n \"device_id\": \"\",\n \"host\": \"

:\"\n}\n```\n\n## Features\n\n`firetv` can detect device state and issue a number of actions. It can also get the running state of user apps.\n\n### Detected States\n\n- `off` (TV screen is dark)\n- `standby` (standard UI is active - not apps)\n- `idle` (screen saver is active)\n- `play` (video is playing)\n- `pause` (video is paused)\n- `disconnected` (can't communicate with device)\n\n### Actions\n\n- `turn_on` (turn on the device, showing the UI on screen)\n- `turn_off` (turn off the device, screen goes dark)\n- `home` (emulate Home button)\n- `media_play_pause` (emulate Play/Pause button)\n- `media_play` (simulate Play button)\n- `media_pause` (simulate Pause button)\n- `media_next` (emulate Fast-Forward button)\n- `media_previous` (emulate Rewind button)\n- `volume_up` (raise volume)\n- `volume_down` (lower volume)\n\n### Apps\n\n- `GET /devices//apps/running`\n- `/devices//apps/state/`\n- `/devices//apps//state`\n\napp_id can be anything from a single word, e.g. 'netflix' or the full package name, e.g. com.netflix.ninja\n\nYou can start or stop an app with the following commands:\n\n- `GET /devices//apps//start` \n- `GET /devices//apps//stop` \n\napp_id must be a package name, e.g. org.xbmc.kodi or com.netflix.ninja\n\n## Python 3\n`firetv` depends on [python-adb](https://github.com/google/python-adb), a pure-python implementation of the ADB protocol. It and its dependency [M2Crypto](https://github.com/martinpaljak/M2Crypto) are written for Python 2. Until they support Python 3, or an alternative is available, `firetv` will not support Python 3. The HTTP server is provided as a way for Python 3 (or other) software to utilize the features of `firetv`.\n\n## Contribution\n\nThis package does not fully exploit the potential of ADB access to Amazon Fire TV devices, and lacks some robustness. Contributions are welcome.\n","has_starred","hub_user","immutable_tags_settings",{"_75":11,"_76":77},"enabled","rules",[78],".*","is_automated","permissions",{"_82":21,"_83":11,"_84":11},"read","write","admin","user","storage_size",319645312,"orgData","recentTags",[91],{"_92":44,"_93":94,"_95":96,"_97":98,"_99":100,"_50":118,"_119":94,"_120":33,"_121":56,"_57":122,"_123":124,"_125":109,"_126":118,"_127":66,"_128":21},"content_type","creator",79216,"full_size",291985979,"id",6910881,"images",[101],{"_102":103,"_104":105,"_106":107,"_108":109,"_110":111,"_112":113,"_114":107,"_115":-5,"_116":96,"_63":66,"_117":-5},"architecture","amd64","digest","sha256:ac00c3dfd40236222222824a1caeca3ce5d1aead30ffdeb4128a4a9043b5ee04","features","","last_pulled","2026-10-09T11:46:30.516958452Z","last_pushed","2016-12-16T22:31:27Z","os","linux","os_features","os_version","size","variant","2016-12-16T22:31:26.511095Z","last_updater","last_updater_username","media_type","dev","repository",1119524,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"selectedTag","attestationsUrl","routes/_layout.r.$namespace.$reponame.tags",{"_38":142,"_149":150,"_136":159,"_160":11},{"_40":143,"_42":144,"_45":46,"_47":48,"_49":11,"_50":51,"_52":53,"_54":145,"_57":35,"_32":33,"_58":59,"_60":-5,"_61":62,"_63":64,"_65":66,"_67":-5,"_68":62,"_69":70,"_71":11,"_72":33,"_73":146,"_79":21,"_80":148,"_85":33,"_86":87},[],[44],[56],{"_75":11,"_76":147},[78],{"_82":21,"_83":11,"_84":11},"tags",{"_151":64,"_152":-5,"_153":-5,"_154":155},"count","next","previous","results",[156],{"_92":44,"_93":94,"_95":96,"_97":98,"_99":157,"_50":118,"_119":94,"_120":33,"_121":56,"_57":122,"_123":124,"_125":109,"_126":118,"_127":66,"_128":21},[158],{"_102":103,"_104":105,"_106":107,"_108":109,"_110":111,"_112":113,"_114":107,"_115":-5,"_116":96,"_63":66,"_117":-5},[],"canDeleteTags","actionData","errors"]

arraylabs/python-firetv

Tags for arraylabs/python-firetv