Repository navigation
Planchette v0.2.0-beta.1
Pre-releaseWhat changed
A beta of 0.2.0, for testing on a real table. Published as a pre-release.
Added
- Run interfaces on a real table. The desktop app listens for TUIO 1.1 from
a table's tracker (pucks and fingers) and feeds it to interfaces exactly as
the simulator does, so they need no changes. Off unless switched on in
Settings > Table input; a designer's machine never opens a socket. See
docs/TABLE.md. - Present mode for the table's own computer: fullscreen on the table's
display at one table pixel per screen pixel whatever the display scaling, no
authoring chrome, native touch ignored. Table > Enter Present Mode, or
"present": trueintable.jsonto boot into it. - A control puck that opens an interface picker on the table: put it down,
turn it, touch an interface to open it. - Table > Assign Pucks maps the tags printed on a table's pucks to the
marker numbers interfaces use, and Table > Calibrate lines the tracker up
with the screen. Both apply live. Stored per computer intable.json. scripts/tuio-send.mjs, a stand-in tracker for working without a table.npm test: unit tests for OSC decoding, TUIO frames,table.jsonand
workspace upgrades, gating CI on both runners.
Changed
- Workspaces are now kept up to date. Opening a workspace refreshes its
reference docs, SDK types and agent guidance when the app has newer ones. A
file you edited is kept, with the new version written beside it
(API.new.md); anything you deleted stays deleted; interfaces and examples
are never overwritten. A notice says what changed. Works for workspaces
created by 0.1.0 and 0.1.1. table.versionand the SDK'shellonow report the app's version. They said
0.1.0 in every release so far.
Installing
These builds are unsigned, so both systems object the first time. Once per
machine:
macOS — right-click the app and choose Open, then confirm. If it still
refuses, or it arrived as a zip through Slack:
xattr -cr "/Applications/Planchette.app"
Windows — SmartScreen shows "Windows protected your PC". Click More info,
then Run anyway.
Which file
| You have | Download |
|---|---|
| Apple Silicon Mac | the arm64.dmg |
| Intel Mac | the plain .dmg |
| Windows | setup.exe to install, or the portable .exe to just run it |
First run
Planchette creates a workspace at ~/Documents/Planchette (Windows:
Documents\Planchette) holding four example interfaces, the API reference, and
the design rules. Everything in the App menu comes from that folder.
Making your own, with an agent
File > New interface… scaffolds a folder with starter files. Then open that
folder in Claude Code, or whatever coding agent you use, and describe what you
want:
make a puck that scrubs through a video, with the timeline
under the puck and a filmstrip along it
You do not need to explain the table, the units, or the puck API. The workspace
already carries the SDK reference, the design rules, type declarations, and a
skill that fires when you mention pucks or a table, so an agent opened on that
folder starts with everything it needs.
Save a file and the app reloads it, keeping your pucks where they were.
GETTING-STARTED.md in the repository has the full walkthrough, and
DESIGN-RULES.md in your workspace has the handful of rules that decide whether
an interface works on a real table.