PORTABLE TOOLS / LOCAL CONTROL

Small screen.
Useful tools.

A pocket toolkit for your Cheap Yellow Display. Launch apps from SD: weather, daily notes, browser file transfer and SSH with a Bluetooth keyboard.

Get the firmware ↓Installation guide ↗

ORIGINAL ESP32320 × 2404 MB FLASHPIXELFONTS

Console home with clock, theme, radio and Shutdown tiles, SD loader and storage panel — Actual Console renderer, shown in a decorative device frame. Theme toggle also switches the paired captures.

Console home with clock, theme, radio and Shutdown tiles, SD loader and storage panel in light mode — Actual Console renderer, shown in a decorative device frame. Theme toggle also switches the paired captures.

TWO NEW RELEASES

New on your CYD

A forecast at a glance. Daily notes on your SD card.

Weather Micro

0.1.1-stack

Weather Micro light theme, public firmware-renderer fixture — Renderer fixture

Current conditions, hourly forecasts and saved places. Open-Meteo weather, with no API key needed.

Download Weather ↓App guide ↓

Quicknote Micro

0.1.0

Quicknote Micro light theme, public firmware-renderer fixture — Renderer fixture

Write with your B1. Save timestamped Markdown, recover drafts and browse your daily notes.

Download Quicknote ↓App guide ↓

Install either app from Console’s SD library. Acceptance and remaining checks ↗. Previews use public sample data.

NEW / WEATHER MICRO

The weather,
without the noise.

0.1.1-stack · Open-Meteo · no API key

One clear view of your place, temperature, conditions and today’s high and low. Tap 5H for five time/icon/temperature columns, or DETAILS for a fuller picture.

Install the SD package and wait for saved Wi-Fi and time sync.
Choose Settings → Search + save. Use the touch keyboard and select the correct region/country.
Save up to six places, choose C/F, and switch dark or mint-blue themes. Console stays within reach.

Weather guide and data limits ↗

Five-hour forecast with three rows for local times, weather icons and point temperatures (dark theme, public renderer fixture) — Hourly values are forecast temperatures at the labelled hour, rather than invented within-hour highs.

Five-hour forecast with three rows for local times, weather icons and point temperatures (light theme, public renderer fixture) — Hourly values are forecast temperatures at the labelled hour, rather than invented within-hour highs.

Four weather panels: 24-hour rain bars, wind compass, daylight arc and moon phase (dark theme, public renderer fixture) — Rain in mm, wind in km/h, schematic daylight arc and moon-phase diagram.

Four weather panels: 24-hour rain bars, wind compass, daylight arc and moon phase (light theme, public renderer fixture) — Rain in mm, wind in km/h, schematic daylight arc and moon-phase diagram.

Touch search keyboard for saved weather locations (dark theme, public renderer fixture) — Large touch search keys. Choose the correct country and region from results.

Touch search keyboard for saved weather locations (light theme, public renderer fixture) — Large touch search keys. Choose the correct country and region from results.

Weather settings for C-F, theme, places, search, network and attribution (dark theme, public renderer fixture) — Keep several places; change units and theme independently.

Weather settings for C-F, theme, places, search, network and attribution (light theme, public renderer fixture) — Keep several places; change units and theme independently.

Basic device check passed: repaired startup, location search and NOW/5H workflow. Multiple-place persistence, individual chart accuracy, physical theme/unit persistence and Console/Run last remain separately unverified. The unpublished 0.1.0 stack-overflow build is excluded. Forecast data: Open-Meteo, CC BY 4.0; location search: GeoNames. Screenshots use public fixtures and are not live forecasts.

Download Weather ↓Release notes & checksums ↗

NEW / QUICKNOTE MICRO

Catch the thought.
Keep the Markdown.

0.1.0 · offline notes · user-accepted

A small notebook with your B1 keyboard. Write a few lines, press Ctrl+S or tap Save, and keep timestamped entries in one Markdown file per day on the SD card.

