Install · Anbernic RG DS Plus

Anbernic RG DS Plus

Omarchy Pocket as the SD card's system. The stock Anbernic system stays on the card as the rescue boot.

The RG DS Plus open, a terminal, Activity and a clock tiled above the keyboard — The RG DS Plus: the upper screen is the monitor, the lower one the keyboard and trackpad.

Install: From source, over SSH from a computer
Runs on: The RG DS Plus on Anbernic's stock firmware, with its 16 GB card
Needs: A Mac with Apple silicon and OrbStack, Bun 1.4.2, Rust with cargo-zigbuild, and access to this repository's submodules
Time: About an hour, most of it building the image

Build

Get the repository and its submodules:

git clone https://github.com/pocket-nexus/omarchy-pocket && cd omarchy-pocket
git submodule update --init vendor/pocketjs vendor/applets vendor/pocket-term vendor/pocket-hub
git -C vendor/pocket-hub submodule update --init vendor/pocketjs
bun install --cwd vendor/pocketjs --frozen-lockfile
POCKETJS_ROOT=vendor/pocketjs bun vendor/applets/tools/setup.ts

Take Omarchy's menu, theme, wallpaper and fonts, and copy the GPU library from the device:
```
bun tools/omarchy-assets.ts
bun tools/build.ts libs root@<rg-ds-plus>
```
Build the programs, then the system image (an arm64 container in OrbStack, about 2.5 GB):
```
bun tools/build.ts all
bun image/build-root.ts
```

Install

Reach the device over SSH: on Wi‑Fi as root / root, or over the USB link (docs/usb-link.md).
Back up the whole card with dd of /dev/mmcblk1, compressed, with its SHA-256 beside it. image/install.ts names the backup it checks for in BACKUP.
Run the steps:
```
bun image/install.ts check partition extract configure chooser reboot --ssh "ssh root@<rg-ds-plus>"
```
partition makes one partition for Omarchy Pocket after the stock root, extract unpacks the image, configure keeps the device's SSH keys, Wi‑Fi networks, firmware and modules, and chooser makes the stock root boot into it.
After the reboot, unlock with the password omarchy.

Controls

The shoulders are SUPER: hold L1 for the window layer, R1 for the move layer, both for workspaces, and the lower screen draws what each button does. With no shoulder held, the D-pad is the arrows, A Enter, B Backspace, X Tab, Y Space, START Escape, and L2 / R2 step workspaces.

The chord table played on the RG DS Plus, both screens.

The desktop over the trackpad, upper screen — The desktop, with the pins and the workspaces on the lower screen.

The desktop over the trackpad, lower screen — The desktop, with the pins and the workspaces on the lower screen.

Three windows over the keyboard, upper screen — A terminal, Activity and Clock tiled over the keyboard.

Three windows over the keyboard, lower screen — A terminal, Activity and Clock tiled over the keyboard.

The window layer's legend, upper screen — Holding L1: the window layer.

The window layer's legend, lower screen — Holding L1: the window layer.

Hacker News over the trackpad, upper screen — Hacker News in a window, the trackpad under it.

Hacker News over the trackpad, lower screen — Hacker News in a window, the trackpad under it.

Six captures of the RG DS Plus's two screens — Both screens, read back from the GPU.

Back to the stock system

The stock root boots first and pivots into Omarchy Pocket. Its rescue boot brings up SSH, Wi‑Fi and the USB link without the launcher. To go back to Anbernic's system entirely, write the card's backup back with dd.