Install Inkhaus
Connect your M5Paper with a USB cable and install Inkhaus here in the browser. No tools to download. Your settings and SD card are kept when you update.
1. Choose a version
2. Install
A browser window asks for the USB port: pick the new entry that appears when you plug in the M5Paper. Your settings and SD card are kept.
This browser cannot install from a page
Firefox and Safari do not support Web Serial, which this page needs to talk to the M5Paper. Open this page in Chrome, Edge or Opera on a computer, or use the installer app:
Offline or other ways to install: docs/FLASHER.md
Could not load the version list
Check your connection and reload the page, or use the installer app.
Edit device config
Read config.yaml from the M5Paper, change it here and write it back over USB. Everything stays in this browser. Nothing is uploaded. Needs Inkhaus 1.5 or newer on the device.
1. Connect and read
2. Edit config.yaml
Read the device first.
3. Write to device
Disabled while the check shows an error. The M5Paper restarts and loads the new layout (about 10 s). Limit 64 KB.
Optional: Wi-Fi and Home Assistant token
Only needed on a new device or when they change. Nothing you type is stored or sent.
This page does not store, send or log what you type here.
It goes from this browser to the M5Paper over the USB cable, nowhere else.
Write-only: the device never sends secrets back, so these fields start empty.
Writing replaces the whole secrets.yaml on the device, all Wi-Fi networks included.
Before you start
- Use a data cableSome USB cables only charge. Use one that also carries data.
- Windows: driverIf no port shows up, Windows needs a USB driver once (Mac and Linux do not). Older M5Paper boards use a CP2104 chip (CP210x driver), newer ones a CH9102 (CH9102 driver).
- Pick the right browserChrome, Edge or Opera on a computer. Not Firefox or Safari.
After the install
The M5Paper restarts and asks for its files. Copy these two files to the root of its SD card (FAT32), put the card in, and restart it:
config.yaml your tabs and widgets secrets.yaml Wi-Fi and Home Assistant token