There is a example action extension included in this project (BTTDisplayNotificationActionPlugin), it shows the basic concepts and can be used as a starting point.

When using Swift to develop the plugins, make sure to set the principal class to the fully qualified name ($(PRODUCT_MODULE_NAME).PluginPrincipalClass).

the principal class in the ist must be set to the main class that conforms to the BTTActionPluginInterface protocol.

it must conform to the BTTActionPluginInterface protocol ( ).

its ist must contain these three keys: BTTPluginName, BTTPluginIdentifier, BTTPluginIcon, and BTTPluginType which must be set to 'Action'.

its wrapper extension must be '.bttactionplugin'.

It's easy to create such an action extension: They allow you to extend the list of available predefined ations with your own custom ones.

Starting with BTT 3.226 action plugins are supported. Please see the example plugins for details! Action Plugin Development When using Swift to develop the plugins, make sure to set the principal class to the fully qualified name (PluginName.PluginPrincipalClass).the principal class in the ist must be set to the main class that conforms to the BTTTouchBarPluginInterface protocol.it must conform to the BTTTouchBarPluginInterface protocol ( ).its ist must contain these three keys: BTTPluginName, BTTPluginIdentifier, BTTPluginIcon.its wrapper extension must be '.btttouchbarplugin'.Touch Bar Plugin RequirementsĪ BetterTouchTool Touch Bar plugin must fulfil these requirements: This repository contains basic example plugins for all three of these types. returning a custom NSViewController instance with a custom view attached to it.returning a custom NSButton instance that you can style and modify.

return a string which will be rendered using a BTT Touch Bar button that is fully customizable using the standard BTT mechanisms.Touch Bar PluginsĬurrently there are three types of Touch Bar plugins: The CPU Usage example in this repo uses the first option and just returns a simple string, which is then rendered in BTT. return an array of ready rendered nsimages.

return an array of dictionaries that describe what shall be rendered.return an array of attributed strings which will be rendered.return an array of strings which will be rendered using the appearance settings configured by the user in BetterTouchTool.Plugins are installed at this location: /Library/Application Support/BetterTouchTool/Plugins Stream Deck PluginsĬurrently there are three types of Stream Deck plugins: Starting with version 3.818 BetterTouchTool supports Touch Bar, Stream Deck and Action plugins. This repository will contain examples on how to create BetterTouchTool plugins.

Better touch tool ipad