Skip to main content

JSON Action Plugins

Moved to Plugins Section

The full plugin documentation has been consolidated into a dedicated Plugins section. Please see:

  • JSON Action Plugins - complete reference for .bttjsonplugin files, form fields, placeholders, and examples
  • Plugin Overview - overview of all plugin types and development approaches

JSON Action Plugins (.bttjsonplugin) are a simple way to create reusable, configurable action plugins for BetterTouchTool - without writing any compiled code. You write a single JSON file containing metadata, form fields, and BTT actions with @@@placeholder@@@ values.

Quick Start​

  1. Right-click actions in BTT and choose "Export Selected Actions As JSON Action Plugin"
  2. Drop the .bttjsonplugin file into either ~/Library/Application Support/BetterTouchTool/Plugins/ or /Library/Application Support/BetterTouchTool/Plugins/
  3. In BTT, select your plugin from Custom Plugin Actions

See the JSON Action Plugins page in the Plugins section for the complete documentation.