TFN OS GitHub

Free and open source, under the MIT licence. The latest release

A small, open operating system for ESP32 touch boards.

Games that you play by tilt and touch, tools for your electronics bench (IR, 433 MHz, I2C, MQTT), play with a friend by radio over ESP-NOW, and an app store where each app is signed. It is free, and it installs from this site.

Install TFN OS See the apps

You need Chrome or Edge on a computer and a USB cable that carries data. The install takes about two minutes.

THE TURNING WOOD on the Touch-LCD-3.49: a painted room inside a tree, with a round brass door in the middle.
Seven of the games on the Touch-LCD-3.49, a board about 10 cm long: THE TURNING WOOD, CUBBY, DIRT KINGS, FOUR SEASONS, INK KARTS, DEEP CURRENT and MURANO.
54 apps in the store

What a small board can do

Free and open source (MIT). No account, and no cloud of ours between you and your boards.

Play and learn

  • Games for tilt and touch

    24 games made for a board in your hand: a 3D island, a painted adventure, kart races, and board games against the computer.

    CUBBY · THE TURNING WOOD · INK KARTS · CHESS

    In release 1.0.4

  • Play with friends by radio

    Two to six boards play together over ESP-NOW, with no router and no internet. WALKIE and TALKIE carry your voice.

    DIRT KINGS · BACKGAMMON · SEA BATTLE · WALKIE

    In release 1.0.4

  • The board is the controller

    A motion engine on the IMU at 200 Hz: tilt, turn, knock, shake and steps. The microphones hear a clap.

    TILT · HOP · COIL RIDER · LEVEL

    In release 1.0.4

  • Make music

    Beats and polyrhythms on glowing rings, ear training, a tuner, a metronome. Over USB the board is a MIDI controller or a microphone.

    RING SEQUENCER · SIGHT · TUNER · MIDI · MIC

    In release 1.0.4

  • Learn with no internet

    Wikipedia from the SD card, the night sky through the board, math step by step, how a computer works, Morse code.

    WIKI · SKY · INTEGRALS · LINEAR ALGEBRA · BITS · MORSE

    In release 1.0.4

  • A clock with the real sky

    At rest the board shows the time over the sky of your place: the sun, the moon and the weather. The Hebrew date and the holidays too.

    STANDBY · WEATHER · HEBREW CALENDAR · CLOCK

    In release 1.0.4

Make and connect

  • A second ESP32 as its hands

    Pair a cheap ESP32 over ESP-NOW and give it modules: IR send and receive, 315 and 433 MHz, relays, buttons, motion and door sensors.

    COMPANIONS · CONTROL

    In release 1.0.4

  • Radio and bench tools

    Read and send IR codes, read 315 and 433 MHz remotes, see the 2.4 GHz band, and talk to devices over UART, I2C and MQTT.

    IR DECODER · RF DECODER · SDR · SERIAL MONITOR · I2C SCANNER · MQTT

    In release 1.0.4

  • Bluetooth keyboard, mouse and gamepad

    The board as a BLE HID keyboard, a touchpad or tilt mouse, media keys, or a game controller for a computer, a phone or a TV.

    BT KEYS · GAMEPAD

    In release 1.0.4

  • Bring your ESP-IDF code

    An app can call about 800 ESP-IDF functions: sockets, TLS, I2C, SPI, BLE and more. Build it with the SDK and push it to the board in seconds, or try it in the desktop simulator.

    the SDK · the simulator

    In release 1.0.4

  • An app store, and your own

    Install with one tap from the signed store (ECDSA P-256). Share your own apps: sign them with your key and serve them to your boards.

    STORE · poolmgr

    In release 1.0.4

  • A web page on each board

    From a browser on your network: install apps, move files, see the screen, set up the companions, talk by WALKIE. A JSON API too.

    In release 1.0.4

Smart, safe and yours

  • A voice and a small brain on the board

    Text to speech (TTS), speech to text (STT) and a small language model (LLM), with no internet: the board reads aloud, and you talk to it.

    VOICE · TALK · DETECTIVE

    On our test boards

  • Notifications

    Apps check things in the background, also with the screen off, and tell you. Gmail, Reddit and Telegram run on our test boards.

    In release 1.0.4

  • Signed updates that roll back

    The board checks the signature of each firmware and each app. An OTA update that fails its self-test goes back to the old one.

    see the trust map

    In release 1.0.4

  • Your own pool of boards

    Your boards trust each other with keys that only you keep. poolmgr updates them one at a time and stops at a failure.

    poolmgr

    In release 1.0.4

  • Keys stay on the board

    Apps keep tokens and passwords in a secret store. A protected build adds flash encryption, for keys such as an API key.

    A build option

  • Six boards, a layout for each screen

    ESP32-S3 and ESP32-P4: a long bar, round AMOLED screens, a 5-inch tablet. Each app has a layout for each screen shape.

    Touch-LCD-3.49 · CoreS3 · AMOLED · Watcher · Tab5

    In release 1.0.4

