shrmt
shrmt is a GTK4 + layer-shell remote control app for NVIDIA SHIELD TV.
Runtime dependencies
gtk4gtk4-layer-shell
Arch:
sudo pacman -S gtk4 gtk4-layer-shell
Build
make build
This writes the binary to ./bin/shrmt.
Install
make install
This installs shrmt to ~/.local/bin/shrmt by default.
Run
Launch the GTK app:
shrmt
Run from source:
go run ./cmd/shrmt
CLI examples:
shrmt discover
shrmt pair --host <shield-ip>
shrmt key home --host <shield-ip>
Remote layout
Top to bottom: Volume and Power toolbar (Volume reveals Vol-, Mute, Vol+), D-pad with OK, Back/Home/Menu, Rewind/Play-Pause/Fast-forward, app shortcuts, Close. Power sends a single toggle; the SHIELD decides on or off. sleep and wakeup remain available in the CLI.
Power and app shortcuts over the NVIDIA protocol
Power and app shortcuts use NVIDIA's own protocol (TLS port 8987), the one the official app uses, which also wakes the SHIELD from sleep. Pair it once with the PIN shown on the TV:
go run ./cmd/beyonderprobe pair --host <shield-ip>
Without these credentials, Power and app shortcuts fall back to the Android TV remote protocol. Other buttons always use the Android TV remote protocol. See research/beyonder-protocol.md.
Keyboard: arrows, Enter/Space (OK), Backspace (Back), h (Home), Menu key (Menu), , (Rewind), . (Fast-forward), p (Play/Pause), m (Mute), +/- (Volume).
Credentials and target storage
shrmt uses:
~/.config/shrmt/androidtv-client-cert.pem~/.config/shrmt/androidtv-client-key.pem~/.config/shrmt/target.json~/.config/shrmt/beyonder-client-{cert,key}.pem,beyonder-device-id(NVIDIA protocol)
Testing
make test
Mocks
Mockery v3 config lives in .mockery.yaml.
make mock