Set Console’s clock, install Quicknote and wake or pair your B1.
Write, edit and resize with Ctrl+Equals / Ctrl+Minus or the touch font controls. Hidden draft checkpoints preserve unfinished text.
Use Today and previous/next day history. Later, download saved daily notes through File Server.

No cloud account or Wi-Fi is needed for editing. A valid clock is required to save dated entries. Notes are plaintext on your card.

Quicknote controls and storage guide ↗

Quicknote editor with public sample text and timestamp, save and font controls (dark theme, public renderer fixture) — Console PixelFonts in all three sizes. Dark and mint-blue themes.

Quicknote editor with public sample text and timestamp, save and font controls (light theme, public renderer fixture) — Console PixelFonts in all three sizes. Dark and mint-blue themes.

User acceptance complete: no issues reported on the tested CYD. Native sanitizer tests separately cover editing, draft recovery, durable Markdown append, bounded history and font/theme layouts. The broad physical report does not establish a full-card/removal failure matrix. The accepted binary is unchanged.

Download Quicknote ↓Release notes & checksums ↗

NEW APP / LED MICRO 0.1.0

A little colour.
On your terms.

Offline RGB control · user-accepted on the tested CYD

The board already has an RGB LED. Give it a useful control panel: choose red, green, blue, yellow or white, mix your own colour and set brightness without a network or keyboard.

Copy the three release files into SD /firmware, then choose Load from SD Card → LEDMicro-0.1.0 → Install + run.
Tap LED OFF to enable output. Choose COLOUR or PATTERN; the bottom −/+ controls adjust brightness.
FLASHLIGHT enables solid white at full brightness. CONSOLE turns the LED off before returning home.

Solid or flashing light; blue/red, green/yellow or green/white alternation; three speeds. Power always starts off. Settings stay in the app’s own namespace.

Read the LED Micro guide ↗

LED Micro colour presets, LED power, brightness and white flashlight controls in dark mode — Actual firmware-renderer fixture. The preview swatch follows the pattern; the real RGB LED is on the board.

LED Micro colour presets and brightness controls in the mint and blue light theme — Actual firmware-renderer fixture. The preview swatch follows the pattern; the real RGB LED is on the board.

LED Micro pattern controls: solid, flash, blue-red, green-yellow, green-white and speed — Five modes. Three speeds. Brightness remains adjustable.

LED Micro pattern controls in light mode — Five modes. Three speeds. Brightness remains adjustable.

LED Micro RGB mixer with separate red, green and blue channel adjustments — Independent channel mixing, plus global brightness.

LED Micro RGB mixer in light mode — Independent channel mixing, plus global brightness.

Device check passed: SD installation, primary colours, brightness, on/off, flashing/alternation/speed, white flashlight, Console return and Run last. RGB-mixer, theme and saved-preference checks have native coverage but were not separately physically reported. No measured light output, PWM timing or current claim. Screenshots are renderer fixtures, not photographs.

Download LED Micro 0.1.0 ↓Checksums & release notes ↗

THE RESIDENT LAUNCHER

Console keeps things simple.

Console 0.3.3-sleep

One small launcher, separate firmware apps. Choose an SD package, verify it and run it; return to Console when you want another tool.

Copy matching .bin, .json and licence files into the card’s /firmware folder.
Tap Load from SD Card → app → Install + run. File Server goes first to retain the clock helper.
Use the app’s Console button to return. Run last reopens your latest installed app.

Clock settings, a whole-screen theme switch and touch-wake deep sleep complete the home screen.

Read the Console guide ↗

Console SD library listing an example Terminal Micro firmware package — Firmware renderer capture. The SD library presents versioned packages; installation verifies the image and flash readback.

Wi-Fi and Bluetooth tiles are currently placeholders. Shutdown enters deep sleep; it does not cut USB power. Hold touch while powering on for at least five seconds to return to Console.