Games made for a board in your hand

The games of the store use the whole board. You tilt the board to steer, shake it to roll the dice, and drag, pinch or tap the glass. Most of them speak English and Hebrew. Point at a picture to see the game move.

  • CUBBY: a small robot on treads next to a cube of junk, on a sunny island.
    CUBBYA small robot presses junk into cubes and builds his way up an island. In 3D.
  • THE TURNING WOOD: a painted tree in a snowy wood.
    THE TURNING WOODA painted adventure. Turn the whole wood to the season that each place needs.
  • MURANO: hot glass glows on the pipe in a glass workshop.
    MURANOBlow glass in a Venice workshop in 1740. Turn, blow and shape it before it sets.
  • DIRT KINGS: four monster trucks race on a dirt track.
    DIRT KINGSMonster trucks in a dirt arena. Hold the board as a wheel, and race 2 to 4 boards.
  • GUMMY SIEGE: a gummy bear flies at a fort of crackers and chips at night.
    GUMMY SIEGESend gummy bears into forts of chips and pretzels. 30 levels with real physics.
  • ORBITAL: a tug tows a barge in orbit above a blue planet.
    ORBITALFly a rescue tug round a small planet, with real orbits and thin air.

All the apps of the store

Two boards, no router

Open the same game on two boards, and they find each other by radio (ESP-NOW). You need no WiFi network, no internet and no account. Boards on the same WiFi play too.

Two boards
CHESS, CHECKERS, BACKGAMMON, SEA BATTLE and CUBBY
Two to four boards
DIRT KINGS
Up to six players
BOULEVARD, on one board or on more, with bots
Your voice
WALKIE and TALKIE: push to talk from board to board
DIRT KINGS on the first board: four monster trucks on a dirt track named MOON PIT.
The same race on the second board, three seconds later.
One race of DIRT KINGS on two boards, by radio.

A clock that shows the real sky

When the board rests in the menu, STANDBY shows the time over the sky of your place: the sun at its real height, the moon in its phase, and the clouds, rain or snow of the weather now. At night it changes to a dim, warm clock. A tap brings the menu back.

Faces
LIVE SKY, GLANCE and NIGHT
GLANCE
Four tiles that you choose: the weather, the Hebrew date, new notices, the next alarm or timer, the battery, friends near you
Weather
From Open-Meteo, with no key and no account
Screens
A layout for each board, the round ones too
LIVE SKY at 10:30: a blue sky with clouds, 22 degrees.
LIVE SKY, in the morning
GLANCE: the time, and four tiles: the weather, the Hebrew date, five new notices and the sunset time.
GLANCE, with four tiles
NIGHT: 23:40 in dim amber on black, and the next alarm at 06:40.
NIGHT, from 23:00

Tools for your bench

Look at a bus, a serial port or an MQTT broker with the board in your hand. The tools are in the store. WALKIE, TALKIE, GAMEPAD and FILES come with the system.

SERIAL MONITOR
A serial terminal for a device on the pins, with AUTO baud, and text or hex.
I2C SCANNER
Each device on the bus, live, with its ID registers and a wiring sketch.
MQTT
A client of your broker, with the last value and a chart of each topic. Or the broker of your network.
TOUCH LAB
The raw reports of the touch panel on a timeline. FREEZE saves them to a file.
MIDI
A MIDI controller over Bluetooth or USB, with no driver.
GAMEPAD
The board as a Bluetooth game controller for a computer or a phone.
LEVEL
A spirit level, a ruler and an angle meter.
CLOCK
Alarms that ring in any app, timers, a stopwatch and 46 cities.
WEATHER
Now, the next 24 hours and 10 days, with rain, wind, UV and air quality.
DICE
Real 3D dice, from one die to a D&D set.
WALKIE and TALKIE
Push to talk from board to board. TALKIE is one big button, for a child.
FILES
The files of the board and of its SD card. Install an app from the card.
I2C SCANNER: a map of the bus addresses, with ES8311, TCA9554 and SSD1306 found.
I2C SCANNER
MQTT: the topics of a test broker with their last values.
MQTT
SERIAL MONITOR: lines from a device at 115200 baud.
SERIAL MONITOR

Signed, open, and yours

The store and the updates

The STORE app installs apps over WiFi, to the board or to its SD card, and the app page of this site installs them over USB. Big games bring a data pack for the SD card: 12.8 MB for THE TURNING WOOD.

