Repository navigation
Releases
Releases · cyenite/annex
annex v0.6.0
Added
- A CI profile for end-to-end tests on runners and headless machines.
annex up --ephemeraldeletes the instance and its data atannex down;--wait-bootalso waits for the package manager;--timezone,--localeand--animations offset the instance up after boot. annex serial [NAME]prints an instance's adb serial, andannex ls --jsonlists instances as JSON, so scripts no longer have to assume127.0.0.1:5600.annex doctor --jsonprints the checks as JSON; likeannex 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 doctorandannex setupnotice 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|lossychanges an instance's network until it restarts.offlineblocks every installed app through Android's own firewall, so apps are told they have no network;slowandlossyshape the connection. adb always keeps working.annex setuploads the kernel's traffic shaping modules on machines that don't load them on demand, andannex doctorchecks for them.annex record [NAME] start -o FILEandannex record [NAME] stoprecord 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 upno longer adds an app launcher entry, andannex doctorno longer warns about the clipboard, notifications and panel menu.
annex v0.5.1
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 upto drop the camera; their data is kept.
annex v0.5.0
Added
annex locationtakes 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 locationshows how close the computer's own position is for an instance set tohost, 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 locationworks as before.
Changed
- Container-mode instances rebuild on their next
annex upto add the GPS driver; their data is kept. - Instances no longer have a network location provider, only GPS.
annex v0.4.0
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 locationmoves it.
annex v0.3.0
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 orannex manager. annex setupinstalls Annex Manager on a desktop from the release matching its version and adds its launcher entry;annex updateupdates it with annex. Releases publish it as a second archive.annex setup --no-bridgeand--no-manager.
Changed
annex setupsets up the desktop bridge by default in a desktop session;--bridgeis 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
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-modeand--repair.- Instance names are optional:
annex upusesdefault, and other commands usedefaultor 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, andannex 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 aboutandannex about --licenses, and THIRD_PARTY_NOTICES.md.annex updateinstalls the latest release after verifying its SHA-256 (or rebuilds the latest source while none is published), then restarts the bridge;--checkonly looks.annex doctorchecks for a panel that can show the bridge's menu.annex up --display WIDTHxHEIGHT/DPIsets an instance's screen; changing it on an existing instance rebuilds the container and keeps its data.annex install,annex pushandannex pullfor 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 doctorchecks 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 lsshows each instance's mode (container or window).- Messages, help and
doctordescribe modes and capabilities instead of naming the projects behind them. annex doctorcolours its status labels on a terminal (plain when piped or with NO_COLOR).annex upopens the instance's window once it's ready, unless one is already open,--no-windowis 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 openon 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 setupnow installs a udev rule that hides them, andannex doctorreports when it's missing. annex reset --tofailed 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.