Kami is a paper-folding simulation built to be driven by a physical hinge, using folding device APIs when available.
Try it online at https://kami.maxwase.eu
Important
Posture API only works in a limited set of browsers! Check out the compatibility here.
Kami_.The.origami.simulator.mp4
- Interactive Folding: Fold paper using device posture (on supported devices), manual sliders, or on-screen controls.
- Customization: Choose from A4, Square, or a custom aspect ratio, and set independent front/back colors for a double-sided paper.
- Motion Controls:
- Rotate: Use on-screen buttons or Alt/Option + Drag vertically to rotate the paper.
- Fold: Trigger folds manually or let the physics engine handle it.
- Realistic Visuals:
- Wood and paper textures with graceful fallbacks if they fail to load.
- Dynamic, soft shadows that react to lifting and folding.
- Smooth animations for folding and rotation.
The game tries its best to auto-detect your device's folding posture and capabilities, but you can also manually set them using the "Show Options" button in the top-left.
- Invert fold direction -- By default, Kami assumes the accelerometer is on the right half of the screen. It tries to detect the direction you fold your device (left to right, top to bottom, etc). If it guesses wrong, set it manually here.
- Stability threshold -- This setting controls how sensitive posture detection is to small movements. A lower value means even small tilts count as a fold, while a higher value requires faster folds.
- X and Y axis -- The problem of the century persists: Where is the center of the device?
- Download the latest version for your Mac from the releases page.
- Unzip it
- Install like any other dmg, drag the app into applications.
- Run
xattr -dr com.apple.quarantine /Applications/kami-tauri.app. This is needed because I don't have an Apple account to sign the binary with.
If you don't trust the GitHub actions output, consider building the app yourself.
Get it on Google Play (badge at the top of this page), or download the signed kami-release.apk (or .aab) from the releases page.
- Node.js 18+ (Vite 8)
- pnpm 11+
- A modern browser to actually test folding. Note that the API is only available on localhost or HTTPS connections.
- Or stable Rust when building with
taurifor MacOS.
pnpm install
pnpm run dev # start Vite dev server
pnpm run build # type-check + production build to dist/To run it on MacOS do the following:
pnpm install
pnpm run tauri dev # start Vite dev server
pnpm tauri build --bundles app # build an appI'm primarily a backend developer, so the code quality here is an ongoing journey. I want to rewrite this in Rust, WebAssembly to make it cross-platform and to add more complex folding puzzles.
- Foldy bird -- Flappy bird controlled with hinge flaps! It's surprising how 2 people can independently come up with the same idea! Lyra, however, published it first, so congrats!
- LidAngleSensor -- An amazing reversed-engineering of the MacBook's lid angle sensor, which inspired me to experiment with foldables!
If you have any thoughts or suggestions, please contact me via telegram or email :)