File Server displays its browser address, a large numeric code, and transfer progress — Firmware renderer capture with a reserved example address and public test file. No real access code or network is shown.

File Server displays its browser address, a large numeric code, and transfer progress in light mode — Firmware renderer capture with a reserved example address and public test file. No real access code or network is shown.

SD FILES / THROUGH YOUR BROWSER

More moving files.
Less moving cards.

File Server 0.1.2-clock

The CYD shows its address, port and a readable numeric access code. Open that address on the same LAN to browse the shared SD area.

Join a saved Wi-Fi network, or use Networks → Setup hotspot to configure another 2.4 GHz LAN.
Enter the on-screen code in your browser. Choose files to upload, download a file, or create a folder.
Watch progress on the CYD and in the browser. Cancel a transfer when needed; return with Console.

Streamed transfers and bounded buffers suit the original ESP32’s small RAM. Dark and mint/blue light themes work independently on both screens.

Read the File Server guide ↗

File Server browser interface with file navigation, upload controls and transfer status — Actual browser UI and PixelFonts, captured against a local mock API. Device networking and SD throughput are separate hardware checks.

File Server browser interface with file navigation, upload controls and transfer status in light mode — Actual browser UI and PixelFonts, captured against a local mock API. Device networking and SD throughput are separate hardware checks.

Trusted LAN use: this is HTTP, not HTTPS. The access code does not encrypt traffic. No enterprise Wi-Fi or captive-portal sign-in. A complete phone walkthrough joining a fresh LAN is still pending.

BLE KEYBOARD / VERIFIED SSH

A terminal you can read.

Terminal Micro 0.2.3-headroom

Large connection cards lead to a clean SSH shell. The same PixelFonts as Console keep the interface consistent; the terminal offers three sizes and real PTY resizing.

Add your private Wi-Fi, host and dedicated-key profiles to SD. Verify the server’s host-key fingerprint.
Wake a saved keyboard, or pair through Keyboard → Scan B1 → Pair. Winmaxle B1 is the tested model.
Select a host and Open terminal. Tap its header for font controls, Live output, disconnect and Console return.

Ctrl+Equals / Ctrl+Minus zoom. Swipe or Shift+PageUp/Down for bounded main-screen history. Your remote tools run on the host; the CYD handles input and display.

Set up a private host profile ↗

PixelFonts SSH terminal showing a short Workbench prompt, sample shell output and ANSI colours — Actual terminal renderer fed public ANSI fixtures. Default grid: 40 columns × 15 rows. This is not a live private shell.

Terminal Micro lobby with Wi-Fi, keyboard, selected host and Open terminal controls — Large cards for connection setup.

Terminal Micro lobby with Wi-Fi, keyboard, selected host and Open terminal controls in light mode — Large cards for connection setup.

Terminal Micro keyboard page with Scan B1, Pair, Disconnect and Forget controls — Pair or reconnect the saved B1.

Terminal Micro host selector showing example Workbench and Lab Server hosts — Switch hosts after disconnecting.

This is a bounded embedded ANSI terminal, not a complete xterm implementation. Host-key pinning is mandatory. Keep the SD card private: it contains your dedicated SSH key.

USAGE 0.2.0 / EARLY ACCESS

A home for
your allowances.

Previously Ollama Usage · now multi-provider

Ollama: session/weekly allowances or included credits, reset countdowns and hourly 24H requests.
Codex: actual five-hour and weekly windows through your existing signed-in CLI. OAuth stays on the Mac; no OpenAI API key is required.
OpenRouter: optional API-key spending, remaining budget and daily/weekly totals.
Your service: add an authenticated HTTPS JSON feed. Up to four independent sources.

Tap the source name to switch. Readable PixelFonts, larger touch controls, light/dark themes and Console return keep the interface familiar.

Setup and provider guide ↗

Usage source picker listing Ollama, Codex, OpenRouter and a custom My AI source — One source per page. Each retains its own metrics, freshness and retry schedule.

