Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
19 commits
Select commit Hold shift + click to select a range
db4ad38
feat(store): bounce long names like the launcher
Oct 16, 2026
be99b96
feat(store): realign the app selection screen
Oct 16, 2026
d15c638
feat(store): make the app details screen readable
Oct 16, 2026
e9e43b0
feat(store): hang shortcut labels as bookmark tabs
Oct 16, 2026
494913e
feat(store): read app permissions from the registry
Oct 16, 2026
f3f5724
feat(store): rework the app selection screen
Oct 16, 2026
54d7e90
feat(audio): play the launcher's key sounds in the Store
Oct 16, 2026
f2343b7
feat(store): redesign the startup screen
Oct 16, 2026
b870560
feat(store): restyle Settings and make the registry editor usable
Oct 17, 2026
a1bbc41
feat(store): restrict the Store to built-in mirrors with reachability…
Oct 22, 2026
ea3f8bf
refactor(store): restore the original app list and limit Settings to …
Oct 22, 2026
fd7ada5
docs(store): describe the restored layout and mirror-only Settings
Oct 22, 2026
e71e7ab
feat(store): remove the Recommended category from the catalog
Oct 22, 2026
bfed173
feat(store): update apps from the list and page details with the labe…
Oct 22, 2026
a5691f7
feat(store): stack full-width screenshots and label the permissions row
Oct 22, 2026
af254e1
docs(store): document list updates, category changes, and details nav…
Oct 22, 2026
a2791cd
fix(store): return to the home list after removing an app
Oct 22, 2026
28c4bde
fix(store): centre the install-state dot on its label
Oct 22, 2026
7bb7cd2
feat(store): show the screens shortcut on app details
Oct 22, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
76 changes: 55 additions & 21 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,6 @@ downloads continue to use curl so interrupted downloads can be resumed safely.
./M5CardputerZero-AppStore --registries
./M5CardputerZero-AppStore --regions
./M5CardputerZero-AppStore --set-region CN
./M5CardputerZero-AppStore --add-registry https://example.com/generated/registry.json
./M5CardputerZero-AppStore --sync
./M5CardputerZero-AppStore --plan <app-id>
./M5CardputerZero-AppStore --install <app-id>
Expand Down Expand Up @@ -92,36 +91,71 @@ Desktop-entry repair is best effort. Failure to find or rewrite an APPLaunch
desktop entry is reported as `WARNING` after a successful package operation and
does not change the verified package result.

Multiple registries are supported. On the Registries settings screen, use the
region radio buttons to choose the built-in Default or CN registry. Add another
registry from the same screen or with `--add-registry`; the selected region
registry and all enabled custom registries are synced and merged into one app
list. Apps with the same UUID/share code are de-duplicated, with later registry
metadata taking precedence. On the home screen, use `Z/C` (left/right) to change
category and `F/X` (up/down) to select an app. Installed filters catalog apps by
Settings offers three server modes for the same catalog: **Auto**, **Default**
(GitHub), and **CN** (Alibaba Cloud OSS). `Z/C` (left/right) changes the mode;
`4` goes back and `8` syncs after the pending selection is applied.
The screen retains its dark styling, segmented selector, and read-only active
server information. Auto tries GitHub first and falls back to OSS if it cannot
retrieve a usable catalog; explicit Default and CN choices stay pinned to that
server. Cached data does not count as a successful connectivity check. Only one
server supplies the catalog at a time; custom registries and their editor are
not supported. Existing saved custom sources are normalized to the selected
built-in server, and the mode and effective server are persisted across restarts.

On the home screen, use `Z/C` (left/right) to change category and `F/X` (up/down)
to select an app. Categories include All, Installed, and the registry's app
categories; there is no Recommended category. Installed filters catalog apps by
their actual package installation state and refreshes after package operations.
The Installed category is hidden when empty; removing its last app returns the
selection to All. Long app names pause for two seconds, then scroll horizontally
at 20 pixels per second, with another pause at the end. Status-bar updates keep
the current reading position, and labels never scroll vertically.
The header shows the selection within the category and the total catalog size.
selection to All. Long names bounce like the selected APPLaunch title: they
pause for two seconds, scroll horizontally at 40 pixels per second to the end,
pause again, and scroll back. Status-bar updates keep the current reading
position, and labels never scroll vertically. In search results only the
selected name scrolls; the others end with an ellipsis. The home screen keeps
its original layout: the app icon on the left, name and metadata on the right,
and plain-text number-key shortcuts along the bottom. Permission icons appear
only on the app details page.
Press `4` for settings, `5` for share code, `6` for search, `7` for
install/reinstall, and `8` or Enter for details. AppStore syncs the registry
automatically when it starts.
install/reinstall, and `8` or Enter for details. When an installed app has an
available update, the list indicates it and shortcut `7` becomes **update**,
opening the upgrade confirmation directly without visiting details.
AppStore syncs the registry
automatically when it starts. The startup screen names the current step
(connecting, updating the catalog, loading artwork, preparing apps) above a
progress bar with the registry's host, and `Tab` opens settings. If no
registry can be reached, an alert offers Exit or Settings; `Z/C` moves between
them and Enter confirms.

