Skip to content

Planchette v0.2.0-beta.1

Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 13 Nov 22:11
· 3 commits to main since this release

What 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": true in table.json to 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 in table.json.
  • scripts/tuio-send.mjs, a stand-in tracker for working without a table.
  • npm test: unit tests for OSC decoding, TUIO frames, table.json and
    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.version and the SDK's hello now 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.