Nervos Launcher

Handheld Blockchain App Store — install CKB light client, explore blocks, manage dApps, all from your retro gaming handheld.

CKB Light Client Handheld-First Offline Install Block Explorer Screen Recorder Open Source No apt Required
View on GitHub Install Guide
What It Does

CKB Light Client Installer

Download and install the CKB light client directly on your handheld. Live progress bar, automatic architecture detection (aarch64/armv7l/x86_64), and background sync once running.

Block Explorer

Browse the chain from your handheld. View tip headers, current epoch, block hashes, and chain status — all rendered in a framebuffer-friendly UI.

Peer Network

See connected nodes at a glance. Drill into peer details — addresses, protocols, sync state. Know exactly who your light client is talking to.

Screen Recorder

Record your entire handheld screen — games, EmulationStation menus, everything — with h264 video and AAC stereo audio via a custom ffmpeg binary (11 MB). Runs as a detached background process that survives app exit. Configurable quality and FPS (15 / 24 / 30). Output path selectable through the built-in file manager.

On-Screen Keyboard

5 character sets: abc, ABC, 123, hex, and symbols. Takes 75% of the screen when active, minimisable when not needed. Works with any gamepad — no physical keyboard required. Used by the terminal, config editor, and future modules.

Package Manager

JSON registry of static binaries — no apt, pacman, or flatpak needed. Install jq, micro, ffmpeg, and more. Works on any Linux regardless of the system package manager. Defined in packages.json, installed to a local prefix.

File Manager

Browse directories and select files or folders on the device. Used by the screen recorder for output path selection. Foundation for future wallet key import and other file-based workflows.

Config Editor

Edit config.toml with syntax highlighting for TOML, JSON, and log files. Reset to default downloads a fresh config from GitHub. Line-by-line editing powered by the on-screen keyboard.

Terminal with Keyboard

5 command categories: RPC, Service, System, Network, and Install. Press Start for the on-screen keyboard to type custom commands. User-editable command categories via JSON — add your own commands without touching code.

Compatible Devices

Nervos Launcher targets Linux-based retro gaming handhelds and SBCs. If the device runs a custom Linux firmware with framebuffer access and has WiFi, it can probably run the launcher. Tested primarily on the Anbernic RG35XX H.

Tier Devices RAM Notes
SBCs Raspberry Pi 4/5, Orange Pi, Rock64 4-8 GB Full CKB light client + all tools. Plenty of headroom.
High-RAM Handhelds Odin 2, Retroid Pocket 4, Steam Deck 4-16 GB Everything runs comfortably. SteamOS needs desktop mode.
2 GB Handhelds RG556, RG353M, RGB30 2 GB Light client runs but memory is tight during initial sync.
1 GB Handhelds RG35XX H, RG28XX, Miyoo Mini+ 1 GB Launcher UI works. Light client may need swap or external sync.
Knulli ROCKNIX ArkOS Batocera SteamOS
Install

Three ways to get Nervos Launcher onto your device.

1. SD Card (no network needed)

# On your computer: clone and copy to SD card
git clone https://github.com/toastmanAu/nervos-launcher.git
cp -r nervos-launcher /path/to/sdcard/ports/

# On the handheld: navigate to Ports and launch "Nervos Launcher"
# No network required — binaries are bundled

2. SSH (one command)

# SSH into your handheld and run:
git clone https://github.com/toastmanAu/nervos-launcher.git ~/ports/nervos-launcher

# Or if git isn't available:
wget -qO- https://github.com/toastmanAu/nervos-launcher/archive/refs/heads/main.tar.gz | tar xz -C ~/ports/

3. PortMaster (coming soon)

# PortMaster integration is planned.
# Once available, search "Nervos Launcher" in the PortMaster store.
Security Notice
Demo Videos

See Nervos Launcher in action. The v0.2.0 release includes a demo of the screen recorder capturing gameplay with full stereo audio — recorded entirely on the handheld itself.

v0.2.0 Release — Game Recording with Audio Demo
Links
GitHub Repo Install Guide CKB Light Client Nervos Network