Ventilastation Development Kit

Ventilastation is an open source electromechanical console for circular games, built with a large fan, a bar of LEDs and MicroPython.

Start here

• Set up the desktop emulator — develop and test games on your computer.
• Make your first VS2 game — start with desktop setup, then build a game through seven chapters.
• API reference — current VS2, generated from code.
• SDK and hardware internals — runtime, emulators, firmware and protocols; see AGENTS.md for working rules.

Documentation sources and maintenance live in this repository. The original ventilastation.sprites API is obsolete for new development; its maintenance guide is separate from the VS2 path. Existing V1 games continue to run.

Repo layout

• games/<group>/<name>/ — one folder per game: code, images, sounds, menu.png, meta.json
• system/ — the launcher and other built-in apps, shared UI assets
• apps/micropython/ventilastation/ — the SDK runtime
• apps/retro-go — submodule: native apps (Voom/Doom, console emulators)
• emulator/ — the desktop emulator host; web/ — the browser emulator + IDE
• hardware/ — rotor firmware modules, schematics, the test workbench
• tools/, tests/ — generators and the test suite (python3 tests/run_tests.py)

Build your own Ventilastation

If you have some maker experience, there are also schematics and blueprints so you can build your own Ventilastation console — see hardware/ and docs/internals/building.md for flashing firmware.