Omarchy Pocket 0.2.1: the Retroid Pocket Duo Lite, and the AYN Thor's icon

The Android app now runs on the Retroid Pocket Duo Lite beside the AYN Thor: one APK, which picks the handheld it is installed on. On the Thor this release brings a proper launcher icon and fixes the applets that go through the companion services. The root is 0.2.0's, byte for byte: an installed one stays.

Step-by-step guides with pictures from each device: omapocket.org/docs, with a new page for the Duo Lite.

Retroid Pocket Duo Lite (new)

The same shell as on the Thor, laid out for the Duo Lite (Snapdragon 665, Android 15): the 5.5″ 1080p upper screen is the monitor, the 4.2″ 1280 × 960 touch screen the keyboard and trackpad, and the Retroid Pocket Controller the gamepad.

• The lower screen is the keyboard deck at 426 × 320 points, so the keys are 8.5 mm apart.
• Hold L1 or R1: the lower screen draws the controls where they sit on the Duo Lite. That puts the D-pad over the left stick, A B X Y as printed, and SELECT and START at the screen's upper corners.
• Retroid's launcher on the lower screen starts the app on the upper one.

Install it as on the Thor: download the APK and omarchy-pocket-root.tar.zst, install the APK, open Omarchy Pocket, press START and pick the root. The lock's password is omarchy. 0.2.0's APK carries the Thor's layout only.

Tested on a Duo Lite on Retroid's firmware RPDuoLite_V1.0.0.223. docs/retroid-pocket-duo-lite.md describes the port and what was verified.

AYN Thor

omarchy-pocket-0.2.1.apk installs over 0.2.0 and keeps the root.

• The launcher icon is an adaptive icon: omapocket.org's mark, in place of the square Launcher3 put on a white disc. It has a monochrome layer for themed icons, and the notification icon is a proper silhouette.
• Applets that use the companion services work. X, Discord, YouTube, Podcasts, Maps and Home refused every request in 0.2.0, with "does not declare the … service".
• Starting the app from the lower screen's launcher opens it on the upper screen. In 0.2.0 the app closed.
• A new terminal's prompt no longer shows ❯ as a box while the daemon makes its glyphs.
• The trackpad's hint wraps into up to three lines, where it used to run past the trackpad.
• The APK is 11 MB, down from 65 MB, though it now carries both handhelds.

ClockworkPi uConsole

omarchy-pocket-uconsole_0.2.1_arm64.deb installs over 0.2.0 and keeps the root. Of the changes above it carries the terminal's: the prompt's glyphs are made at the daemon's start, and a terminal draws them once they are ready. The uConsole's own code is 0.2.0's.

curl -LO https://github.com/pocket-nexus/omarchy-pocket/releases/download/v0.2.1/omarchy-pocket-uconsole_0.2.1_arm64.deb
sudo apt install ./omarchy-pocket-uconsole_0.2.1_arm64.deb

The package was checked in a Debian 13 container: install, the root's unpacking and a command in it, remove (the root stays), purge, and lintian. It was not run on a uConsole for this release.

Files

File	For	Bytes	SHA-256
omarchy-pocket-uconsole_0.2.1_arm64.deb	ClockworkPi uConsole	3,668,480	11d1de3883cf863c4219eea43475d99c516875c61b11fa939249214a523e052c
omarchy-pocket-0.2.1.apk	AYN Thor, Retroid Pocket Duo Lite	11,384,762	ce0e9cf084f0e427616d781f94ad83f1180797f47a44b9f5342e8a328b7ffb99
omarchy-pocket-root.tar.zst	all three: Omarchy's Arch Linux ARM root (0.2.0's)	801,964,563	5683475c735e52571309d9890e8c5f51190b6ebd748c809bf3f32525e7894878

SHA256SUMS lists all three.

• The APK is signed with the release certificate (CN=Omarchy Pocket, O=Pocket Nexus, SHA-256 b5:57:19:34:62:c8:13:f8:73:c3:02:f9:ae:88:5f:3a:5b:78:1c:2c:87:5e:d1:84:ae:cd:8a:e1:c6:41:7f:5a). It was built with bun tools/android.ts release --root <0.2.0's root>.
• The package was built with bun tools/uconsole.ts release.
• Both were built from this tag's code.

The RG DS Plus has no download in this release: it installs from source (the guide).

Limits

