ZeroShell is the launcher shown after login on the Cardputer Zero internal screen.
The home screen shows the installed APPLaunch apps in a three-card carousel.
The bottom bar is aligned to the physical 4 through 8 keys:
| Soft key | Behavior |
|---|---|
4 / TASK |
Toggle the running task panel. |
5 / < |
Move left. |
6 / > |
Move right. |
7 / ENTER |
Open or accept. |
8 / CATEGORY |
Toggle the category drawer. |
| Key | Behavior |
|---|---|
Left / Right |
Select app. |
Enter |
Open selected app, or focus it if already running. |
C |
Toggle the category drawer. |
Tab |
Toggle the running task panel while ZeroShell is focused. |
R |
Reload app entries. |
The category drawer opens from the right side of the launcher. It filters the home app carousel by the selected desktop-entry category.
| Key | Behavior |
|---|---|
Up / Down |
Select category and immediately filter apps. |
Left / Right |
Select category and immediately filter apps. |
Enter |
Keep the selected category and close the drawer. |
C / Esc |
Close the category drawer. |
Categories come only from the app desktop entry:
Categories=Settings;System;All shows every app. Apps without a usable Categories= value appear under
Other.
The task panel lists windows currently visible to the compositor.
| Key | Behavior |
|---|---|
Up / Down |
Select task. |
Enter |
Focus selected task. |
Tab / Esc |
Close the task panel while ZeroShell is focused. |
These controls are provided by cardputer-zero-os:
| Key | Behavior |
|---|---|
Short Esc |
Minimize active app and return to ZeroShell. |
Long Esc |
Ask active app to close and return to ZeroShell. |
An app appears when its package installs:
/usr/share/APPLaunch/applications/<app>.desktop
The app must declare:
X-Zero-Display=waylandor:
X-Zero-Display=xwaylandZeroShell does not include fixed apps. Terminal, Settings, Files, App Store, System Monitor, and HDMI tools are normal app entries when installed.