Skip to content

Releases

annex v0.6.0

Choose a tag to compare

@github-actions github-actions released this 03 Nov 13:10
d12a6ca

Added

  • A CI profile for end-to-end tests on runners and headless machines. annex up --ephemeral deletes the instance and its data at annex down; --wait-boot also waits for the package manager; --timezone, --locale and --animations off set the instance up after boot.
  • annex serial [NAME] prints an instance's adb serial, and annex ls --json lists instances as JSON, so scripts no longer have to assume 127.0.0.1:5600.
  • annex doctor --json prints the checks as JSON; like annex doctor, it exits non-zero when a check fails.
  • annex setup --ci: never prompts (sudo must not need a password), skips the desktop bridge and Annex Manager, and fails when a step needs a person.
  • annex doctor and annex setup notice when they run in a container (such as an LXD CI runner) and say what to do on the host, instead of trying to load kernel modules.
  • annex net [NAME] online|offline|slow|lossy changes an instance's network until it restarts. offline blocks every installed app through Android's own firewall, so apps are told they have no network; slow and lossy shape the connection. adb always keeps working.
  • annex setup loads the kernel's traffic shaping modules on machines that don't load them on demand, and annex doctor checks for them.
  • annex record [NAME] start -o FILE and annex record [NAME] stop record an instance's screen to an MP4 or MKV file, in the background and without a window or time limit, so CI runs can keep video evidence.
  • annex logs [NAME] [-o FILE] [--since 10m] writes Android's log in logcat's threadtime format to a file or the terminal.

Changed

  • Without a desktop session, annex up no longer adds an app launcher entry, and annex doctor no longer warns about the clipboard, notifications and panel menu.

annex v0.5.1

Choose a tag to compare

@github-actions github-actions released this 30 Oct 14:17
2b716f2

Fixed

  • Opening the camera no longer crashes apps. Instances have no camera, but Android still said they had one, so apps went looking for it and the built-in Camera app crashed on the empty list. Instances now report no camera, as a phone without one would, and the Camera app is gone, so apps can tell there is nothing to take a photo with.

Changed

  • Container-mode instances rebuild on their next annex up to drop the camera; their data is kept.

annex v0.5.0

Choose a tag to compare

@github-actions github-actions released this 30 Oct 13:48
50bece6

Added

  • annex location takes coordinates copied from Google Maps (-1.2921, 36.8219) and Google Maps links, including short share links; a place link uses the place's pin.
  • annex location shows how close the computer's own position is for an instance set to host, and says when it was only guessed from the IP address.

Fixed

  • Apps no longer see an instance's position as a mock location. Instances now have a GPS of their own (a small GNSS driver annex mounts into Android), so positions arrive through Android's real GPS service, and apps that refuse mock locations, as many fraud checks do, accept them. annex location works as before.

Changed

  • Container-mode instances rebuild on their next annex up to add the GPS driver; their data is kept.
  • Instances no longer have a network location provider, only GPS.

annex v0.4.0

Choose a tag to compare

@github-actions github-actions released this 30 Oct 05:38
ff78c52

Added

  • annex location [NAME] [default | host | LAT,LON] shows or sets where an instance's apps see it. host (opt-in, per instance) follows this computer's location through the desktop bridge and GeoClue, after the desktop's own permission prompt.

Fixed

  • Apps that use location see it as on and get a position. Container-mode instances had no GPS or network location provider, so apps such as those using Geolocator reported location services as disabled after permission was granted. Each instance now simulates both, at the Android emulator's default position until annex location moves it.

annex v0.3.0

Choose a tag to compare

@github-actions github-actions released this 30 Oct 04:59
c101a0e

Added

  • Annex Manager (annex-manager), a GTK 4 / libadwaita window app: instance cards with live actions, a page per instance with its details, screen size and snapshots (save, restore, delete), a New instance dialog, drag-and-drop APK install, and settings for the bridge and autostart. Open it from the "Annex" launcher entry, the panel menu or annex manager.
  • annex setup installs Annex Manager on a desktop from the release matching its version and adds its launcher entry; annex update updates it with annex. Releases publish it as a second archive.
  • annex setup --no-bridge and --no-manager.

Changed

  • annex setup sets up the desktop bridge by default in a desktop session; --bridge is no longer needed.
  • Instances appear in IDEs as "Annex " instead of the image's "redroid15 x86 64"; existing instances pick it up on their next annex up (data kept).
  • The release archive includes THIRD_PARTY_NOTICES.md.

annex v0.2.0

Choose a tag to compare

@github-actions github-actions released this 30 Oct 04:20
19ce700

Added

  • annex setup: checks the machine, shows a plan split into steps that need sudo and steps that don't, asks once, then installs and configures everything with live progress (a byte progress bar with speed and ETA for the Android image). Safe to re-run. --dry-run, --yes, --bridge, --window-mode and --repair.
  • Instance names are optional: annex up uses default, and other commands use default or the only running instance.
  • App launcher entries for every instance, with Freeze, Thaw, Stop and Reset to snapshot actions, and an annex icon. annex launcher install|remove, and annex open-window, which starts an instance if needed and opens its screen.
  • A panel menu in the desktop bridge listing every instance with its actions, plus New instance.
  • annex about and annex about --licenses, and THIRD_PARTY_NOTICES.md.
  • annex update installs the latest release after verifying its SHA-256 (or rebuilds the latest source while none is published), then restarts the bridge; --check only looks.
  • annex doctor checks for a panel that can show the bridge's menu.
  • annex up --display WIDTHxHEIGHT/DPI sets an instance's screen; changing it on an existing instance rebuilds the container and keeps its data.
  • annex install, annex push and annex pull for APKs and files.
  • annex open <instance> <package> opens one app in a desktop window of its own: a native window on Waydroid, a scrcpy virtual display on Redroid.
  • Window mode (annex up <name> --mode window): one instance whose apps open in native desktop windows, with start, stop, freeze and thaw without root, and your adb key authorized automatically.
  • The desktop bridge (annex bridge run, install, uninstall, status): one clipboard across the desktop and every running Redroid instance, and Android notifications as desktop notifications. It runs as a systemd user service.
  • annex completions <shell> prints shell completions.
  • annex doctor checks scrcpy's version and server, Waydroid, the desktop clipboard and notify-send.
  • CI (format, clippy, tests) and a release workflow that publishes a Linux binary.

Changed

  • annex ls shows each instance's mode (container or window).
  • Messages, help and doctor describe modes and capabilities instead of naming the projects behind them.
  • annex doctor colours its status labels on a terminal (plain when piped or with NO_COLOR).
  • annex up opens the instance's window once it's ready, unless one is already open, --no-window is given, or there is no desktop session.
  • annex open-window (launchers) no longer stacks a second window on an instance that has one.
  • adb commands that can block (on a frozen or half-booted instance) now time out.
  • annex open on Redroid switches the instance's adbd to root the first time, because Redroid's shell user can't create the trusted display scrcpy needs.

Fixed

  • Each running instance added about 36 drives to the dock and file manager: Android mounts its system modules through the host's loop devices. annex setup now installs a udev rule that hides them, and annex doctor reports when it's missing.
  • annex reset --to failed with "device or resource busy" on instances created since adb keys were masked: the snapshot is now restored into the data volume before the container's masks are mounted.