• Android handhelds:
  • Programs in the root play no sound.
  • GitHub and Weather are left out at density 3.
  • On a fresh install the first 40 seconds or so go to making run-time glyphs on the Duo Lite.
  • The Duo Lite's legend follows Retroid's Retro controller style. The Xbox style was not tried.
  • Physical presses of the Duo Lite's controls were not part of the testing: every press was an injected Android key event.
• AYN Thor: AYN's Burn-in Protection Refresher covers the screens from time to time.
• uConsole:
  • No voice input.
  • No Chinese input from its keyboard yet.

Third-party programs

Unchanged from 0.2.0:

• The APK carries three third-party programs, unmodified apart from proot's NEEDED entry:
  • Termux's proot 5.1.107 (GPL-2.0, termux/proot);
  • libtalloc 2.5.0 (LGPL-3.0);
  • libandroid-shmem 0.7 (BSD-3-Clause).
• The root is Arch Linux ARM's packages (each with its licence in /usr/share/licenses) and Omarchy (MIT).

Omarchy Pocket 0.2.0: the ClockworkPi uConsole, and the AYN Thor

Omarchy Pocket on two machines from this release: the ClockworkPi uConsole, new, as a Debian package beside Raspberry Pi OS, and the AYN Thor, as before, as an Android app. Both run Omarchy's CLI, themes, menu and omarchy-pocketd in the same Arch Linux ARM root, omarchy-pocket-root.tar.zst, unchanged since 0.1.0.

Step-by-step guides with pictures from each device: omapocket.org/docs.

ClockworkPi uConsole (new)

One PocketJS shell on the uConsole's 5″ panel (Raspberry Pi CM4), beside Raspberry Pi OS's own desktop:

• The keyboard types into Pocket Term, Omarchy's menu (typing filters it), Notes and text fields.
• The trackball points, with L and R as the mouse's buttons and the ball's press as a click; SELECT + roll scrolls.
• START is SUPER: held for a chord with the other thumb, tapped to keep SUPER on so the D-pad walks windows (and past the last one, workspaces); tapped again for the move layer. Under SUPER the keyboard has Omarchy's own bindings.
• The controls row: while SUPER is up, the panel's bottom edge names what each control does, right above it.
• The power key darkens the panel and locks; your login password unlocks.

curl -LO https://github.com/pocket-nexus/omarchy-pocket/releases/download/v0.2.0/omarchy-pocket-uconsole_0.2.0_arm64.deb
sudo apt install ./omarchy-pocket-uconsole_0.2.0_arm64.deb   # downloads omarchy-pocket-root.tar.zst and checks its SHA-256
omarchy-pocket-session on

Back to the Raspberry Pi desktop: System › Raspberry Pi Desktop in Omarchy's menu, or omarchy-pocket-session off; Omarchy Pocket in the desktop's menu switches back. omarchy-pocket-session boot or desktop picks what starts at boot. sudo apt remove omarchy-pocket-uconsole gives the panel back to the desktop for good; purge also deletes the root.

Tested on a uConsole with a CM4 (4 GB) on ClockworkPi's Raspberry Pi OS 13 (trixie). docs/clockwork-uconsole.md describes the port.

AYN Thor

omarchy-pocket-0.2.0.apk installs over 0.1.0 and keeps the root. Omarchy's menu no longer closes when the daemon's system state changes (a battery or Wi-Fi reading) while it is open.

A first install takes both files: install the APK, open Omarchy Pocket, press START and pick omarchy-pocket-root.tar.zst. The lock's password is omarchy.

Files

File	For	Bytes	SHA-256
omarchy-pocket-uconsole_0.2.0_arm64.deb	ClockworkPi uConsole	3,669,880	8057d180f51735b1092bbd699b336677c9342c1789abd571d796af979a0fbb4a
omarchy-pocket-0.2.0.apk	AYN Thor	65,658,706	513f303916f4c0abf130375ef62868a211ef099a2cf98af3fea8029db6e828ec
omarchy-pocket-root.tar.zst	both: Omarchy's Arch Linux ARM root	801,964,563	5683475c735e52571309d9890e8c5f51190b6ebd748c809bf3f32525e7894878

SHA256SUMS lists all three. The APK is signed with the release certificate (CN=Omarchy Pocket, O=Pocket Nexus, SHA-256 b5:57:19:34:62:c8:13:f8:73:c3:02:f9:ae:88:5f:3a:5b:78:1c:2c:87:5e:d1:84:ae:cd:8a:e1:c6:41:7f:5a). The package was built from this tag with bun tools/uconsole.ts deb. The APK was built with bun tools/android.ts from 986d4b4, the same AYN Thor code as this tag (the commits between change only uConsole code). The root is 0.1.0's.