Usage source picker in the mint and blue light theme — One source per page. Each retains its own metrics, freshness and retry schedule.

Ollama allowances inside Usage 0.2.0 — Ollama allowances and reset timers.

Ollama allowances inside Usage light theme — Ollama allowances and reset timers.

OpenRouter key budget and spending with public example data — OpenRouter key budget; optional key, fixture-tested.

OpenRouter budget and spending in the light theme — OpenRouter key budget; optional key, fixture-tested.

Ollama hourly request activity in Usage — Hourly history where the source reports it.

Ollama hourly activity in the light theme — Hourly history where the source reports it.

01 / PREPARE

Reuse your login

Run the provided helper on the signed-in Codex host. It prepares a private read-only HTTPS bridge and device settings.

02 / PROVISION

Keep secrets separate

Use an SD reader for /private/usage.json and its bridge CA. Real keys and private certificates are never bundled.

03 / INSTALL

Choose your source

Console → Load from SD Card → Usage-0.2.0 → Install + run. Tap the source name to switch or view how to add one.

Early-access evidence: builds, sanitizer/HTTPS tests and live host Ollama/Codex parser checks pass. OpenRouter/custom screens use fixtures. SD installation, Codex meters and switching back to Ollama are user-confirmed on the tested CYD. Extended memory, reconnect, sleep and Console checks remain pending. The Codex host must stay awake; Ollama and OpenRouter use direct verified HTTPS independently.

Get Usage 0.2.0 ↓Checksums & release notes ↗

BEFORE YOU INSTALL

One tested hardware profile.

These builds target the original ESP32, dual-UART-USB ESP32-2432S028R with 4 MB flash and resistive touch. CYD clones vary. Exact display silicon and PSRAM identity remain unverified; no PSRAM is assumed.

Firmware	Role	Version / status
Console	Resident factory launcher	0.3.3-sleep · 336,000 bytes
File Server	SD-installed app + clock helper	0.1.2-clock · 921,888 bytes
Terminal Micro	SD-installed SSH app	0.2.3-headroom · 1,376,832 bytes
LED Micro	SD-installed offline RGB LED control	0.1.0 · user-accepted · 306,240 bytes
Usage	SD-installed multi-provider dashboard	0.2.0 · early access · 1,050,400 bytes
Weather Micro NEW	Open-Meteo forecast and saved places	0.1.1-stack · 1,100,288 bytes
Quicknote Micro NEW	Offline daily Markdown notes	0.1.0 · 807,408 bytes

Existing Console users can copy the SD library. A first install needs a backup and the matching bootloader, partition table and Console image. Never flash an app-only image over the resident Console. Both USB connectors are UART bridges; this ESP32 cannot expose its SD as a native USB disk.

Download release bundle ↓Read before flashing ↗Acceptance & limits ↗

OPEN SOURCE / HUMAN + AGENT

Build the next useful tool.

The repository includes the shared hardware layer, clock, fonts, tests and a buildable app generator. A portable specification keeps future firmware and contributors consistent.

Start with the contract

Read AGENTS.md for preservation and validation rules, then SPEC.md for architecture and release requirements.

Pins, partitions and toolchain ↗

Keep the visual language

Design guidance defines PixelFonts, mint/teal themes, large touch targets and clear state feedback.

Brief, README and handoff templates ↗

Give agents a reliable entry

SKILL.md points an agent to the right resources and build workflow. It grants no permission to flash or publish.

Minimal firmware example ↗

Share the work honestly

Humans set the goal and judge the real screen. Agents implement, run checks and package. Record observed acceptance, limitations and the next action so another contributor can continue.

Current handoff ↗

Console, File Server, Terminal Micro, LED Micro, Quicknote and Weather preserve accepted hardware builds. Usage is an early-access candidate. Public sources have been reorganised into shared components; a rebuild is a candidate until tested on hardware. Renderer screenshots and browser fixtures demonstrate layout, not physical acceptance.

Small screen.Useful tools.