Learning Centre
Everything you need to set up Treadle and get to your first press.
Start here
- Install Treadle and get to your first pressDownload the Mac app, move it to Applications, open it past Gatekeeper, and start the first-run wizard.
- A button does nothing when I press itWhy a press can run but have no visible effect, and how Diagnostics points you at the fix.
- The iPad or iPhone can't find my MacWhat to check when the iPad or iPhone does not discover the Mac automatically, and how to enter the address by hand.
- Why Treadle asks for Accessibility, Screen Recording and AutomationThe three macOS permissions Treadle needs, what each one is for, and what breaks without it.
Get started
- Install Treadle and get to your first pressDownload the Mac app, move it to Applications, open it past Gatekeeper, and start the first-run wizard.
- Pair your iPad or iPhoneLink your iPad or iPhone to the Mac with a six-digit code, and revoke a device when you no longer want it.
- The iPad or iPhone can't find my MacWhat to check when the iPad or iPhone does not discover the Mac automatically, and how to enter the address by hand.
- Why Treadle asks for Accessibility, Screen Recording and AutomationThe three macOS permissions Treadle needs, what each one is for, and what breaks without it.
Build your panel
- Build your first deckSet up decks and buttons in the Mac app, choose each button's action, label and icon.
- Controls that take a value: toggles, levels and promptsSome controls carry a value you set — on or off, a number, or typed text — chosen by the control's Kind.
- Decks, controls, actions and packs — what the words meanPlain definitions for the handful of words Treadle uses, and how they fit together.
- Make a deck appear with an appBind a deck to an app so it offers itself when that app is frontmost on the Mac.
- Use a Shortcut as an actionPick one of your macOS Shortcuts as a control's action; Treadle runs it with the Shortcuts tool.
- Use an action packAdd a ready-made set of controls to a deck in one step from the Packs browser.
- Write your own commandUse the Custom action source to run a command on the Mac; the iPad or iPhone only ever gets a generated id.
Fix a problem
Features
- Dashboard tiles: read-only status on the panelTiles show information — meters, now-playing, battery, a timer, your next meeting, clipboard, CI and OBS — without being buttons.
- Hold and rules: a second action, and first-match logicGive a button a second action on hold, or a short rule list that picks one action from your Mac's current state.
- Integrations: your own GitHub and OBSRead-only GitHub (CI and PRs) and a fixed OBS control set, reached with your own credentials over your own network.
- Scenes: one button runs a list of stepsA scene runs an ordered list of actions with optional delays, and "Restore previous" undoes only the steps it can.
Account and licence
- Activate, deactivate and move to a new MacEnter your licence key, release it when you deactivate, and move your licence between Macs.
- Updates, and what "two years of updates" meansHow Treadle updates itself, what the two-year window covers, and why security updates are never withheld.
- What's free, what's paid, and what happens after the trialThe split between the free plan, the 14-day trial, and the one-time paid licence.
Ideas
Still stuck?
Run Diagnostics in the Mac app first — it names what is failing and how to fix it. If you are still stuck, see contact and support or email support@gettreadle.ca. Expect a reply within 1–3 days.