Release Notes¶
What each release changed, newest first. Firmware comes from the installer; the version a machine is running is in the system menu under About. Studio always runs the newest one.
Every release replaces the whole flash image, /home included. Copy anything you want to
keep off the device before flashing — see Console.
In development (after 3.0.0)¶
Not in a release yet: this is what the development branch — and Studio, which is built from it — does now. These pages describe it.
Changed: writing an app¶
Apps written for 3.0.0 need small changes:
- No start code at the end of the file. The runtime starts the
FmrbAppsubclass the file defines; delete the trailingMyApp.new.start(and itsbegin/rescue). A file with more than one subclass names the one to start withclass = "MyApp"in its metadata. A file where none can be picked, or an exception while starting, shows the reason in an error window. → Hello World @gfxdraws from the top-left of the app's own area. Inside the frame of a framed window, the window's top-left without a frame, the screen's in fullscreen.@user_area_x0and@user_area_y0are gone: drop the@user_area_x0 +additions. Mouseev[:x]/ev[:y], sprites and UI widgets use the same origin;ev[:wx]/ev[:wy]andwindow_gfxare there for the window's own coordinates. → Drawing- System methods moved to
FmrbSystem. The 34 class methods that change the machine (reboot,set_wallclock, the Wi-Fi, BLE, power and volume settings ...) areFmrbSystem.<name>now;FmrbApp.<name>keeps the ones an app reads. → Application clear_timeisclear_timer.- Metadata in the
.rb. The.app.tomlkeys can also go in a#---fmrbcomment at the top of the file; with both, a key in the.app.tomlwins. → App Config - Lua apps run on a shell the system provides: define
on_create/on_update/on_eventand draw with the globalgfx. → Other languages - Lua and MicroPython follow Ruby's argument order. Lua's
gfx:draw_textis(x, y, text, color), and the sizes are functions:FmrbApp.user_area_width(),user_area_height(),window_width(),window_height(). In MicroPython,_fmrb.read_fileand_fmrb.file_sizegave way toFmrbFile, andgfx.clear()needs its colour. → Other languages
New¶
- Kanji conversion in kana input, with a dictionary on the SD card. → The Desktop
- Wi-Fi from the screen. The Network dialog opens a Wi-Fi page: pick a network, type the password; up to five are remembered and the strongest in reach is joined. → Connecting to Wi-Fi
- The window menu. Right-click a title bar for Send to, Reload and Close.
- Frameless windows (
window_frame = "none"), with the Avatar sample. → App Config - Asterism wire protocol 2 (the asterism gem 0.14.0): connections are objects, topics carry declared types, and a shared place holds data with no single owner. Not compatible with 3.0.0 on the wire. → Network
- Sending files and apps between machines over Asterism, with the Receiving app deciding
whether, and from whom, this machine takes them. In the Shell,
moveis nowamove, besideasend,anodesandareceive. → Shell Commands - The Linux program: a CRT look for the whole screen, Log Out in the power menu, touchpad taps and touch screens, routers with TLS, and an arm64 package. → The Linux Program
- WebAssembly apps. Apps written in C, TinyGo, Rust or Zig and compiled to WebAssembly
run on WAMR on the ESP32-P4 boards, the Linux program, the simulator and Studio (not on
the ESP32-S3 boards), with the same functions Ruby apps have. The SDK is
family-mruby-sdk; the same tour app in
each language ships under
/app/tinygo,/app/rust,/app/zigand/app/c, and an app dropped on the Studio page runs there. → WebAssembly Apps - One definition for every language. The functions apps call are generated from the
firmware's type definitions for Ruby, Lua, MicroPython and WebAssembly alike. Lua gained
sound, the log, the clipboard, the clocks, the window's state and files; MicroPython gained
the rest of
FmrbGfx(arcs,get_pixel, masks,blend_rect...),FmrbApp.uptime_ms()and 64-bit integers. → Other languages FmrbFile: read, write, append, list and delete whole files by path, the same in every language. → Files & I/O- A new boot. The logo comes on like a CRT television, over a chord that rises a fifth, and the desktop is up in about 1.2 seconds instead of 2.7. → The Desktop
- The error window closes with
ReturnorEscas well as a click. The Monitor has a page for the WebAssembly runtime,psin the Shell has an ENGINE column, and the launcher has an icon per language. - Smaller storage. Sprites, tile sheets, wallpapers and icons are palette PNGs
(
SpriteImage#load_bmpandTileSheetread PNG as well as BMP), and the voices are IMA-ADPCM WAVs, whichplay_wavplays. On the ESP32-P4 boards the Japanese fonts moved to a partition of their own. → Image & Icon Files, Sound, Hardware /homeover Wi-Fi. The file endpoints reach every path, keys included, so/homecan be backed up before flashing and put back after. → Remote Desktop, Security/app/testand Walk Scroller are left out of every board's image and the public browser build; they can be sent to a board over Wi-Fi.
3.0.0 — 2026-11-07¶
Applies to Modern, Retro, the headless boards, the Linux program and Studio.
New¶
- The Linux program. Family mruby as one program on a Linux PC: an amd64
.debon the GitHub release (Ubuntu 26.04 or newer), chosen at the login screen. → The Linux Program - Headless boards. M5Stack StickS3 and AtomS3R run a single app on an Asterism network, flashed from the Web Installer.
- Moving a running app. An app that declares
movable = truecan be written to an image and carried on from it, on the same machine or another one. → Application - Asterism. Machines on one network call each other's Ruby objects, with a game host for shared tables: Hide Jong (mahjong), Othello and a drawing board. → Default Apps
- A high-resolution fullscreen. An app with
fullscreen_hires = trueruns at 640x360 while it is fullscreen on Modern and in Studio. - Mute and volume. A speaker in the menu bar mutes the whole machine with one click, and Config has a volume from 0 to 10. Both are remembered, on every machine and in Studio. → The Desktop
- Icons on the desktop. The Launcher, the Editor, the Shell, the File Manager and a few apps sit on the wallpaper; the launcher's right-click menu adds and removes them. → The Desktop
- A power button at the right end of the menu bar. Reset moved there from the system menu.
- BLE Setup. A few minutes, opened on the machine, in which the web console may read and
write the Wi-Fi and Asterism settings and the keys; outside it they are never read
remotely. The speech service's API key moved from the service list to
/home/secrets.toml. → System Services - The editor's font. View → Font picks 8, 12 or 16 pixels, kept in
/home/editor.toml. - One clipboard for every app, joined to the PC's in the Linux program and to the page's in
Studio.
FmrbApp.clipboard/FmrbApp.set_clipboard. - Small helpers for app screens.
fit_text,wrap_text,draw_text_linesanddraw_buttonon@gfx, andFmrbUI::HitAreasfor a screen drawn whole. → Drawing, UI Widgets - Settings and state for apps.
app_settings(in/home) andapp_state(in/tmp); the File Manager reopens in the folder it was closed in. → Application FmrbAudio#main_volume=sets the volume of the music alone. → Sound- Resizable windows show a triangle in the bottom-right corner to drag. The File Manager asks before it deletes.
- The launcher's rescan is a Reload button in its title bar (or
F5).
Changed¶
- App memory on the ESP32-S3 boards. Three pools in all — one ordinary and two large — so three user apps run at a time. → Limitations
- The Wi-Fi settings are read from
/home/wifi.tomlfirst, then/etc/wifi.toml. - HTTPS on the boards trusts a trimmed set of root certificates instead of the full bundle.
Updating¶
The core and the graphics-audio firmware must be the same version: on Retro, flash both chips. The kanji dictionary for the development branch's kanji conversion is not part of 3.0.0.
2.1.0 — 2026-09-09¶
Applies to Modern, Retro, the simulator and Studio.
New¶
- Family mruby Studio. The firmware is compiled to WebAssembly and published, so the desktop, the editor and the sound chip run in a browser tab with nothing installed. → Studio
- The App Store. It heads the launcher, fetches a published list over Wi-Fi, shows what
fits on this machine and installs into
/app/usr. On both boards and in the browser. - System services (Modern). Small resident jobs: the clock sets itself from the network, the machine publishes its own address, and text can be read aloud. The list is a file you can edit. → System Services
- Colours you can change. The window frame, the desktop, the editor and the shell take
their colours from the system theme, and any of them can be overridden by name in
/home/colors.toml. The shell has acolorcommand that writes it for you. → Colours - One table decides which app opens a file. A
.mdopens as a presentation, a.nsfin the music player, a.rbruns. → File Associations - New apps. PicoRabbit presents a slide deck written in Markdown, Robo Explorer is a maze you solve by writing the robot's brain, and Modern gains a video player, a microphone spectrum and a readout of its motion sensor. → Default Apps
- Japanese in the editor. Kana input with
Ctrl+Space, kanji on screen, and an editor that takes the whole screen. - Help on every method.
F1in the editor answers for all 577 of them, in two layers. - UI widgets. Buttons, lists, checkboxes and the rest, for apps that want them. → UI Widgets
FmrbNet.request. Fetch something without stopping the app, with the same code on a board and in the browser. → Network- The mouse wheel. The editor, the shell, the log and the file dialogs scroll with it.
- Files and apps over Wi-Fi on Retro too.
/fsand/appanswer on both machines now; only the screen is Modern's. → Remote Desktop - Each board names itself.
fmruby-XXXXXX.local, after its own MAC, andfmruby.localstill answers. → Connecting to Wi-Fi boot_splashandstartup_app. Skip the logo and the jingle, or open one app as soon as the desktop is up. → The Desktop- WAV playback (Modern).
play_wavmixes a file on top of the sound chip. /homeis yours. The samples, sprites, sounds and decks moved to/usr/share, and/homeships empty. → Files & I/O
Changed¶
on_eventno longer needssuper(ev). The base class keeps its own state in@_-prefixed names, and@running/@nameare read throughrunning?/name. Apps written against 2.0 keep working: an oldsuper(ev)reaches an empty method. → FmrbApp- The theme presets are
light,darkandcyberpunk.classicis gone; what it named islight. - The falling-block sample is BlockGame. Only the name changed.
flappy.rbisflappy.app.rb, like every other app.- Studio no longer offers colours on the page. Pick a theme in Config, inside the machine.
- Modern's app pool is 1024 KB, and 2048 KB with
large_memory = 1. Retro is unchanged. → Limitations app_spawn_margin_kbdecides how much internal RAM a start has to leave for the rest of the machine. → System Configuration
Updating¶
Retro has to be flashed on both chips
The protocol between the two chips went from 4 to 5, and the check is strict: a 2.0.x
fmruby-graphics-audio against a 2.1.0 fmruby-core does not boot. Flash both from the
installer.
→ Firmware Update
Modern is one chip and needs only the Tab5 firmware.
2.0.1 — 2026-08-08¶
A maintenance release. The flash image stopped carrying the caches a development machine
leaves behind, [[launcher_exclude]] hides whole app categories from the launcher, and
Retro's desktop wallpaper reaches the WROVER as it already did in the simulator.
Both chips are at protocol 4, as in 2.0.0, so a 2.0.0 board can take this on one chip.
2.0.0 — 2026-08-07¶
The release that added the second machine.
New¶
- Modern (ESP32-P4). A stock M5Stack Tab5, flashed from the browser, with its own panel, speaker, touch screen and Wi-Fi. → Modern
- Remote desktop. The Tab5 serves its screen over Wi-Fi, and a browser on the same network drives it with a PC keyboard and mouse. → Remote Desktop
- FMRuby BASIC. A Family BASIC-compatible interpreter with its own text screen, sprites and sound. → MicroPython and BASIC
- MicroPython. A
.pyfile runs as an ordinary app. - MIDI. Serial MIDI out on the Tab5's GROVE port, MML from Ruby, and a player for standard MIDI files. → MIDI
- A debugger on the device. Breakpoints and variables from the editor, and the same session over BLE or TCP from a PC. → Debugging
Ctrl+Tab. Switch between the running apps, and park a fullscreen one where it stands. → The Desktop- Per-app stack size.
task_stack_kbin.app.toml, for an app that needs more than the default. → App Config - The Spinel ahead-of-time compiler became the standard engine for the kernel and the desktop, and the boot scan went from 13 s to 7.8 s.
- The filesystem took its current shape:
/app,/usr/share,/etc,/var—/datais gone. - Two fingers on the Tab5's touch screen are a right click.
Updating¶
Retro has to be flashed on both chips: the protocol between them went from 3 to 4.
1.0.0 — 2026-05-19¶
The first release. Retro (the narya-board) with the desktop, the launcher, the editor, the shell, tile maps and rounded windows, plus the sprite and map editors that run in a browser on the PC side.