An open-source Linux OS for the Sanytron Astrion HA100 universal remote.
Couch brings your TVs, media players, speakers and smart-home devices together on a dedicated remote. Use its physical buttons and touchscreen for everyday control, and configure your setup from a browser.
Project site · Kernel source · Discord
- Organize devices into rooms and activities, with custom buttons and scenes.
- Control devices through infrared and network integrations.
- Manage connections, button mappings and appearance through the web UI.
Couch runs directly on the HA100 hardware, replacing its Android interface with a Slint GUI, Rust services and an Alpine Linux userland.
Couch installs from a Linux or macOS computer over USB, with the large transfers carried by Wi-Fi. Start Android on the HA100, enable USB debugging, connect the remote, then run the pinned installer for the current prerelease in a terminal:
curl -fsSL https://github.com/Couch-OS/couch-installer/releases/download/installer-v0.2.2/install.sh | shWindows users run install.ps1 from the same release in PowerShell. The script
downloads the installer binaries and release descriptor for your platform,
verifies their sizes and SHA-256 hashes against the values pinned inside the
script, and only then starts the installer. Nothing runs on a mismatch. On
Windows the installer talks to the remote through the serial ports Windows
creates by itself, so no driver setup is needed; the installer guide
has the details. Once the remote is on your Wi-Fi, open http://couch.local
from any browser on the same network to configure it.
The installer saves your remote's original Android partitions and identity before writing anything, and it can later reinstall Couch or restore stock Android from those saved originals. Keep that backup folder. The releases are prereleases under active hardware validation; see the installer guide, the Wi-Fi installer notes and restoring stock Android.
Questions, install reports and hardware findings are welcome on the Couch Discord server. Bugs go to the issue tracker.
See the repository guide, web UI guide and kernel build guide. Hardware work starts with the partition layout and recovery guide.
To write an independently installable integration, start with the integration developer guide and catalog admission requirements. The migration readiness matrix maps the existing built-in clients to the current package boundary. These Markdown pages are also the source for the website's developer documentation.