Repository navigation
Releases
NimbleZero v0.1.0
First public release of NimbleZero, a small Linux system for the M5Stack Cardputer Zero.
Unofficial firmware. Not an M5Stack product, and not endorsed by M5Stack or Raspberry Pi Ltd. No warranty.
Before you install
- Use a spare microSD card. Keep the card your device came with untouched; swapping cards takes you back to the stock firmware.
- This release was tested by one person on two devices (a Cardputer Zero and a Cardputer Zero Lite) plus an emulator test suite. Treat it as an early version.
- What does not work: KNOWN-ISSUES.md. What was verified and what was not: RELEASE-NOTES.md.
Install
- Download
nimblezero-v0.1.0.img.xzand check it againstnimblezero-v0.1.0.sha256. - Write it to a spare microSD card (4 GB or larger) with Raspberry Pi Imager ("Use custom"), balenaEtcher or
dd. - Put the card in the Cardputer Zero and switch it on. The first start asks on the screen for a password for the user
zero(SSH andsudo).
Launcher keys: F / X up and down, Z / C page, Enter starts, O opens Options.
The image contains the launcher, the Store, the runtime for M5Stack app packages, Python, ffmpeg and PulseAudio. (A smaller console-only minimal variant can be built from the source; it is not published as an image for this release. Manifests and documentation call the published build compat.)
Highlights
- Starts in about 7 seconds from the power switch to a keyboard launcher made for the 320x170 screen.
- Display at the panel’s full refresh rate (61.8 frames per second) without tearing; the stock driver setup reached about 39. Older programs that draw to /dev/fb0 get the fast path too. Details: DISPLAY.md.
- Store: installs M5Stack’s Cardputer Zero app packages unmodified, and M5Stack’s own launcher if you prefer it. Apps that need something this system lacks are listed with what is missing. App compatibility is not guaranteed at this time.
- Options on the device: brightness, screen-off time, volume, Wi-Fi network and country, time zone, password, SSH and network time, which launcher starts, erase all data.
- Wi-Fi setup from the keyboard, or from a wifi.conf file written on a PC before the first start.
- Read-only system partition: the power switch is always safe. Password, Wi-Fi networks, settings and /home/zero survive writing a newer image over the card.
- User zero with a password you choose at first start; no root login; SSH stays off until a password is set.
- Built-in terminal and a hardware diagnostics app (screen, keyboard, sound, sensors, radio, battery).
- Included for apps: Python 3 with Pillow, NumPy and evdev; ffmpeg; PulseAudio.
- Every start writes a boot log to the NZBOOT partition, readable on a PC. Three recovery switches work the same way, by creating or renaming a file there: vendor display settings, safe boot configuration, and data reset.
- Ctrl+Alt+Backspace closes an app that hangs.
Not Done
- Bluetooth. The firmware is in the image; nothing uses it yet.
- Camera app. The sensor is detected; v4l2-ctl and ffmpeg are present for manual tests.
- GPU acceleration (OpenGL ES) and SDL windows. An app that opens an SDL window shows nothing.
- USB-C data. The port charges only; a PC does not see the device.
- Apps installed from the Store are not kept when you write a newer image over the card.
- Not tested on any device: the display fallback for a panel without sync pulses, long runs and battery life at the faster display clock, and a unit with the Synaptics 43436s Wi-Fi chip.
If the screen stays dark or garbled
On a PC, create an empty file named nz-display-original on the card's NZBOOT partition and start again. Please open an issue with the newest nz-logs/boot-N.txt from that partition.
Files
| File | Content |
|---|---|
nimblezero-v0.1.0.img.xz, nimblezero-v0.1.0.sha256 |
the image and its checksums (compressed, and after unpacking) |
nimblezero-v0.1.0.manifest.txt |
what the image was built from |
nimblezero-v0.1.0.licence-manifest.csv |
every package and its licence |
nimblezero-v0.1.0-licences.tar.gz |
all licence texts, including the terms of the binary-only firmware |
nimblezero-v0.1.0-sources.tar, buildroot-2026.02.3.tar.gz, README-SOURCES.txt |
complete corresponding source of the packages in the image |
SHA256SUMS.txt |
checksums of the large files |
Licence of NimbleZero's own code: GPL-2.0. The image contains a few binary-only files (Raspberry Pi boot firmware, Wi-Fi/Bluetooth firmware, Bosch sensor configuration data), redistributed unmodified under their vendors' terms.