# EP Sample Tool — offline Mac launcher

This folder contains a local snapshot of Teenage Engineering's EP Sample Tool for
personal offline use with an EP-133. The browser talks directly to the connected
device over USB MIDI SysEx; sample data is not sent through an internet service.

## Start it

Double-click **EP Sample Tool Offline.app**. The small wrapper stays open so the
local server remains available; quit it from the Dock when you are finished.

For a visible launcher log, double-click **Launch EP Sample Tool.command**, or run:

```sh
npm start
```

Keep the launcher window open while using the tool. Chrome will ask for permission
to use MIDI system-exclusive messages the first time. Connect and power on the
EP-133 before approving that prompt.

The launcher binds only to `127.0.0.1` on a random port. It requires Google Chrome,
Chromium, or Microsoft Edge because Safari/WKWebView does not currently expose the
Web MIDI API used by the EP tool.

## Included offline

- The current EP Sample Tool JavaScript and CSS
- Audio conversion/tagging WebAssembly modules
- The EP-133 factory-content pack used by factory restore
- The app font and images

The snapshot was taken from
`https://teenage.engineering/apps/ep-sample-tool/` on 2026-07-12. It is not an
official Teenage Engineering desktop application and will not update itself.

Run `npm run verify` to check that all expected local assets are present.