The store signs each app, and the release key signs each firmware. The board checks each signature itself. A new release must pass its self-test, or the board goes back to the last good one. See who signs what: the trust map

Open source

TFN OS is free, under the MIT licence. The code, the SDK to make your own apps, a desktop simulator that runs the real firmware code, and the pool manager are on GitHub.

You need no account and no sign-in. Your boards can trust each other with keys that only you keep. How it works

The boards

Each app has a layout for each screen shape. The install page writes TFN OS to all six boards. New to these boards? Start with the Touch-LCD-3.49: TFN OS started on it, and it has each part that the games use.

Touch-LCD-3.49640 x 172
CoreS3320 x 240
AMOLED-1.75C466 round
AMOLED-1.8368 x 448
SenseCAP Watcher412 round
Tab51280 x 720

Drawn to the same scale from the real screen sizes. The cases are close, not exact. The outlines show the real shape of each board and its screen.

Touch-LCD-3.49 Waveshare

3.49 in, 640 x 172, a long bar. ESP32-S3, 16 MB flash.

Motion sensor, speaker, two microphones, SD card, BOOT key.

Each app has a bar layout. The games keep their controls near the ends, where the thumbs rest.

Waveshare

CoreS3 and CoreS3 SE M5Stack

2.0 in, 320 x 240. ESP32-S3, 16 MB flash.

Motion sensor, speaker, two microphones, camera, microSD slot, in a closed case.

The SE has no motion sensor and no camera: the tilt games give it touch controls.

CoreS3 CoreS3 SE

AMOLED-1.75C Waveshare

1.75 in round AMOLED, 466 x 466. ESP32-S3, 32 MB flash.

Motion sensor, speaker. About 25 MB of the flash keeps your apps.

A round menu and round layouts. It has no SD card, so the games with a big data pack do not run on it.

Waveshare

AMOLED-1.8 Waveshare

1.8 in AMOLED, 368 x 448. ESP32-S3, 16 MB flash.

Motion sensor, speaker, microphone, SD card.

The apps draw their 320 x 240 layout 1.4 times bigger, so the pixels are softer than on a native layout.

Waveshare

SenseCAP Watcher Seeed Studio

1.45 in round, 412 x 412. ESP32-S3, 32 MB flash.

A wheel, speaker, microphone, camera.

Turn the wheel to choose, push to open, hold to go back. With no motion sensor, the tilt games read the wheel. The install replaces the Seeed firmware; the page can save a copy first.

Seeed Studio

Tab5 M5Stack

5 in, 1280 x 720. ESP32-P4, 16 MB flash.

Motion sensor, microphones, SD card, the M5Stack keyboard.

The apps draw a 360 x 640 frame, and the board shows it 2 x 2 on the 5 inch screen. The flash keeps a free slot for a boot menu and a second system.

M5Stack

Install it in about two minutes

The install page talks to the board through the USB port of your computer. It finds the board, checks each file, and writes it.

  1. Open this site in Chrome or Edge on a computer.
  2. Connect the board with a USB cable that carries data.
  3. Click Connect and choose the port of the board. The page finds the board and its version.
  4. Check the picture of the board, click Install, and wait until the board starts again.

An install erases the data on the board: its settings, its WiFi and its files. The SD card does not change. A board that already runs TFN OS can get an update, which keeps its apps and settings.

Open the install page

Questions

Is TFN OS free?

Yes. TFN OS and the apps of its store are free, and the source code is open under the MIT licence. Some parts that TFN OS uses have their own open licences: NOTICE.md in the source lists them.

What is in a release?

The system with STANDBY, STORE, FILES, WALKIE, TALKIE and GAMEPAD. The games and the tools come from the store: the STORE app of the board, or the app page of this site.

Which browsers work?

Chrome and Edge on Windows, macOS, Linux and ChromeOS. They have Web Serial, the part that talks to the USB port. Firefox, Safari and phones do not have it.

The page does not find my board.

Use a cable that carries data (some cables only charge). Close other programs that use the port, such as a serial monitor. If the board still does not answer, hold its BOOT key while you connect the cable, then click Connect again.

Can I go back to the firmware that came with the board?

Yes, if you keep a copy. Before an install, the page can save the whole flash of the board to a file. Keep that file private: it has the WiFi passwords that the board knew. To put it back, write it at address 0 with esptool.

What does the install page send to the board?

One text command, "ota", which asks a running TFN OS for its board kind and version. Then the firmware files of this site. The page checks the SHA-256 of each file before the write, and the board checks each block after it.

Does this site track me?

No. The site has no analytics, no cookies of its own and no third-party scripts. The fonts and the flasher library come from this site.