The RG DS Plus has no download in this release: it installs from source (the guide).

Limits

• uConsole: no voice input (no microphone), no Chinese input from its keyboard yet, no SUPER + drag. Other cores than the CM4 are not tested.
• AYN Thor: programs in the root play no sound; AYN's Burn-in Protection Refresher covers the screens from time to time; GitHub and Weather are left out at density 3.

Third-party programs

• The APK:

  • Termux's proot 5.1.107 (GPL-2.0, termux/proot);
  • libtalloc 2.5.0 (LGPL-3.0, talloc.samba.org);
  • libandroid-shmem 0.7 (BSD-3-Clause, termux/libandroid-shmem).

  They are unmodified, apart from proot's NEEDED entry.

• The root:

  • Arch Linux ARM's packages, each with its licence in /usr/share/licenses. Their sources are the PKGBUILDs at archlinuxarm/PKGBUILDs and Arch's packaging repositories.
  • Omarchy (MIT).

Omarchy Pocket 0.1.0 for the AYN Thor

Omarchy Pocket on the AYN Thor, as an Android app. It is the RG DS Plus's PocketJS shell on both displays:

• the 6″ 1920 × 1080 upper display is the monitor;
• the 3.92″ touch display is the keyboard and trackpad;
• the Odin controller is the gamepad.

Omarchy's CLI, themes and omarchy-pocketd run in an Arch Linux ARM root that the app runs under proot. Nothing on the device is rooted or replaced.

Install

1. Download omarchy-pocket-0.1.0.apk and omarchy-pocket-root.tar.zst (802 MB) onto the Thor.
2. Install the APK. Android asks once to let the browser or file manager install apps.
3. Open Omarchy Pocket and press START, then choose omarchy-pocket-root.tar.zst in the file picker. The app copies the archive and unpacks the Linux root into its own files.
4. Unlock with the password omarchy.

A later release installs over this one and keeps the root. A Thor with a build from source on it (signed with a debug key) uninstalls that build first, which removes its root.

Files

File	Bytes	SHA-256
omarchy-pocket-0.1.0.apk	65,386,730	16cab7ea5f81e030c1f4a85e92c7d9f34f06fa6a66ddcf04ba6c4c5279e82a1a
omarchy-pocket-root.tar.zst	801,964,563	5683475c735e52571309d9890e8c5f51190b6ebd748c809bf3f32525e7894878

SHA256SUMS lists both files. The APK is signed with the release certificate (CN=Omarchy Pocket, O=Pocket Nexus). Its SHA-256 is b5:57:19:34:62:c8:13:f8:73:c3:02:f9:ae:88:5f:3a:5b:78:1c:2c:87:5e:d1:84:ae:cd:8a:e1:c6:41:7f:5a; apksigner verify --print-certs shows it. Both files were built from this tag with bun tools/android.ts release.

In this release

• Displays: both, at raster density 3: 640 × 360 points over 413 × 360.
• Rendering: the host program, libomarchy_pocket.so, draws through EGL on the Adreno.
• Input: the Odin controller and the lower display's touch.
• Volume keys: they show Omarchy's OSD.
• Wi-Fi: the Network panel scans, joins and forgets networks through Android's WifiManager.
• Applets: Discord, Hacker News, Home Assistant, Maps, Podcasts, X and YouTube.

Limits

• Sound from the root: no PipeWire runs in it, so terminal programs and the shell's media player are silent. Android's volume and mute work.
• Voice input: proot reaches no microphone.
• Applets left out:
  • GitHub and Weather are over the applet size budget at density 3;
  • Notes, Photos and Camera need capabilities the Thor's profile lacks;
  • the Store and Spotify are left out: the Store installs the RG DS Plus's builds, and Spotify's speaker plays into PipeWire.
• Burn-in protection: AYN's own "Burn-in Protection Refresher" covers both displays from time to time while they are static, and takes the next input.

Third-party programs

• The APK:

  • Termux's proot 5.1.107 (GPL-2.0, termux/proot);
  • libtalloc 2.5.0 (LGPL-3.0, talloc.samba.org);
  • libandroid-shmem 0.7 (BSD-3-Clause, termux/libandroid-shmem).

  They are unmodified, apart from proot's NEEDED entry.

• The root:

  • Arch Linux ARM's packages, each with its licence in /usr/share/licenses. Their sources are the PKGBUILDs at archlinuxarm/PKGBUILDs and Arch's packaging repositories.
  • Omarchy (MIT).

docs/ayn-thor.md describes the port.