Repository navigation
Releases
CardputerZero CPZ v0.9.0
CardputerZero CPZ v0.9.0
A larger desktop update: all website languages, one shared Wi-Fi/Bluetooth manager, selectable fonts, brighter-key support and a simpler Settings tree.
Highlights
- Eleven languages. The device UI and locale selector now ship English, Ukrainian, Polish, German, French, Spanish, Italian, Portuguese, Turkish, Japanese and Simplified Chinese.
- One radio manager. Wi-Fi and Bluetooth use the same borderless list with key hints, scan status, connect/pair actions and a visible power control. Bluetooth starts disabled and is enabled on demand.
- Fonts you can see. Display now offers seven installed families. The renderer fix makes the selected-family change visible, and
Fn+I/Fn+Ostep the panel backlight by 10%. - Quieter defaults. SSH and Bluetooth are off by default. SSH can be enabled from Settings and generates host keys on first use.
- Smaller Settings. Key List, Suspend and the separate Diagnostics page are gone; About now includes the diagnostics section and the network indicators share one
Networkswitch. - Better app search. Search shows apps installed through Settings → Applications, including ordinary apt packages, and the Applications manager gains apt search, an Installed view and desktop-app warnings.
Changes
- Updated the in-image catalogs for all eleven UI languages and synchronized the language list with the website.
- Replaced the two external radio TUIs in Settings with a shared borderless Wi-Fi/Bluetooth manager.
wifituiandbluetuithremain installed as manual recovery helpers. - Added Wi-Fi scanning, saved-network connect, passphrase entry, forget, radio power, Bluetooth scan/pair/connect/trust/remove and radio power to the shared manager.
- Status-bar network indicators now show
Wi/Btwhen enabled and add+when connected;Et+appears only while Ethernet is connected. The per-radio switches were removed. - Added a palette-based Midnight Commander skin so MC follows the selected CPZ theme.
- Added the Font picker with Terminus, DejaVu Sans Mono, Liberation Mono, Noto Sans Mono, Hack, Fira Code and JetBrains Mono.
- Fixed font changes being overridden by the DejaVu fallback: foot now receives one comma-separated font list.
- Added
Fn+I/Fn+Obrightness handling throughcpz-media-keysand a steppedcpz-brightnesshelper. - SSH is disabled by default;
ssh.serviceandssh.socketstay off, host-key regeneration is masked, and Settings generates keys when SSH is enabled. - Removed Input → Key List, Power → Suspend, and the separate Diagnostics entry. Merged diagnostics into About.
- Search now includes managed applications and installed/installable catalog apps without arbitrary PATH commands.
- Added desktop-application warnings, apt-backed browse search and managed-app tracking to Settings → Applications.
- Updated README and docs for the new radio, font, language, SSH and status-bar behaviour.
- Extended host tests and image verification for the new settings, radio manager, translations, font list, SSH defaults and brightness keys.
Install
Download cardputerzero-trixie-arm64-v0.9.0.img.xz from this release and
write it to a microSD card with Raspberry Pi Imager, balenaEtcher, dd or
M5 Imager.
Default login: cpz / cpz. Wi-Fi and Bluetooth are off until they are enabled
in Settings.
Documentation: https://github.com/jmas/cpzos/tree/master/docs
CardputerZero CPZ v0.8.0
CardputerZero CPZ v0.8.0
This release adds a mouse speed setting, puts Settings back into the Alt+Tab cycle, and fixes the root-owned cache directory that broke mc and other programs on a fresh card.
Highlights
- Mouse Speed. Settings → Input → Mouse Speed adjusts libinput's pointer acceleration from -1.0 (slowest) to +1.0 (fastest). The change applies without restarting the compositor, and a mouse plugged in later receives the same value.
- Settings in Alt+Tab.
Alt+Tab/Alt+Shift+Tabnow cycle through every live tab, including Settings. With a single terminal tab the pair toggles between the terminal and Settings instead of doing nothing. - First-start permissions fixed.
~/.cacheis created with the first user's ownership, somc,mpvand every other program that writes an XDG cache no longer fail withCannot create /home/cpz/.cache/...on a fresh card. - Reliable text sizes. Font sizes stay on the real Terminus bitmap strikes (12-32 px) and fall back to DejaVu Sans Mono, so 11/13 px no longer replaces Ukrainian and Cyrillic glyphs with dashes.
Changes
cpz-settings: new integermouse_speedkey (tenths of libinput's -1.0..1.0 range) and a Mouse Speed scale on the Input page; persisted in the user and systemsettings.conf.cpz-pointer: publishes the effective speed to/run/cpz-pointer/speed, includes it in the policy signature and reopens the pointer devices when it changes, so no compositor restart is needed.cpz-cage: loadscpz-pointer-speed.so, a smallLD_PRELOADshim that applies the speed on each libinputDEVICE_ADDEDevent. It is compiled in stage3 while the toolchain is still present and usesdlsym, so it has no build-time libinput dependency.cpz-tab-cycle: includes the Settings window in the cycle and keeps skipping only windows whose pane died; updated shortcut documentation and tests.01-run.sh: creates and chowns~/.cacheexplicitly before generating the tmux key cache;verify-image.shandverify-stage.shreject an image with a root-owned~/.cache.cpz-font/cpz-foot-config/cpz-settings: normalize text sizes to the Terminus OTB strikes and add a scalable DejaVu Sans Mono fallback.- Docs: mouse speed architecture in
docs/CPZ-CAGE.md; the Alt+Tab behaviour indocs/CPZ-KEYS.md. - Tests: coverage for the published mouse speed, the Settings-inclusive tab cycle, the
.cachechecks and the font strike normalization.
Install
Download cardputerzero-trixie-arm64-v0.8.0.img.xz from this release and write it to a microSD card with Raspberry Pi Imager, balenaEtcher, dd or M5 Imager.
Default login: cpz / cpz. Wi-Fi is off until it is enabled in Settings.
Documentation: https://github.com/jmas/cpzos/tree/master/docs
CardputerZero CPZ v0.6.1
CardputerZero CPZ v0.6.1
This release adds per-screen text size, image, video and music playback from both file managers, and a working HDMI switch on the cage-only session.
Highlights
- HDMI switching that holds. cage is the only session again; the panel and HDMI keep one DRM card each, a failed link falls back to the panel instead of restarting, and HDMI gets 128 MiB CMA so accelerated GL clients no longer crash.
- Text size per screen. The internal panel and HDMI each remember a 10-64 px Terminus size;
Alt+G/Alt+Mand Settings → Display → Text Size change the screen that is active. - Media from mc and lf. Opening an image or video starts imv-wayland or mpv with the whole folder as a gallery or playlist; audio starts cmus with the folder in album order. Camera RAW, PSD, subtitles and macOS sidecars are handled.
- A real headset remote. The rocker changes volume only; a single centre press toggles play/pause, a double press skips to the next track, and the side buttons step through the playlist. The keyboard's Fn keys stay plain.
- Compact Midnight Commander. The menu, key and hint bars are hidden by default, returning three rows to the file panels;
F9still opens the menu. - Search opens mounted disks. Each mounted drive has an
Open <label> [tab]row aboveUnmount, and Enter starts a new tab at the mount point that closes with the disk. - cmus keeps the album. The playlist keeps every track visible in folder order rotated to the opened track, ends with the folder, and
qreturns to the file manager.
Changes
- Restored cage as the only compositor and removed labwc/kmscon from the image, units and documentation; hotplug and user requests skip the debounce, and the session exports
WLR_DRM_DEVICESinstead of leaking shell variables. - Reserved 128 MiB CMA for GL clients on HDMI and kept one DRM card per session.
- Added per-output text size with migration of the legacy
font_size, picker rows for named settings sets, and the full 0-100% volume list. - Added image, video and music players:
cpz-opendispatches by mime type, mc usesMC_XDG_OPEN, lf gets its ownopen, mpv renders withvo=wlshm, and subtitles load from the film's folder or aSubsfolder (Ukrainian first, then English). - Added directory galleries and playlists, RAW and PSD support, extra video formats, and skipping of
._AppleDouble sidecars. - Reworked the headset mapping per device: keyboard volume keys stay volume-only, a held rocker no longer skips tracks, and a double press on the centre button skips forward.
- Added
/etc/mc/mc.iniwith the compact layout and made Search list mounted media as Open and Unmount rows. - Fixed the phantom-pointer libinput quirk to use event-code names and added tests for the
CPZ_NO_POINTERudev contract. - Refreshed the site feature grid and shortcut table in all 11 locales; the release tooling now targets origin, makes the OSS mirror optional, and verifies the settings and quirk files that are actually shipped.
- Fixed a dash-only failure in
cpz-musicwhen no controlling terminal exists, plus the remaining shellcheck and ruff findings.
Install
Download cardputerzero-trixie-arm64-v0.6.1.img.xz from this release and write it to a microSD card with Raspberry Pi Imager, balenaEtcher, dd or M5 Imager.
Default login: cpz / cpz. Wi-Fi is off until it is enabled in Settings.
Documentation: https://github.com/jmas/cpzos/tree/master/docs
CardputerZero CPZ v0.5.0
CardputerZero CPZ v0.5.0
This release makes every shortcut rebindable, adds volume and battery
protection, and turns Search and Settings into one consistent daily interface.
Highlights
- Every shortcut is rebindable. The
cpz-keysregistry now backs
Settings → Keyboard → Shortcuts, theAlt+Hreference, Search and the
generated tmux bindings. Defaults are two keys only:Alt+A/Alt+Fswitch
tabs,Alt+G/Alt+Mresize text andAlt+Spacechanges the input layout. - Volume and mute from the keyboard.
Alt+U/Alt+Imove the default
output in 5% steps andAlt+0toggles mute through the samewpctlsink as
Settings → Sound. - Battery guard.
cpz-battery-guardwarns at 20%, powers off cleanly at
10% or 3.35 V, and checks the charge before login so a depleted pack cannot
reset the board mid-boot. - Search is the daily hub.
Alt+Oopens with mounted drives (including
Unmountrows), installed apps, Settings pages, daily actions and confirmed
Reboot/Shut Down. Theappsprovider labels each row[run app],
[install app],[installed]or[info]. - One visual frame. Search, Settings, confirmations and pickers share the
same dialog frame; Settings keeps a blank column from the panel bezel, and
the tab bar now shows numbered tabs and network tokens. - Docs and site. New
CPZ-KEYS.mdandCPZ-UI.md, refreshed site copy in
English plus 10 translations, anddocs/RELEASE.mdwith the single release
format.
Changes
- Moved every default binding into the settings-backed
cpz-keysregistry;
removed duplicate aliases and chords that needed the Sym or Fn layer. - Added
cpz-volumefor volume steps and mute, wired to the status-bar volume
token and Settings → Sound. - Added
cpz-battery,cpz-battery-guard.serviceand/etc/cpz/battery.conf,
with a boot-time charge check incpz-login. - Expanded CPZ Search with mounted media, installed apps, direct app pages,
power actions, per-row key hints and theappsprovider; dropped
cpz-tab-info. - Reworked Settings navigation, the applications screen, keyboard shortcuts,
dialog spacing and the shared modal frame. - Reworked the tab bar around numbered tabs and network tokens; the close and
save helpers no longer depend on tab counters. - Added the CPZ UI and shortcut rule documents, refreshed the site and all
translations, and added tests for keys, volume and battery helpers. - Standardised releases: SemVer
vX.Y.Z[-prerelease]tags, the
CardputerZero CPZ vX.Y.Ztitle, a fixed notes template and
tools/release.sh --publish; release images now use the documentedcpz
account and hostname.
Install
Download cardputerzero-trixie-arm64-v0.5.0.img.xz from this release and
write it to a microSD card with Raspberry Pi Imager, balenaEtcher, dd or
M5 Imager.
Default login: cpz / cpz. Wi-Fi is off until it is enabled in Settings.
Documentation: https://github.com/jmas/cpzos/tree/master/docs
CardputerZero CPZ v0.4.0
CardputerZero CPZ v0.4.0
Terminal-first Linux for the CardputerZero handheld.
Highlights
- USB hard disks, sticks and card readers mount automatically, open in a
dedicated tab under/media/<label>, and the tab closes before unmount. - Settings gained a security banner, manual date/time with a system clock
setter, resource usage, application management, keyboard layout controls and
a bounded first-login password prompt. - Search now opens with a short action list and provides commands, files,
calculator, Terminal Trove tools and tmux buffers, with direct links to
Settings pages. - Improved HDMI/kmscon output handling and keyboard-layout updates without
restarting the session. - The initramfs is trimmed to about 7.6 MiB; the build now caches stages and
pinned kernel packages, withtools/build-fast.shfor local iteration.
Install
Download the .img.xz asset from this release and write it to a microSD card
with Raspberry Pi Imager, balenaEtcher, dd or M5 Imager.
Default login: cpz / cpz. Wi-Fi is off until it is enabled in Settings.
Documentation: https://github.com/jmas/cpzos/tree/master/docs
CardputerZero CPZ v0.3.0
Highlights
- Complete national layouts on the internal keyboard. The TCA8418
Symlayer reuses ordinary punctuation keycodes, so the old fixed ASCII overlay made Ukrainian, Russian and other layouts incomplete.cpz-layout-mapnow derives the XKB layout and the VT overlay from the sameckbcompbase:Sym+keytypes the letter that a full keyboard puts on that punctuation key (х,ї,ж,є,ґ,б,юon Ukrainian),Shift+Sym+keygives the upper case, and the displaced ASCII punctuation moves toShift+Sym. US/GB keep the existing punctuation table unchanged. - USB automount. Hard disks, sticks and card readers mount under
/media/<label>when plugged in and unmount when removed. Native (ext4, btrfs, xfs), FAT, exFAT, NTFS, ISO9660 and UDF filesystems are supported; partitioned disks mount per partition,/etc/fstabentries are left to systemd, and the running system disk is refused.cpz-automount listshows what is mounted, and the paths are included in theAlt+Oomnisearch. - Shift now works inside the Sym layer. A pinned-driver patch allows Shift to activate while the sticky Sym layer is latched, which makes the upper-case level reachable.
FnandSymstay mutually exclusive.
Fixes and tooling
cpz-keyboard-layoutno longer decides whether to push the layout by reading/etc/default/keyboard: Debian links/etc/vconsole.confto it, systemd-localed replaces that link on its first write, and the two then diverge from the layout localed actually has.localectlis now always called; localed ignores an unchanged RMLVO.- The XKB layout and the recovery-console keymap are generated from one language-aware table, so kmscon and tty2/tty3 agree.
- New unit tests cover the language-aware overlay (
tests/test_cpz_layout_map.py) and USB automount (tests/test_cpz_automount.py); the host and image verifiers check the new wiring and the driver patch. - Docs:
docs/CPZ-KMSCON.mddescribes the new layout generation anddocs/CPZ-STORAGE.mdcovers USB storage.
Image
cardputerzero-trixie-arm64-v0.3.0.img.xz is attached by the build workflow once it finishes. Flash it with the M5 Imager or write it with xz -dc … | dd of=/dev/sdX bs=4M.
First local login: user cpz, password cpz (change it when prompted). SSH is off by default.
On a non-Latin layout, Sym+key types the extra letter; tap Sym, then hold Shift and press the key for the upper case. The ASCII symbol that used to live on that Sym position is on Shift+Sym of a punctuation key (for example, Ukrainian ! is on Shift+Sym+5).
CardputerZero CPZ v0.2.1
Highlights
- Omnisearch (Alt+O) — one fzf popup for PATH commands, CPZ actions, Settings pages, files, a calculator, Terminal Trove tools and tmux buffers.
- Settings → Applications — browse a bundled Terminal Trove catalog, filter by category and language, install or remove managed apt packages, and refresh the index from the device.
- Persistent font size —
Alt+Plus/Alt+Minusnow save the kmscon size in the CPZ settings, so it survives session restarts and is editable in Settings. - Live keyboard layouts — the session generates one XKB layout per language (
cpz_us,cpz_ua, …) and pushes it through systemd-localed, so kmscon switches keymaps without restarting the session or renegotiating the display. - Theme-aware status bar — battery/brightness/network warnings use the selected theme's semantic colours.
Fixes and tooling
bluez-toolsstays installed:cpz-bt-agentruns/usr/bin/bt-agentfrom it, and the image verifier now asserts that package.- The verifier no longer requires removing
ack/net-tools; newer Raspberry Pi OS packages makerpi-swap/raspinfodepend on them, and the cleanup already keeps both. - The image build starts from a published GitHub release and attaches the built image to it; a tag push alone builds nothing.
- Host checks cover the new session files, the release trigger, the search providers, the output policy and the Terminal Trove catalog.
Image
cardputerzero-trixie-arm64-v0.2.1.img.xz is attached by the build workflow once it finishes. Flash it with the M5 Imager or write it with xz -dc … | dd of=/dev/sdX bs=4M.
First local login: user cpz, password cpz (change it when prompted). SSH is off by default.
CardputerZero CPZ v0.1.0
Full Changelog: https://github.com/jmas/cpzos/commits/v0.1.0