New Drawer Widget — A drop target where you can collect and organize files. Supports grid, list, and horizontal layouts, an optional toolbar, configurable max file size, and automatic cleanup of old items.
New positioning mode: "Fixed Initial Position, Then Free Move" — Menus start at a configured position but can be freely dragged afterwards. The dragged position is remembered across restarts.
New "Disable Drag" option — Prevents a floating menu from being dragged, available in the right-click context menu.
Horizontal and vertical alignment options — Control how items are aligned within a floating menu layout (Left/Center/Right, Top/Center/Bottom). Available for horizontal, vertical, fill-row, and fill-column layout modes.
Cleaner preset exports — Floating menu JSON exports are now more compact, making presets smaller and easier to read.
WebView user agent now matches installed Safari version instead of a hardcoded older version.
Fixed custom HTML content failing to load external resources due to cross-origin restrictions.
Fixed items showing a yellow border on hover when no hover border color was configured.
Fixed floating webview URLs failing to load when the path did not reference a valid preset.
Fixed "click highlighted item and hide" closing the menu even when no item was hovered.
Continue work on AI Assistant / h@llo.ai (still beta!)
"Ask AI" button in preferences — a built-in configuration assistant that can create triggers, shortcuts, automations, and floating menus via natural language, with a setup wizard for first-time configuration
AI can now read the currently selected trigger, create standalone widget apps from floating menus, and compile Swift plugin widgets during a conversation
Redesigned context panel with tabs for Skills, Resolved config, full Prompt view, and LSP
Live "Thinking..." indicator and collapsible reasoning sections for extended thinking models
Skill cards show clickable example prompts
Added OpenRouter as a suggested API endpoint
Various UI/theme improvements for chat bubbles, code blocks, and tool call results
New Triggers
Audio Output/Input Device Changed — react when your default audio device switches (e.g., speakers to headphones), with optional regex filtering by device name
New Actions
Change/Set Audio Output & Input Device — switch devices by name
Toggle Mute Microphone and Set Audio Input Volume
Play Sound File
Floating Menu Drawer Widget
Slot Grid layout — fixed grid where items occupy specific cells, drag to rearrange
Remove items by dragging them out or pressing Backspace
Text snippets now open in your default text editor; added "Open With" context menu
Multiple file safety improvements — files outside the drawer's storage can no longer be accidentally deleted
Cmd+Delete no longer trashes the previewed file; safer drag-out behavior
Font size, text color, and grid columns now properly read from configuration
Fixed keyboard shortcuts (spacebar/Quick Look) only responding when the drawer is focused
Fixed internal drag-and-drop incorrectly triggering the external drop handler
Floating Menus
New window level: "Above Menu Bar"
Smooth Scrolling
Added option to only simulate trackpad scrolling for horizontal scrolls
Keyboard Shortcuts
Fixed left/right-specific modifier keys not matching correctly in some configurations
Added warning about "Key Down Only" keeping keys pressed until explicitly released
Action descriptions now show "(Only Key Down)" / "(Only Key Up)" labels
JSON Import/Export
Exported triggers now group actions by category with named keys, making JSON more readable
Fixed several import issues (parent relationships, app name resolution)
Scripting
New InputVolume built-in variable for reading/setting microphone volume
Fixed crash when passing null to the add-new-trigger scripting command
Other
Fixed a potential startup freeze related to USB Overdrive compatibility check
Preferences trigger list auto-refreshes after importing triggers via AI or scripting
Long Touch gestures (1–5 fingers) for trackpad and Magic Mouse — triggers after holding fingers stationary for a
configurable duration
Circle gestures (clockwise/counter-clockwise) for trackpad and Magic Mouse — draw circles with one finger to
trigger actions, with configurable circle count and shape tolerance
AI Assistant
Added Codex CLI and OpenCode CLI as AI backend options (no API key needed)
New Safari Automation skill for browser control and web scraping
Custom prompt blocks — define reusable text blocks, insert with {BLOCK:name} placeholders
AI config changes now take effect immediately without restarting the chat
Improved accuracy when creating/modifying triggers and actions
Added GPT-5.4 as default model
Smooth Scrolling
Replaced multiple advanced settings with a single Smoothness slider (0–1)
Fixed rubber banding, swipe navigation, and momentum interruption issues in Safari
Fixed sluggish response when reversing scroll direction
Floating Menus
New "Steal Keyboard Focus On Hover" option for menus with text input
All Swipe Gestures in BTT now have a separate action trigger category "Quick Flick". This allows to have different actions for slow swipes and for quick swipes.
Updated some UI parts:
Updated modern live touch view — a redesigned touch visualization window that shows real-time finger tracking with smooth trails, force indicators, and gesture logging. See exactly which gestures are being recognized and what actions they trigger as you use your trackpad or Magic Mouse.
New usage statistics window — track how often you use your triggers and actions across all device categories (trackpad, keyboard shortcuts, Stream Deck, floating menus, and more)
Daily trend chart — see your usage patterns over time with an interactive per-category chart
Most used triggers — quickly see which triggers and actions you rely on most
New Actions
Auto Scroll (Toggle) — a new predefined action that starts continuous auto-scrolling with a visual overlay showing scroll direction and speed. Move your cursor to control the scroll direction and intensity; click or press ESC to stop.
Smooth Scrolling
Horizontal-only trackpad simulation — new option to restrict trackpad scroll phase simulation to horizontal scrolls only, leaving vertical scrolling unaffected
AI Assistant
Model browser — browse and select from available AI models across major providers (OpenAI, Anthropic, Google, Mistral, DeepSeek, and more) directly within the AI setup, with live pricing and context window info
Hide Ask AI button — easily hide the Ask AI toolbar button from the setup wizard if you don't want it
Improved OpenCode CLI integration — better support for OpenCode's serve mode with HTTP/SSE streaming
MCP server improvements — enhanced Model Context Protocol server with support for both Streamable HTTP and SSE transports
Localization
Added and improved translations for Chinese, French, German, Japanese, Korean, and Spanish
Other
Gesture animations in preferences have been refactored for a more consistent look across all gesture types
New: Import Snippets from Files — You can now import text snippets and typed string triggers from external files. An "Import Snippets" button is now available in the Key Sequences section. Supported formats:
CSV — Simple trigger;replacement format
JSON — Array of snippet objects with trigger, content, and type
Espanso YAML — Import your existing Espanso snippet configurations, including support for variables (date, clipboard, shell commands, random choices, forms), case propagation, cursor positioning, and HTML output
AutoHotkey (.ahk) — Import hotstring definitions from AutoHotkey scripts, including multi-line replacements and continuation sections
The file picker auto-detects the format, and you can import multiple files at once
Mouse / Trackpad
Fixed an issue where mouse button long-press actions could incorrectly trigger when performing button-drag gestures
BetterTouchTool 6.275 (2026031706)
Key Sequences
Fixed key sequences with a "minimum hold time" requirement not triggering reliably when using modifier-only sequences (e.g. holding a modifier key for a set duration). Previously, these could fail to fire.
Window Management / Spaces
Fixed space switch without animation actions not working correctly when the macOS "Displays Have Separate Spaces" option is turned off in System Settings. BTT now correctly identifies spaces in both single-space and multi-display configurations.
BetterTouchTool 6.274 (2026031705)
Trackpad
Added new two-finger edge swipe gestures: you can now use two-finger swipes along the left, right, top, and bottom edges of your trackpad (up/down on side edges, left/right on top/bottom edges) as continuous triggers
Clipboard Manager
Fixed an issue where rapidly toggling the left or right sidebar could cause visual glitches or unexpected behavior
Configuration UI
When expanding a trigger group in the extra column navigation mode, the first item is now automatically selected and its configuration is shown, instead of displaying stale settings from a previously selected item
Switching trigger categories in extra column mode now properly collapses the navigation column to avoid layout issues
BetterTouchTool 6.273 (2026031704)
AI / OpenCode Integration
The OpenCode CLI integration now dynamically fetches the list of available models from your local OpenCode installation instead of showing a hardcoded list
Model selection now uses the correct provider/model format (e.g. openai/gpt-5.2) and passes the chosen model to OpenCode when sending requests
Updated default OpenCode model to Big Pickle (free tier)
BetterTouchTool 6.271 (2026031702)
Floating Menus
Added a search/filter field to the floating menu configuration panel — quickly find any setting by typing keywords instead of scrolling through categories
Expanding and collapsing configuration sections is now instant with no delay
Scroll position is now preserved when expanding or collapsing configuration sections
AI Chat
Improved vertical alignment of the text input field — placeholder text and typed text are now properly centered when on a single line
Sidebar
App names in the sidebar now wrap to two lines instead of being cut off, making longer names easier to read
Plugins
Fixed an issue where recompiling a previously approved Swift plugin at launch could trigger unnecessary file watcher events
BetterTouchTool 6.270
Floating Menus
Fixed drag and drop from the Drawer widget no longer showing a misleading "2 items" badge when dragging a single item
Fixed a crash that could occur when importing floating menu items with missing configuration data
Added new configuration options for positioning items within sub-menus (nested floating menus)
Hidden irrelevant positioning and visibility settings when configuring nested floating menu items, making the settings panel cleaner
Improved layout of dropdown menus in the configuration panel — labels now appear above the dropdown instead of beside it, giving more space for long option names
Templates
Added new "Drawer Widget" template — quick access to files, text snippets, and other draggable/copyable items from a screen corner
Added new "Circular App Switcher" template — a radial app switcher triggered by a three-finger trackpad swipe
Added new "Notch Menu" template — a menu that appears when hovering over the MacBook notch area
Bug Fixes
Fixed an issue where triggers in the trash could still be matched and executed under certain conditions
In the current alphas (e.g. 6.295) I have added a plugin manager that shows all loaded plugins. You can now also ask the BTT AI configuration assistant to create new action plugins and new trigger plugins. For example "Create a trigger plugin that recognizes when finder has been the active app for more than 2 seconds" or "Create a new action plugin that compresses the selected file in finder". All of these only work if the Xcode command line tools are installed.
Trigger plugins are listed in the "Automations, Named & Other Triggers" section in BTT. Action plugins are automatically listed in the action selector.
Example with an AI-generated trigger and action plugin:
You can now drag and drop conditions and groups to reorder them or move them between groups
Drag handles appear next to each condition row and group header for easy rearranging
Drop indicators show exactly where an item will be placed
Improved the visual alignment of the group connector lines
Improved reliability of the live "Currently True / Currently False" evaluation indicator
Variables View
Significantly improved performance of the built-in variables list — expensive system queries (mouse position, trackpad state, accessibility lookups, Dock item detection) are now only performed when the relevant variables are actually visible on screen
Only visible variable values are refreshed, reducing CPU usage when scrolling through large variable lists
Context Menu
The "Transform Plugin to Individual Actions" option is now always visible in the right-click menu (previously it was only shown for JSON plugin actions)
BetterTouchTool 6.303 (2026032404)
AI & Automation
Fixed a race condition where rapidly switching between documents could cause the AI assistant to miss detecting the current project context
Updated the default plugin identifier format for user-created Swift plugins to use com.bttuserplugin.swift.* instead of com.btt.swift.*, making it clearer which plugins are user-created vs. built-in
BetterTouchTool 6.302 (2026032403)
Icon Picker
The icon picker in the rule editor now opens a full icon picker popover when clicked, making it much easier to browse and select icons
Updated the hint text to "Click, paste or drag" to reflect the new click-to-browse functionality
Conditional Activation Groups
You can now create new Conditional Activation Groups from scratch without needing an existing app entry first
Actions
Added new "Transform Plugin to Individual Actions" option in the main menu
BetterTouchTool 6.301 (2026032402)
JSON Action Plugins
Added support for a new JSON Action Plugin system — simple JSON files that define reusable actions with configurable form fields, no compiled code required
Added a "Transform Plugin to Individual Actions" option in the right-click context menu, allowing you to expand a JSON plugin action into its individual component actions with all form values applied
Conditions
Added new condition variables for detecting which app is being hovered over in the Dock: hovered app name, hovered app path, and hovered app bundle identifier
AI Assistant
The built-in AI assistant now knows about JSON Action Plugins and can help you create and configure them
BetterTouchTool 6.300 (2026032401)
JSON Action Plugins
Added a new JSON Action Plugin system — create reusable action plugins using simple JSON files (.bttjsonplugin) without writing any compiled code
JSON plugins support configurable form fields (text fields, sliders, checkboxes, dropdowns, color pickers, etc.) with placeholder values that get substituted at runtime
Right-click any action(s) and choose "Export Selected Action(s) as JSON Action Plugin..." to package them into a shareable plugin file
JSON plugins appear alongside compiled plugins in the action selector under "Custom Plugin Actions"
Plugins are automatically detected and hot-reloaded when added to or removed from the Plugins folder
Double-clicking a .bttjsonplugin file will install it into BetterTouchTool
Hovered Dock Item Variables
Added three new variables for the currently hovered Dock item: app name, app path, and bundle identifier
These variables are available in the Variables Viewer, conditional activation rules, and the rule editor
Can be used in trigger conditions to create actions that respond to which app you're hovering over in the Dock
AI / Automation
The "Activate Hovered App in Dock" AI tool now correctly activates the app
Window Switcher
Improved window positioning so the switcher properly stays within screen bounds after content loads
Plugin Manager
Added support for browsing and managing JSON Action Plugins in the Plugin Manager
Added an optional plugin notarization feature for developers (sign, notarize, and staple plugins directly from the Plugin Manager)
BetterTouchTool 6.299 (2026032313)
Clipboard Manager
Hover previews in the clipboard manager now appear faster, making browsing through clipboard entries feel more responsive
BetterTouchTool 6.298 (2026032312)
Clipboard Manager
Added a new "Show preview on hover" option (experimental) — hover over clipboard entries to see a quick preview without clicking
New setting available in Clipboard Manager settings
Keyboard Shortcuts
Fixed an issue where modifier keys (e.g. left-CMD vs right-CMD) could lose their left/right distinction after executing a shortcut while holding a modifier key
Improved modifier key state restoration to prevent held modifiers from being incorrectly released after shortcut execution
Logitech Device Support
Fixed an issue where choosing to divert no specific keys on a Logitech device would not properly undivert all keys
The "Save" button in the Logitech key recorder is no longer disabled when no keys are recorded, allowing you to clear your key configuration
BetterTouchTool 6.297 (2026032310)
Floating Menus
Fixed maximum width handling for floating menus — menus now correctly respect the configured maximum width in all sizing modes, including content-sized and min/max layouts
Improved floating menu item wrapping behavior so items properly wrap to the next row when a maximum width is set
Configuration UI
Fixed an issue where certain configuration options (like SF Symbol settings) could incorrectly appear or disappear depending on unrelated tab selections
BetterTouchTool 6.296 (2026032309)
Keyboard Shortcuts
Fixed an issue where modifier keys (Shift, Command, Option, Control) could sometimes not be detected correctly after other apps posted synthetic keyboard events, which could cause keyboard shortcuts to stop working until the modifier key was pressed again
Fixed modifier key restoration when using left/right-specific modifier keys (e.g., Left Command vs Right Command) in shortcut sequences — previously, holding a modifier during a shortcut action could fail to be recognized afterward
BetterTouchTool 6.295 (2026032308)
AI Chat & Plugins
Improved AI response handling for CLI-based providers: When using Claude Code, Codex CLI, or OpenCode CLI as AI providers, BetterTouchTool now correctly retrieves a final text summary after the AI finishes executing tools, preventing cases where the chat would end without a visible response.
Better plugin compilation feedback: After compiling a Swift plugin, the AI now provides more specific guidance on where to find and use the plugin based on its type (action plugin, trigger plugin, Stream Deck widget, Touch Bar widget, or floating menu widget).
AI now knows your file system paths: The AI chat assistant automatically has access to your home directory and plugins folder path, making it easier to help with plugin compilation and file-related tasks without needing to ask.
Configuration UI
Fixed dropdown menus in plugin configuration forms: Dropdown/popup menus in the configuration panel now correctly handle plain text and dictionary-based options provided by Swift plugins, preventing potential crashes or empty menus.
BetterTouchTool 6.291 (2026032304)
Conditional Activation Rules
Improved the labels for mouse position condition fields in the rule editor to be clearer and more descriptive (e.g., "Mouse Dist X From Active Win Top Left" instead of the previous abbreviated labels)
BetterTouchTool 6.290 (2026032303)
Trigger Plugins
Added support for Trigger Plugins — custom plugins that can observe system events and fire BetterTouchTool triggers when conditions are met. Find them under Other Triggers > Trigger Plugins in the trigger selector.
Rule Editor
Fixed a crash that could occur when parsing certain condition rules with unexpected expression types
Fixed incorrect handling of true/false values in condition rules
Improved spacing and layout of the rule editor interface
AI Integration
Updated the AI assistant's knowledge to include the new Trigger Plugin system
BetterTouchTool 6.288 (2026032301)
Trigger Plugins
Added a new Trigger Plugin system — you can now create custom triggers that monitor system events and fire BetterTouchTool actions when conditions are met. Trigger plugins appear under Other Triggers > Trigger Plugins in the trigger selector.
Trigger plugins support custom configuration options, so plugin authors can expose user-facing settings directly in the BTT UI.
The AI assistant can now create and edit trigger plugins alongside existing plugin types (action plugins, floating menu widgets, Stream Deck plugins, and Touch Bar plugins).
Plugin Manager
Added a built-in source code editor for Swift plugins — click the pencil icon on any plugin with a .swift source file to view and edit its code directly in BTT.
You can now save, revert, and recompile plugins from the editor without leaving the Plugin Manager.
Added an "Ask AI To Modify Plugin" button in the editor to get AI assistance with changing existing plugin code.
The "Ask AI" button in the Plugin Manager now opens a dedicated Plugin Creator AI chat with the appropriate skills pre-loaded.
AI Assistant
New Plugin Creator skill — a specialized AI mode for building all five plugin types with guided assistance.
New Plugin Editor skill — a specialized AI mode for modifying existing plugins, with the source code automatically provided as context.
Fixed an issue where the AI spotlight window would dismiss when opening a file picker or save dialog in compact mode.
Fixed an issue in the AI setup wizard where selecting a model from the model browser could be overwritten by default settings.
Condition / Rule Editor
Fixed a crash that could occur when evaluating trigger conditions or activation group rules that reference undefined variables.
BetterTouchTool 6.287 (2026032001)
Condition & Rule Editor
New modern rule editor for trigger conditions and activation groups on macOS 13+ — provides a cleaner, more intuitive interface for building complex conditions
Added a predicate text editor toggle for advanced users who prefer editing conditions as text
The previous editor is still used on macOS 12 and earlier
Plugin Manager
Added a new Plugin Manager window, accessible from the toolbar and the View menu
Browse, filter, and manage all installed plugins (floating menu widgets, actions, Stream Deck, Touch Bar) in one place
Load new plugins or open the Plugins folder directly from the manager
AI Assistant
The AI assistant now has dedicated reference documentation for all four plugin types: Floating Menu Widgets, Actions, Stream Deck, and Touch Bar
Improved guidance when creating Swift plugins — the assistant will automatically retrieve the correct reference for the plugin type you're building
Magic Mouse
Magic Mouse single-finger tap click delay and double-tap threshold are now configurable via the hidden preferences BTTMMTapClickDelay and BTTMMDoubleTapThreshold (useful for users who find taps registering too quickly or too slowly)
I needed a better way to control my Apple TV's from macOS so this version adds an Apple TV Remote Control action and an action to trigger specific TV remote control actions (media buttons, launching apps, etc.) via any BTT Trigger.
Redesigned setup wizard with three clear paths: Cloud API, Local Model, or CLI Tool. Built-in support for LM Studio, Ollama, Jan, LocalAI, Apple Foundation Models, plus Claude Code CLI presets (Sonnet 4.5, Opus 4.6, Haiku 4.5). Includes a Fetch Models button, Test Connection, and no API key requirement for local servers.
MCP server lets external clients (Claude Code, Codex) use your configured BTT assistants — with one-click Codex plugin installer, a configurable port, and per-client sessions.
Skills system: skills can be Active, Optional, or Off. The AI can request optional skills mid-conversation via inline Allow/Decline cards. Skills are organized into searchable, categorized groups.
Assistants now support multiple model configurations and theme color presets (8 colors).
CLI backends (Claude/Codex/OpenCode) can now act as fallback models, and starting a new chat properly resets server-side conversation state.
New Triggers
Accelerometer triggers (Apple Silicon MacBooks) — axis thresholds, shake detection, and chassis tap/knock/hard-hit detection with adjustable sensitivity (1–100) and multi-tap counts. Includes a live sensor view.
Power Mode Changed trigger — fires when macOS energy mode switches between Automatic, Low Power, and High Power. Sets a power_mode variable.
Allow Parallel Execution option — run all matching duplicate triggers at once instead of showing the conflict menu.
Key Sequences
New Key Sequence Visualizer — a live debug window showing all active sequences as you type, with match quality sorting and explanations for why a sequence was ruled out.
The recorder no longer auto-enters recording mode when editing an existing sequence.
Drawing & Mouse Gestures
Direction-aware line gesture recognition — straight-line gestures are now matched by their actual drawn direction, dramatically improving accuracy for multi-direction line setups.
Smoother stroke rendering with curve interpolation and improved performance for long strokes.
New Actions
Quit Specific Application — quit any app by name, with optional Force Quit.
Send Keyboard Shortcut gained two options: include currently held modifiers and send at the lowest possible system level (helps with apps that ignore standard simulated events).
Send Shortcut to Specific App can now target the active/frontmost app or the app under the cursor.
Find Text on Screen now stores last_find_text_on_screen_result and last_find_text_on_screen_success variables, supports continuing on no-match, and lists all detected text when nothing matches.
Scrolling
New Disable / Reduce Scroll Acceleration modifier for linear 1:1 scrolling on mice, trackpads, and Magic Mouse.
Per-axis filtering for scroll modifiers (horizontal-only or vertical-only).
Multiple smooth-scrolling fixes: reverse-direction glitch, fast-scroll stutter, momentum/ease-out behavior, and false button+scroll triggers on momentum mice.
Apple TV Remote
Fully inline configuration of Apple TV actions (device, button, media command, app) without opening the full configurator.
Auto-connects to paired devices when the remote opens, with a Pair button and faster repeated commands via connection reuse.
Conditions & Variables
New condition variables: Audio Output Device, Audio Input Device, Keyboard Input Source, Connected Screen Count, Is Charging, and currently_active_modifier_keys (distinguishes left/right side).
Drag-and-drop reordering of conditions and groups in the rule editor.
New "Keyboard" category in the rule editor.
Significantly faster built-in variables list (expensive lookups only run for visible rows).
"Show Running Processes" button replaces the raw text dump.
Floating Menus
Content-fit menus no longer briefly appear at the wrong size before snapping into place.
Fixed item sizing in row/column layouts so minimum height is respected.
Other
New .bttjsonplugin format for distributing plugins as simple JSON files.
AI Model Browser now lists models from many more providers, with an API Type column.
Stream Deck preset import fixes for fixed row/column buttons.
Logitech receiver re-detection fix after sleep/reconnect.
Caps Lock Hyper Key no longer gets stuck after wake.
adds a "Manage Snap Areas" view that allows to manage your snap areas, this is a first step to modernize the snap area feature which has basically remained unchanged since 2012.
Completely re-worked form system. If everything goes by plan you won't notice this much (for now!) apart from some slightly changed UI in some places. However in the background thousands of lines of code have changed to make BetterTouchTool's configuration sidebar much more flexible and make it easier for BTT's integrated AI to configure actions and triggers.
This is a huge change and while I did a LOT of testing, I'm sure it is not yet perfect.
For now it looks mostly the same as the old form system, but with the new base I am now able to also refresh it visually step by step.
Today I started work on something I had planned for a quite a while: make Floating Menus the base for BetterTouchTool's Macro Pad support. The idea is to support a wide variety of Macro Pads like the Stream Deck, Loupedeck, Logitech MX Creative Console, Mirabox and their OEM hardware (the whole "Stream Dock" family (AJAZZ, Mirabox, plus ~96 rebrands - Soomfon, Mars Gaming, Redragon, TreasLin, Womier…) and have a common interface for them.
In a first step this works with Stream Deck devices, next week MX Creative Console and Mirabox support will be added. To try it create a floating menu and set it's availability to "Macro Pad":
There will also be support for all sort of hardware additions. E.g. some Macro Pads have knobs or extra displays.
For the individual floating menus you can choose to assign them to such hardware elements:
Continuing the work from yesterday, today I started working on a more visual editing experience for floating menus. As they will soon be the default base for all Macro Pads (Stream Deck etc.) this will be useful for many:
This version introduces extended Macro Pad support through the Floating Menu Architecture. In the next versions I'll keep adding support for different types of macro pads.
I have added two first example templates to the floating menu template picker:
All Stream Deck models supported by BetterTouchTool's Stream Deck integration can
also be used through the new Floating Menu Macro Pad support, including the Stream Deck + with its knobs and touch
strip.
AJAZZ, Mirabox and related pads
Many of these pads are the same hardware sold under different brand names, so a
device that isn't from AJAZZ or Mirabox may still work - look for your model in the
lists below.
Pads with 10 keys, 4 knobs and a touch strip
Device
Status
AJAZZ AKP05E
Tested
AJAZZ AKP05
Should work
AJAZZ AKP05E Pro
Should work
AJAZZ AKP05CN Pro
Should work
Mirabox N4
Should work
Mirabox N4E
Should work
Mirabox N4 Pro
Should work
Mirabox N4 Pro E
Should work
VSDInside N4 Pro
Should work
Mars Gaming MSD-Pro
Should work
Soomfon CN003
Should work
Streonor S10 Pro
Should work
Redragon SS552
Should work
Pads with 6 keys, 3 buttons and 3 knobs
Device
Status
AJAZZ AKP03
Should work
AJAZZ AKP03E
Should work
AJAZZ AKP03R
Should work
AJAZZ AKP03E (rev. 2)
Should work
AJAZZ AKP03R (rev. 2)
Should work
Mirabox N3
Should work
Mirabox N3EN
Should work
Mirabox N3CN3
Should work
Soomfon SE
Should work
TreasLin N3
Should work
Redragon SS551
Should work
Mars Gaming MSD TWO
Should work
Pads with 15 keys and 3 buttons
Device
Status
VSD Inside M18
Should work
Mirabox M18
Should work
Mirabox M18EN
Should work
Not yet supported
AJAZZ AKP153 / AKP153E / AKP153R and Mirabox HSV293S - these are recognised
but not finished. Keys are likely to appear in the wrong order or the wrong way
round. Please don't rely on them yet.
Ulanzi D200 / D200H - a different kind of device that needs separate support.
What "Should work" means
Only the AJAZZ AKP05E has been tested on real hardware so far. The other pads use
the same designs and are expected to work, but they haven't been confirmed yet - if
you own one, feedback is very welcome.
My pad isn't listed or isn't detected
If your pad looks like one of the devices above but isn't picked up, it may be the
same hardware with a different identifier. To report it:
Open System Information (hold ⌥, click the apple icon in the menu bar and choose → System Information).
Select USB in the sidebar and find your pad in the list.
Note its Vendor ID and Product ID (for example 0x0300 and 0x3004),
along with the exact product name.
Send those along with the brand and model, and support can usually be added.
the most significant change I'm currently working on is is "trigger aware actions". It is still a work in progress but will be powerful soon. This means if you have a trigger that produces values while being used, these values can be used in various actions. One example would be knob items in floating menus that can produce values (e.g. 0-1) or continuous mouse drags that can map to a range of values (e.g. 1-100) but also things like text fields in Floating Menus, continuous swipe gestures etc.
This has always been a pain point and so far always required scripting to get right, starting with this version stuff like this can be configured in the UI.
If an action allows binding values to trigger changes it will show this link icon:
