Home Screen

You are on the main screen — the launcher. It lists the apps on this device; pick one to open it.

Getting around

Up and Down move through the list, and the centre button opens the highlighted app. The button bar along the bottom always shows what the five coloured buttons do on the screen you are currently looking at, so when in doubt, read the bar - a blank label means that button does nothing.

HOME is how you leave a screen: press it from anywhere in the menu and it returns you here, to the launcher. Red has no fixed job: on most screens it carries no label and does nothing, like any other blank button on the bar. Where a screen gives Red a real job - clearing a log, stopping a running signal, forcing a trigger, sending or cancelling a pending change - its label says so.

Home-screen themes

Touch an unused part of the home screen to open Pick your theme. Up and Down move through the available built-in and SD-card themes while a preview is shown on the right. Press the centre or OK button to apply the highlighted theme, or Cancel to keep the theme you were using. The picker has no colored soft-menu bar because OK and Cancel provide those actions directly.

Below the preview is an eight-slot touch grid. Mount SD gives the card to MAIN and mounts its filesystem; Unmount SD safely unmounts it and gives it to the USB card reader. The confirmed current state is shown by the corresponding button turning green. Light +10% and Light -10% adjust the display backlight in ten-percent steps, clamped from 0 to 100%. The four lower slots are reserved for future controls.

Theme files are plain text files in /themes on the SD card. The optional /themes/home.theme file is loaded at startup. FWI images used by a theme go in /themes/assets.

Each non-comment line adds or configures one object:

panel color RRGGBB
panel tile IMAGE_ID
text X Y SIZE RRGGBB TEXT
imgrom X Y IMAGE_ID
imgfile X Y IMAGE_NAME
wili8 X,Y,L,W,SCALE,SCRIPT
batt X Y
battcur X Y [COLOR]
stats X Y [BACKCOLOR] [FORECOLOR]
applist X Y W H [VISIBLE]
menubar VISIBLE
button X,Y,W,H,CAPTION,FORECOLOR,BACKCOLOR,LAUNCHITEM

imgfile supports static and animated 16-bit FWI files. Its current decoded frame is cached in PSRAM, so static images load from SD once and animations read SD only when advancing frames. wili8 embeds a Wili8 canvas; use wave for its built-in animation. Other script paths are stored for future script support. Wili8 canvases form the bottom theme layer, so the battery, status panel, labels, and buttons draw over them. The built-in FreeWili 2 theme uses wili8 230,35,256,256,2,wave. A button can launch a built-in app by name or run a script; UF2 launching is reserved but is not implemented yet. Use hide for the optional applist or menubar visibility value when the theme supplies its own controls.

The complete authoring reference is in docs/home-screen-themes.md in the firmware repository.

Help on any screen

Press Cancel on a screen to see its help page, if it has one. Hold Cancel if a short press is already used for something else on that screen.

Inside a help page, Pg Dwn and Pg Up move through the text and Green closes it.

Help pages live in two places. Each view's own page is built into the firmware, so it is always available. Anything placed in a /help/ folder on the SD card can also be shown, which is a way to carry your own notes on the device without reflashing it.

If a screen says there is no help

That screen has no page written for it yet. It is not an error, and nothing has gone wrong with the device.