On the home and startup screens, a short `Esc` press opens the centered
"Hold ESC for 3s to exit." hint. Press `Esc` again or another key to dismiss
the hint without activating the page underneath. On other screens, short
`Esc` keeps its back/cancel behavior. Hold `Esc` for three seconds to exit
from any screen, including while the hint is open.

The detail page shows the complete combined summary and description, followed
by 160 x 85 screenshot previews loaded from the registry. `F/X` scrolls the
whole content area; the system bar and bottom actions stay fixed. Descriptions
wrap without a height limit or automatic scrolling. `Z/C` cycles screenshots;
apps without screenshots have no screenshot area. Detail actions are `4` back,
`6` install/reinstall, `7` upgrade, and `8` remove, shown when applicable.
The existing full-screen screenshot viewer remains accessible through `5`.
Keys play the launcher's system sounds: arrows and `F/X/Z/C` play the switch
sound on every step, including repeats while held, and Enter, Tab, a short
`Esc`, and shortcut keys play the enter sound. Typing in the share-code and
search fields is silent. A held key repeats no faster than the screen redraws,
and its sound keeps playing while the redraw waits, so the view keeps up and
stops when the key is released.

The detail page shows the app name, color-coded version, maintainer, size,
and update fields, the install state, and the complete description. Screenshots
follow the description in vertical rows, one image per row at nearly full screen
width (300 pixels), with aspect ratio preserved. Package and category information
follow the screenshots, then a matching PERMISSIONS caption and permission icons.
`F/X` scrolls the whole content area with a short glide, 24 pixels per press;
`Z/C` and `K/L` page up and down, and `N/M` jump to the start and end. Holding
a key scrolls continuously. The system
bar and bottom actions stay fixed, and status messages appear just above the
actions at any scroll position. Descriptions wrap without a height limit or
automatic scrolling. Apps without screenshots have no screenshot area. Detail actions are `4` back,
`5` screens (the full-screen viewer), `6` install/reinstall, `7` update, and
`8` remove, shown when applicable. After a successful removal the Store returns
to the home list.
The existing full-screen screenshot viewer remains accessible through `5`, where
`Z/C` cycles images. On the details page itself those keys page through the
content.

Registry entries must provide a Debian package download:

Expand Down
1 change: 1 addition & 0 deletions linux_x86_cross_cp0_config_defaults.mk
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,7 @@ CONFIG_V9_5_LV_DRAW_THREAD_PRIO=3
CONFIG_CP0_LVGL_COMPONENT_ENABLED=y
CONFIG_CP0_LVGL_INIT_FILESYSTEM=y
CONFIG_CP0_LVGL_INIT_CONFIG=y
CONFIG_CP0_LVGL_INIT_AUDIO=y
CONFIG_CP0_LVGL_INIT_SUDO=y
CONFIG_CP0_LVGL_INIT_PROCESS=y
CONFIG_CP0_LVGL_INIT_WIFI=y
Expand Down
1 change: 1 addition & 0 deletions linux_x86_sdl2_config_defaults.mk
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,7 @@ CONFIG_V9_5_LV_DRAW_THREAD_PRIO=3
CONFIG_CP0_LVGL_COMPONENT_ENABLED=y
CONFIG_CP0_LVGL_INIT_FILESYSTEM=y
CONFIG_CP0_LVGL_INIT_CONFIG=y
CONFIG_CP0_LVGL_INIT_AUDIO=y
CONFIG_CP0_LVGL_INIT_SUDO=y
CONFIG_CP0_LVGL_INIT_PROCESS=y
CONFIG_CP0_LVGL_INIT_WIFI=y
Expand Down
Loading