Skip to content

Releases

CardputerZero CPZ v0.9.0

Choose a tag to compare

@jmas jmas released this 19 Nov 23:44

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+O step 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 Network switch.
  • 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. wifitui and bluetuith remain 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/Bt when 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+O brightness handling through cpz-media-keys and a stepped cpz-brightness helper.
  • SSH is disabled by default; ssh.service and ssh.socket stay 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

Choose a tag to compare

@jmas jmas released this 19 Nov 11:35

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+Tab now 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. ~/.cache is created with the first user's ownership, so mc, mpv and every other program that writes an XDG cache no longer fail with Cannot 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 integer mouse_speed key (tenths of libinput's -1.0..1.0 range) and a Mouse Speed scale on the Input page; persisted in the user and system settings.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: loads cpz-pointer-speed.so, a small LD_PRELOAD shim that applies the speed on each libinput DEVICE_ADDED event. It is compiled in stage3 while the toolchain is still present and uses dlsym, 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 ~/.cache explicitly before generating the tmux key cache; verify-image.sh and verify-stage.sh reject 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 in docs/CPZ-KEYS.md.
  • Tests: coverage for the published mouse speed, the Settings-inclusive tab cycle, the .cache checks 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

Choose a tag to compare

@jmas jmas released this 19 Nov 06:53

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+M and 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; F9 still opens the menu.
  • Search opens mounted disks. Each mounted drive has an Open <label> [tab] row above Unmount, 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 q returns 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_DEVICES instead 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-open dispatches by mime type, mc uses MC_XDG_OPEN, lf gets its own open, mpv renders with vo=wlshm, and subtitles load from the film's folder or a Subs folder (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.ini with 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_POINTER udev 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-music when 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

Choose a tag to compare

@jmas jmas released this 18 Nov 01:09

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-keys registry now backs
    Settings → Keyboard → Shortcuts, the Alt+H reference, Search and the
    generated tmux bindings. Defaults are two keys only: Alt+A / Alt+F switch
    tabs, Alt+G / Alt+M resize text and Alt+Space changes the input layout.
  • Volume and mute from the keyboard. Alt+U / Alt+I move the default
    output in 5% steps and Alt+0 toggles mute through the same wpctl sink as
    Settings → Sound.
  • Battery guard. cpz-battery-guard warns 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+O opens with mounted drives (including
    Unmount rows), installed apps, Settings pages, daily actions and confirmed
    Reboot/Shut Down. The apps provider 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.md and CPZ-UI.md, refreshed site copy in
    English plus 10 translations, and docs/RELEASE.md with the single release
    format.

Changes

  • Moved every default binding into the settings-backed cpz-keys registry;
    removed duplicate aliases and chords that needed the Sym or Fn layer.
  • Added cpz-volume for volume steps and mute, wired to the status-bar volume
    token and Settings → Sound.
  • Added cpz-battery, cpz-battery-guard.service and /etc/cpz/battery.conf,
    with a boot-time charge check in cpz-login.
  • Expanded CPZ Search with mounted media, installed apps, direct app pages,
    power actions, per-row key hints and the apps provider; 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.Z title, a fixed notes template and
    tools/release.sh --publish; release images now use the documented cpz
    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

Choose a tag to compare

@jmas jmas released this 17 Nov 19:58

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, with tools/build-fast.sh for 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

Choose a tag to compare

@jmas jmas released this 17 Nov 17:59

Highlights

  • Complete national layouts on the internal keyboard. The TCA8418 Sym layer reuses ordinary punctuation keycodes, so the old fixed ASCII overlay made Ukrainian, Russian and other layouts incomplete. cpz-layout-map now derives the XKB layout and the VT overlay from the same ckbcomp base: Sym+key types the letter that a full keyboard puts on that punctuation key (х, ї, ж, є, ґ, б, ю on Ukrainian), Shift+Sym+key gives the upper case, and the displaced ASCII punctuation moves to Shift+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/fstab entries are left to systemd, and the running system disk is refused. cpz-automount list shows what is mounted, and the paths are included in the Alt+O omnisearch.
  • 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. Fn and Sym stay mutually exclusive.

Fixes and tooling

  • cpz-keyboard-layout no longer decides whether to push the layout by reading /etc/default/keyboard: Debian links /etc/vconsole.conf to it, systemd-localed replaces that link on its first write, and the two then diverge from the layout localed actually has. localectl is 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.md describes the new layout generation and docs/CPZ-STORAGE.md covers 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

Choose a tag to compare

@jmas jmas released this 17 Nov 14:17

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+Minus now 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-tools stays installed: cpz-bt-agent runs /usr/bin/bt-agent from it, and the image verifier now asserts that package.
  • The verifier no longer requires removing ack/net-tools; newer Raspberry Pi OS packages make rpi-swap/raspinfo depend 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

Choose a tag to compare

@jmas jmas released this 17 Nov 10:27