[{"_1":2,"_153":-5,"_154":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_132":133},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_85":-5,"_86":87,"_125":-5,"_126":11,"_127":17,"_128":11,"_129":-5,"_130":131},"canonicalUrl","https://hub.docker.com/r/sytone/python-firetv/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","sytone","reponame","python-firetv","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":65,"_66":67,"_68":11,"_69":29,"_70":71,"_76":17,"_77":78,"_82":29,"_83":84},"categories",[],"content_types",[40],"image","date_registered","2016-11-20T06:03:30.543985Z","description","Docker container to run the python2 fire tv service to remotely control fire tv instances. ","is_private","last_updated","2017-08-02T18:46:31.8053Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[52],"application/vnd.docker.container.image.v1+json","name","pull_count",403363,"repository_type","star_count",4,"status",1,"status_description","active","source","collaborator_count",0,"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## Manual Installation\n\nInstall the following ADB dependencies via your package manager:\n\nwith `apt-get`: `swig libssl-dev python-dev libusb-1.0-0`\n\nwith `yum`: `swig openssl-devel python-devel libusbx-devel`\n\nBe sure you install into a Python 2.x environment.\n\n`pip install firetv`\n\nIf you want the HTTP server component installed as a script, use:\n\n`pip install firetv[firetv-server]`\n\nConsider installing `adb` directly from the git repository. It contains bugfixes not in the pip-packaged version:\n\n`pip install git+git://github.com/google/python-adb.git@master`\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### systemd\n\nCopy the `firetv.service` file to `/etc/systemd/system/`. Modify the `ExecStart` path and arguments as necessary.\n\n```bash\nsystemctl enable firetv.service # Enable on boot\nsystemctl start firetv.service # Start server\nsystemctl stop firetv.service # Stop server\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## Docker Installation\nIf you want to skip the manual work above the following steps will get a docker container up and allow you to mount a volume for the configuration. This example is for Windows, change the paths to match your operating system. \n\n```powershell\ndocker run -d --restart=always -v F:/docker/firetv/config:/config --name python-firetv -p 5556:5556 sytone/python-firetv -c /config/house.yaml\n```\n\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\n\n## Local development using Docker\n\nRun the following commands in the root of this repo to generate a docker container and run the tool. Update folders as needed, this assumes you have a test configuration file in ./config\n\n```powershell\n$currentPath = (get-Location).Path\n$currentPath = \"{0}/config\" -f $currentPath.Replace('\\','/')\ndocker build -t local-docker-firetv -f .\\Dockerfile.development .\\; docker run -it --rm -v $(\"{0}:/config\" -f $currentPath) --name local-python-firetv -p 5556:5556 local-docker-firetv -v -c /config/house.yaml\n```\n\n\n","has_starred","hub_user","immutable_tags_settings",{"_72":11,"_73":74},"enabled","rules",[75],".*","is_automated","permissions",{"_79":17,"_80":11,"_81":11},"read","write","admin","user","storage_size",1207190516,"orgData","recentTags",[88],{"_89":40,"_90":91,"_92":93,"_94":95,"_96":97,"_46":114,"_115":91,"_116":29,"_117":52,"_53":118,"_119":120,"_121":-5,"_122":114,"_123":112,"_124":17},"content_type","creator",741196,"full_size",299469024,"id",6249818,"images",[98],{"_99":100,"_101":102,"_103":104,"_105":-5,"_106":-5,"_107":108,"_109":104,"_110":-5,"_111":93,"_59":112,"_113":-5},"architecture","amd64","digest","sha256:71071dfd0909ad3ae4e6aed117e25b37e74138df99da4ed1f08a519b3aa422f0","features","","last_pulled","last_pushed","os","linux","os_features","os_version","size","inactive","variant","2017-08-02T18:46:31.457607Z","last_updater","last_updater_username","media_type","latest","repository",1059523,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":134,"_141":142,"_130":151,"_152":11},{"_36":135,"_38":136,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":137,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":65,"_66":67,"_68":11,"_69":29,"_70":138,"_76":17,"_77":140,"_82":29,"_83":84},[],[40],[52],{"_72":11,"_73":139},[75],{"_79":17,"_80":11,"_81":11},"tags",{"_143":60,"_144":-5,"_145":-5,"_146":147},"count","next","previous","results",[148],{"_89":40,"_90":91,"_92":93,"_94":95,"_96":149,"_46":114,"_115":91,"_116":29,"_117":52,"_53":118,"_119":120,"_121":-5,"_122":114,"_123":112,"_124":17},[150],{"_99":100,"_101":102,"_103":104,"_105":-5,"_106":-5,"_107":108,"_109":104,"_110":-5,"_111":93,"_59":112,"_113":-5},[],"canDeleteTags","actionData","errors"]

sytone/python-firetv

Tags for sytone/python-firetv