Skip to content

Couch installer v0.2.1

Pre-release
Pre-release

Choose a tag to compare

@dangerouslaser dangerouslaser released this 22 Sep 17:54
db5844d

Superseded by installer v0.2.2, which fixes the installer refusing a USB bus number of 0 and stopping with "Asking the remote over USB failed". The published install commands point at v0.2.2.

Couch installer v0.2.1

This update changes only the installer. It installs the same Couch OS as
v0.2.0: alpha .215 (v0.1.0-alpha.20260922.215), the very same image file.

New

Reinstall without the saved Android enrollment. "Reinstall existing Couch"
can now carry on without the folder your first install saved. Before it writes
anything, the installer checks that the remote really is running Couch, and it
saves the remote's calibration first. The trade-off: after a reinstall like
this, "Restore stock Android" is not available for that remote.

Remotes stuck starting into COUCH RECOVERY can be reinstalled. If your
remote keeps starting into COUCH RECOVERY, the installer offers to clear that
and restart the remote straight into the installer. Not on Windows yet: there,
use "My remote shows COUCH RECOVERY" first.

Fixed

A retry no longer lands in COUCH RECOVERY. The reinstall now waits until
Couch has fully started before it restarts the remote.

Improved

Saved enrollments are easier to pick. The list shows the date each one was
saved, newest first. The installer remembers a folder only once it has actually
matched your remote. If a folder doesn't match, it tells you what changed and
points you to a folder that does.

Windows note

Before restarting the remote, the installer now checks it over USB. On Windows
this check uses the remote's COM port, and it has not been tested on Windows
hardware yet. If it can't connect, you restart the remote with its Power button,
as before.

Install

Linux x64 and macOS, from an interactive terminal:

curl --fail --location --proto '=https' --tlsv1.2 \
  https://github.com/Couch-OS/couch-installer/releases/download/installer-v0.2.1/install.sh | sh

Windows x64, from PowerShell:

Invoke-RestMethod 'https://github.com/Couch-OS/couch-installer/releases/download/installer-v0.2.1/install.ps1' | Invoke-Expression

Verification

  • The install script checks the size and SHA-256 of everything it downloads
    from this release, and starts nothing if one doesn't match.
  • SHA256SUMS lists the SHA-256 of every other file in this release.
  • release-provenance.json records where everything came from: the programs
    were built by this repository's Build installer binaries workflow,
    run 35757327317,
    from commit db5844d4329c21b3c1e7639e2cf99da9a010658a, and the source for
    that commit is in couch-installer-source.tar.gz.