API & Docs

Give your app
a sense of touch.

A collision. A dial. The tension before a shot. Turn the state of your app into feedback you can feel through a Mac trackpad.

Your app sends local HTTP commands.
FeelMyMac handles the haptics.

Read the API guide Get the API Tester

Available in FeelMyMac 1.2.0 and later. API access requires a purchased full license.

POST /v1/resonance

{
  "mode": "controlled",
  "intensity": 0.25,
  "pulseRateHz": 12,
  "sharpness": 0.3,
  "transitionMs": 60
}

Local by design

A small request.
A physical response.

Choose the API material in FeelMyMac, then connect to 127.0.0.1:59723. No API token, account flow or cloud round trip.

Check the service first. Its response tells your integration whether haptic output is available.

Follow the quickstart

Check the local service

curl http://127.0.0.1:59723/v1/status

Transport: HTTP + JSON on loopback
Client identity: One UUID per client instance
API protocol: v1
Material sound: Disabled in API mode

Use a native app, command-line client or Electron main process. Browser pages do not connect to the local haptic service.

Choose what the interaction feels like.

See every parameter

One impact

A button settling into place or a ball striking the cushion. Choose a crisp, natural or soft impulse and set its intensity.

POST /v1/impulses

Changing tension

Start a controlled resonance. Update intensity, cadence and sharpness as your app changes, with a transition between values.

POST /v1/resonance/update

Your interaction rules

Keep the sensation while the user holds still, pause it, resume it or stop. Your integration decides when the interaction ends.

POST /v1/resonance/pause

Cadence means impulses per second. Sharpness changes the character of the impulse; it does not set the actuator’s physical frequency.

A separate developer tool by BinaryBears

Feel it before
you integrate it.

The native API Tester connects to FeelMyMac on your Mac. Try impulses, change resonance parameters live and explore the billiards tension example.

It is a small, separate download. It is not bundled with FeelMyMac and does not replace the app or its license.

Download API Testerv0.2.1 · 2.2 MB

macOS 15.1+ · x86_64 + arm64. Requires FeelMyMac with API access enabled and a compatible haptic trackpad.

SHA-256 checksum

667ddb0b9f247d152da9eb72b69934ed50a45a035df9c24b7d8600c217f4e73f

Extract the ZIP, then double-click Feel My Mac API Tester.app. Download newer versions from this page; the tester has no automatic updater.

Tester setup and first connection

Everything you need to connect.

Integration guideFirst request, sessions, live updates and practical examples.Endpoint referenceRequest bodies, parameter limits, responses and errors.OpenAPI specificationDownload the v1 contract for your developer tools.

Experiment, then build together.

API access is unlocked by a purchased FeelMyMac license. There is no additional API usage fee for experimentation or nonprofit use.

To integrate the API into a game or program, contact business@thehighjack.it.

Discuss an integration