Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Welcome to Rondelek

Hello, and welcome. Rondelek TWST-1 is a little arcade of sounds for kids. A child records a funny noise onto a big colourful key, taps it, and hears it come right back. Then they switch to a game and steer it with nothing but their voice: say “aaa” and the hero jumps. It’s a toy first, and a sneaky bit of practice with sounds and vowels along the way.

The sound board: a navy arcade cabinet with a neon dot-matrix screen over a 4×3 grid of rainbow pixel keys   Vowel Runner: a little blue hero runs by a sea of glass bricks, in front of a thick jungle under tall snowy mountains, past a fallen tree; white stone tablets with carved vowels mark the obstacles, e over the fallen tree, i on a brick wall and a on a stalk of golden bamboo ahead, while the big golden sun shows the score

One install serves the whole family. Every child gets their own card, picture and recordings, and everything stays in plain folders on your computer. No accounts, no internet, no ads.

Two ways into this book

If you’re a parent or a grown-up helping a child play, start with Playing with Rondelek. It walks you from downloading the app to your child’s first game, with one important stop on the way: the voice calibration. It only takes a minute or two, and it’s what lets the games understand your child.

If you’d like to see how it’s made, head to Under the hood. It starts with building the app yourself, then shows you around the code: how sound flows from the microphone to the speakers, how the screens are drawn, how the app recognises vowels, and how the games are put together.

Under the hood, at a glance

  • Language: Rust (edition 2024), in a workspace of three crates: core (shared logic, no GUI), app (the sound board and menus) and game (the voice games, which run as a separate process).
  • App GUI: egui / eframe, immediate-mode.
  • Games: raylib, in its own window and process.
  • Audio: cpal for recording and playback, hound for WAV files, rustfft for the dancing spectrum, and spectrograms for the MFCC vowel detector.
  • Camera: nokhwa, for taking a picture for a child’s card.
  • Storage: plain JSON files (serde) in the usual OS data and config folders. No database, no network.
ChapterWhat you’ll find there
Building from sourceGetting the code running on Windows, macOS or Linux, the everyday commands, and handy test switches.
ArchitectureThe App struct, the per-frame loop, the screen state machine, threading.
Audio routingThe essential one. Recording, playback, the visualizer taps, device management.
The visualizerThe pluggable Visualizer trait, the spectrum pipeline, vowel detection and calibration.
UI, layout & renderingThe fluid layout, the renderer, theming, fonts, translations.
Data model & storageWhat lives on disk, and how it’s laid out.
Voice gamesThe game process, Vowel Runner’s scene, the art, the shaders, and adding a game.
LibrariesEvery dependency, and why it’s here.

Keeping this book current: these pages are treated as part of the code. Any change to how the app behaves or is wired updates the matching page in the same commit. Contributing to these docs has the details.