Choano
Swim, eat and grow in a microscopic world. Eat equal or smaller amoebas, avoid larger ones, and stay inside the petri dish. Spawn warnings give you time to move; cumulative growth earns extra lives. An illustrated title screen opens the game, with native in-app navigation.
Reaching full size unlocks Fish mode in the open sea. Fish of many kinds, seahorses, lobsters and starfish are food at your size or smaller and bite when bigger; seahorses are big, so grow before you hunt them. Avoid jellyfish, collect golden pearls, feast on sardine schools, and swim clear when tense music announces a shark. Now and then a gentle sea turtle swims by: it never bites and leaves a short trail of golden pearls.
Play in your browser · Downloads · Source
Six quiet event chimes replace the old beat and spawn noises. There is no loading message or browser footer; forming bubbles stay beneath the player.
Native and browser editions share the same Ziran game rules and Kryon widgets. The website's title screen links the latest release's APKs, AppImage and Windows installer. All artwork and audio are replacements made for Choano. Original Moeboid assets and binaries are excluded; see asset provenance.
Controls
Desktop and browser: hold arrow keys or WASD to swim. Enter after game over or R starts a fresh run. On touch screens hold and drag anywhere to swim that way; letting go glides smoothly to a stop, and a tap alone does nothing. Swipe steering is the default; choose the direction pad or turn sound off in the in-app Settings, also reachable from Pause. Profile pauses play and opens the shared Entity account UI; Back returns to the same run. Signing in is optional. Earned growth stages follow that account; the current run stays on this device and is not restored after closing the game.
The same title, pause, settings and movement-control flow runs in compatible game libraries. Back returns through the current screen before leaving the game.
Shop and guides
The title-screen Shop has three earned decorations and three optional Dew purchases: a pearl ornament (10 Dew), a flower (20 Dew), and a wizard hat (30 Dew). Tap an owned card to wear it. A locked Dew item opens its price confirmation; only a confirmed account receipt unlocks it, and the same account restores it on another device. Profile provides sign-in in the native and browser editions; compatible portable hosts supply the same account services. Local swimming and the earned decorations do not require a purchase.
A small fish guide introduces food, hazards, and golden pearls one speech bubble at a time. Tap the bubble to advance. Fish keep their original colors; creatures your size or smaller are food, while jellyfish and shark bodies are dangerous. Shark fins flash red on contact. The lives counter includes the current life, and a short recovery period prevents one overlap from consuming every life.
Build and local tests
Install Python 3.11 or newer with Pillow, Ziran, and the SDL2, Cairo, FreeType, Fontconfig, Pango, GTK and X11
development libraries. Emscripten is needed for the browser edition. Package
sources and the compiler are pinned in ziran.lock; local overrides belong
in ignored ziran.local.toml.
ziran fetch --locked
make test
make input-test
make all
./build/Choano-native
make web
python3 -m http.server --directory build/web
EMCC may point to Emscripten's emcc; otherwise the browser builder uses
~/emsdk/upstream/emscripten/emcc or emcc from PATH. make all produces
build/Choano-native and build/choano.zx. Window tests use only a fresh
private Xvfb display; browser tests use a disposable headless Chromium profile.
make input-test exercises the actual Frame and a portable game through the
current Apps host. If Ziran is installed through a launcher, set ZIRAN_ROOT
to its existing build tree (or ZIRAN_LIB to its build/libziran.a).
Movement reads Kryon’s owned frame snapshot on desktop, Windows, browser and
compatible portable hosts. Keyboard shortcuts and text keep their existing
event queues. Simulation advances at 60 fixed steps per second, independent of
rendering speed; a frame can catch up at most 100 ms after a stall. Short
frames preserve partial simulation time until the next step.
The portable source now requires a host with frame_snapshot.CaptureFrameInputHost;
Arcade 0.7.113 does not provide it. A new portable release must wait for a
compatible host.
Linux AppImage
make appimage rebuilds the native game and packs it with its libraries and
art into build/Choano.AppImage; --use-built-native on
scripts/desktop_release.py appimage packs the existing build instead. The
pinned linuxdeploy tools are downloaded once into ignored work/tools and
checked against their SHA-256. make appimage-test unpacks the image, checks
its assets and libraries, and plays it in both modes on a private Xvfb display
through APPIMAGE_EXTRACT_AND_RUN, without FUSE. Releases name it
choano-vVERSION-linux-x86_64.AppImage.
Windows installer
python3 scripts/desktop_release.py windows builds build/Choano-setup.exe.
The MinGW-w64 build uses the Linux edition's src/desktop.zi entry point,
Kryon's SDL2/Cairo renderer SDK, the AVIF decoder DLL and Ziran's audio sink.
The decoder builds with CMake, Meson, Ninja and NASM.
NSIS (makensis) packs the program, its libraries, Kryon's Liberation Sans
and every asset into a per-user installer with
no administrator rights, Start menu and desktop shortcuts, and an uninstall
entry in the player's own registry. Settings live in
%LOCALAPPDATA%\Choano and stay after uninstalling. The installer is not
Authenticode-signed. python3 tests/windows_release_test.py installs it
silently in a private Wine prefix under work/, plays it on a private Xvfb
display against the native build's title screens, saves its settings and
uninstalls it. Releases name it choano-vVERSION-windows-x86_64-setup.exe.
Android
make android builds the unsigned release APK on Kryon's Android host and
make android-gplay the Google Play edition's. They need JDK 21 and the
Android SDK's NDK 28.2.13676358, build-tools 36.0.0, android-36 and CMake
3.22.1, plus Meson and Ninja for the AVIF decoder. Gradle's project is
generated in ignored droid/ from the locked Kryon.
python3 scripts/android.py sign APK --output FILE signs with the
ignored backup/android-signing key and verifies the package, both ARM
architectures, the bundled art and the Choano certificate.
The Android workflow builds choano-vVERSION.apk, the same Google-free build
as choano-VERSION-fdroid.apk, and choano-vVERSION-gplay.apk, the only one
with a Google library (Play Billing). It checks both editions with Kryon's
google-free action and signs them with the CHOANO_ANDROID_KEYSTORE and
CHOANO_ANDROID_KEYSTORE_PASSWORD secrets.
Releases
VERSION and the newest numbered CHANGELOG.md entry name the release, 0.1.0
first; python3 scripts/release.py assets lists its five files: the normal,
F-Droid and Google Play APKs, the Linux AppImage and the Windows installer.
Nothing is submitted to a store.
Independent game package
apps.json and catalog.json declare Choano's stable identity
xyz.waozi.choano, portable entry and cover artwork. The portable edition uses
apps/node_app, the generic kryonlabs/game2d navigation/control modules,
and Entity's game_progress schema through bounded host
services. Hosts own account keys, record IDs, storage and synchronization.
Arcade is a consumer/catalog of this package and is not a Choano dependency.
This repository does not change Arcade's catalog or publish a signed node package.
Website delivery
The Choano GitHub Actions workflow tests the native and portable game, builds
the browser edition with the locked shared Entity provider, and exercises
swimming, Profile/Back, restart and reload in headless Chromium. Successful
master builds deploy to the Cloudflare Pages project choano and connect
choano.waozi.xyz. Repository secrets CLOUDFLARE_API_TOKEN and
CLOUDFLARE_ACCOUNT_ID configure deployment; credentials are never committed.
Earned amoeba growth uses Entity's shared GameProgressClient. Choano keeps
one versioned private document per public account (and one for the guest),
containing only earned growth and its pending marker. Saves acknowledge the
private filesystem flush before an upload or local acknowledgement. Existing
preferences and legacy records remain intact; a new account starts from its
own save, and no run position, lives, score or RNG is synced or resumed.
Remote earnings are adopted when the existing game UI is outside active play.
Portable hosts must explicitly grant the document read/write/status/readiness
and flush capabilities and bind their authorized node's private AppFiles
through AppPlatform.documents. The standalone browser binds its own private
files directly. Older Arcade hosts need their own adoption; this change does
not publish a catalog update or claim compatibility with Arcade 0.7.113.
Shared theme
src/choano.css is the single theme source. The game uses
Theme.Use(session, "src/choano.css"); embedded Entity Profile uses the same
scope and inherits its semantic colors. scripts/theme.py embeds the sheet
for native, Android, browser and portable builds; make test verifies it stays
in sync. Edit the CSS file, then run python3 scripts/theme.py.
