Omahub
← All plugins
M

Fire TV Remote

by Matthieu G.C.

Keyboard-driven Fire TV Stick remote with Netflix/Prime/Disney+, ADB discovery, and device switching

GitHub

Security review

Review recommended · 1 finding

Deterministic scan — not a security guarantee

Medium
Risk level
Medium
Analyzed commit
a888578
Scanned
1 month ago
  • medium package_manager fire-tv-remote:102

    System-wide Python package installation (not --user).

    pip install \

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

Language-model assessment · ~deepseek/deepseek-v4-flash-latest — advisory only

Low
AI risk level
Low
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
a888578
Reviewed
1 month ago

The plugin is a legitimate Fire TV remote control using network ADB. The deterministic scan flagged a system-wide pip install, but the install actually runs inside a dedicated Python virtualenv under the user's data directory, so it is isolated and not a real risk. No obfuscation, persistence, credential theft, or destructive behavior was found.

  • The pip install is performed inside a per-user virtualenv, not system-wide; the deterministic finding is a false positive.
  • The plugin uses network ADB, which requires the user to enable ADB debugging on the Fire TV; this is expected functionality and user-consented.
  • Discovery uses avahi-browse and a port scan, but output is bounded and parsed safely; no arbitrary command execution from network data.
How this check works

This review combines the deterministic scan (the rule-based results above) with an independent look at the plugin's code by a language model. The model reads a trimmed sample of the repository's files, the manifest, and the README, then gives a plain-language risk level and a recommendation: install (no notable danger), review (look closer first), or avoid (clearly dangerous).

It runs on the same analyzed commit as the deterministic scan and is strictly advisory — it is not a security guarantee and never blocks a plugin by itself. A human moderator still reviews plugins before they are listed.

AI advisory only — automated analysis, not a security guarantee.

Install
$ omarchy plugin add https://github.com/ypMrg/omarchy-fire-tv-stick-remote --enable
Widgets #bar #quickshell #media

Fire TV Remote for Omarchy

Control an Amazon Fire TV Stick from the Omarchy Quattro bar with the mouse or keyboard. The plugin uses network ADB and includes shortcuts for Netflix, Prime Video, and Disney+.

Install

omarchy plugin add https://github.com/ypMrg/omarchy-fire-tv-stick-remote.git --enable

The first launch creates an isolated Python environment and installs adb-shell==0.4.4.

Update or remove the plugin with:

omarchy plugin update io.github.ypmrg.fire-tv-remote
omarchy plugin remove io.github.ypmrg.fire-tv-remote

Setup

  1. On the Fire TV, open Settings → My Fire TV → About.
  2. Press Select seven times on the device name to unlock developer mode.
  3. Open Developer options and enable ADB debugging.
  4. Open the Fire TV widget, then select Devices.
  5. The plugin scans automatically. Select Connect Host, accept the Allow USB debugging prompt on the TV, then retry if requested.

Discovery first parses:

avahi-browse -rtpk _amzn-wplay._tcp

It extracts the Fire TV name and IPv4 address from the mDNS response. ADB mDNS and a bounded scan of port 5555 are used as fallbacks.

If discovery finds nothing, enter the IPv4 address shown under Settings → My Fire TV → About → Network. Port 5555 is used by default.

Controls

Key Action
Arrows / H J K L Navigate
Enter Select / OK
B Back
G Home
M Menu
P Play / pause
− / + Volume
W / S Wake / sleep
1 / 2 / 3 Netflix / Prime Video / Disney+
D Devices
Esc / Q Close

Requirements

  • Omarchy Quattro
  • Python 3.9+ with venv
  • Fire TV and computer on the same LAN
  • ADB debugging enabled on the Fire TV
  • avahi-browse recommended for immediate discovery

Credits

This plugin is adapted almost entirely from the Omarchy bar-widget and session design by Thomas Evans:
Author Thomas Evans (teevans)
Apple TV original omarchy-apple-tv-remote
License MIT

Have an Apple TV? Use his plugin — it is the original implementation for Apple TV. This repository adapts that design for Fire TV Stick over network ADB.

License

MIT — Copyright (c) 2026 Matthieu G.C.

The logos in assets/ remain trademarks of their owners; see assets/README.md.