# Tutorials

**URL:** https://community.folivora.ai/c/tutorials/11.md

[Latest](https://community.folivora.ai/latest.md) · [Categories](https://community.folivora.ai/categories.md) · [Tags](https://community.folivora.ai/tags.md)

---

## [About the Tutorials category](https://community.folivora.ai/t/about-the-tutorials-category/110)

<div class="topic-metadata">

**Author:** [@Andreas\_Hegenberg](https://community.folivora.ai/u/Andreas_Hegenberg)\
**Replies:** 0\
**Last updated:** [May 17, 2018, 7:14am UTC](https://community.folivora.ai/t/about-the-tutorials-category/110 "2018-05-17T07:14:47Z")

</div>

Here you can share links to tutorials you like or post your own BetterTouchTool tutorials.

---

## [Bartender controversy, tutorial on how to manage menubar status items via BTT](https://community.folivora.ai/t/bartender-controversy-tutorial-on-how-to-manage-menubar-status-items-via-btt/37429)

<div class="topic-metadata">

**Author:** [@Andreas\_Hegenberg](https://community.folivora.ai/u/Andreas_Hegenberg)\
**Replies:** 57\
**Last updated:** [October 4, 2026, 3:19pm UTC](https://community.folivora.ai/t/bartender-controversy-tutorial-on-how-to-manage-menubar-status-items-via-btt/37429 "2026-10-04T15:19:58Z")

</div>

I'm posting this because I have received multiple related requests due to the current Bartender controversy (PSA: Bartender Mac App Under New Ownership, But Lack of Transparency Raises Concerns - MacRumors) …

---

## [Tutorial Using BTT AI Assistants for common tasks (h@llo.ai)](https://community.folivora.ai/t/tutorial-using-btt-ai-assistants-for-common-tasks-h-llo-ai/47869)

<div class="topic-metadata">

**Author:** [@Andreas\_Hegenberg](https://community.folivora.ai/u/Andreas_Hegenberg)\
**Replies:** 0\
**Last updated:** [September 25, 2026, 10:16am UTC](https://community.folivora.ai/t/tutorial-using-btt-ai-assistants-for-common-tasks-h-llo-ai/47869 "2026-09-25T10:16:42Z")

</div>

I feel with recent versions BTT's AI Assistants are pretty powerful and easy to access, so here a short tutorial on how to use them. Work in Progress Tutorial, created with BTT 6.859 I'll start with some generic Setup …

---

## [Reduce menu bar icon spacing to fit more icons](https://community.folivora.ai/t/reduce-menu-bar-icon-spacing-to-fit-more-icons/42523)

<div class="topic-metadata">

**Author:** [@Andreas\_Hegenberg](https://community.folivora.ai/u/Andreas_Hegenberg)\
**Replies:** 22\
**Last updated:** [September 19, 2026, 12:57am UTC](https://community.folivora.ai/t/reduce-menu-bar-icon-spacing-to-fit-more-icons/42523 "2026-09-19T00:57:40Z")

</div>

This is not really BetterTouchTool related, but I feel it is useful to many - especially if you have a Macbook with a Notch that constantly keeps hiding menu bar status items. You can show significantly more menu bar st…

---

## [Keyboard shortcuts: configure different functionality for long or short presses](https://community.folivora.ai/t/keyboard-shortcuts-configure-different-functionality-for-long-or-short-presses/26873)

<div class="topic-metadata">

**Author:** [@Andreas\_Hegenberg](https://community.folivora.ai/u/Andreas_Hegenberg)\
**Replies:** 23\
**Last updated:** [September 16, 2026, 10:17pm UTC](https://community.folivora.ai/t/keyboard-shortcuts-configure-different-functionality-for-long-or-short-presses/26873 "2026-09-16T22:17:59Z")

</div>

You need at least BetterTouchTool version 3.766 to do this To setup a shortcut that triggers one function on short press, and another on long press do it like this: For Long Press: For Short Press:

---

## [Low Level Key Remap](https://community.folivora.ai/t/low-level-key-remap/41043)

<div class="topic-metadata">

**Author:** [@Andreas\_Hegenberg](https://community.folivora.ai/u/Andreas_Hegenberg)\
**Replies:** 41\
**Last updated:** [September 15, 2026, 5:04am UTC](https://community.folivora.ai/t/low-level-key-remap/41043 "2026-09-15T05:04:17Z")

</div>

4.974 alpha adds a new feature for low level remapping of specific keyboard keys. This will really remap your keys, so the system will think that a specific key is now a different key. This is only for pretty specific s…

---

## [Rewind by 15 seconds or skip by 15 seconds the audio transcript within the Notes App](https://community.folivora.ai/t/rewind-by-15-seconds-or-skip-by-15-seconds-the-audio-transcript-within-the-notes-app/47136)

<div class="topic-metadata">

**Author:** [@Vladormir](https://community.folivora.ai/u/Vladormir)\
**Replies:** 1\
**Last updated:** [May 31, 2026, 5:36pm UTC](https://community.folivora.ai/t/rewind-by-15-seconds-or-skip-by-15-seconds-the-audio-transcript-within-the-notes-app/47136 "2026-05-31T17:36:41Z")

</div>

Hi! After tinkering with AppleScripts (and some insight from ChatGPT to properly target buttons), these are 2 scripts : One for +15 seconds (that I'll bind to F10) One for -15 seconds (that I'll bind to F8) For +15 s…

---

## [\[Tip\] Fast User Switching on macOS Sonoma/Sequoia using AppleScript (The "Tab-Space" Method)](https://community.folivora.ai/t/tip-fast-user-switching-on-macos-sonoma-sequoia-using-applescript-the-tab-space-method/47015)

<div class="topic-metadata">

**Author:** [@mira](https://community.folivora.ai/u/mira)\
**Replies:** 0\
**Last updated:** [May 12, 2026, 10:07pm UTC](https://community.folivora.ai/t/tip-fast-user-switching-on-macos-sonoma-sequoia-using-applescript-the-tab-space-method/47015 "2026-05-12T22:07:58Z")

</div>

Hi everyone, Since Apple removed the sac\_switchuser function and the old CGSession binary no longer works on recent macOS versions (Sonoma/Sequoia), it has become quite difficult to trigger a specific user switch via a …

---

## [Configuable Custom Dock Icons](https://community.folivora.ai/t/configuable-custom-dock-icons/44349)

<div class="topic-metadata">

**Author:** [@Andreas\_Hegenberg](https://community.folivora.ai/u/Andreas_Hegenberg)\
**Replies:** 7\
**Last updated:** [April 29, 2026, 11:17am UTC](https://community.folivora.ai/t/configuable-custom-dock-icons/44349 "2026-04-29T11:17:06Z")

</div>

Took a little break from working on the upcoming AI features and implemented support for custom dock icons. BTT 5.518 allows currently up to 7 customizable Dock icons. Here is how they work: Limitations: Currently …

---

## [Unpin Button For "Pinned / Floating On Top" Windows](https://community.folivora.ai/t/unpin-button-for-pinned-floating-on-top-windows/40435)

<div class="topic-metadata">

**Author:** [@Andreas\_Hegenberg](https://community.folivora.ai/u/Andreas_Hegenberg)\
**Replies:** 10\
**Last updated:** [March 23, 2026, 7:48am UTC](https://community.folivora.ai/t/unpin-button-for-pinned-floating-on-top-windows/40435 "2026-03-23T07:48:53Z")

</div>

In v4.885 I improved the "Toggle Pin/Unpin Focused Window To Float On Top" actions. There is now a condition "active\_window\_is\_pinned" that can be used in Conditional Activation Groups that allows to add a unpin button …

---

## [User Cleanshot OCR with linebreak](https://community.folivora.ai/t/user-cleanshot-ocr-with-linebreak/46436)

<div class="topic-metadata">

**Author:** [@Anurag\_Kashyap](https://community.folivora.ai/u/Anurag_Kashyap)\
**Replies:** 0\
**Last updated:** [March 10, 2026, 4:00pm UTC](https://community.folivora.ai/t/user-cleanshot-ocr-with-linebreak/46436 "2026-03-10T16:00:56Z")

</div>

Using Cleanshot url scheme and apple script to trigger cleanshot OCR with linebreak.bttpreset (7.1 KB)

---

## [Delete all files excluding folder](https://community.folivora.ai/t/delete-all-files-excluding-folder/46435)

<div class="topic-metadata">

**Author:** [@Anurag\_Kashyap](https://community.folivora.ai/u/Anurag_Kashyap)\
**Replies:** 0\
**Last updated:** [March 10, 2026, 3:57pm UTC](https://community.folivora.ai/t/delete-all-files-excluding-folder/46435 "2026-03-10T15:57:41Z")

</div>

Very beginner and simple but here it is! clear files except folder.bttpreset (11.5 KB)

---

## [Make floating menus work with your Wacom pen or Express buttons](https://community.folivora.ai/t/make-floating-menus-work-with-your-wacom-pen-or-express-buttons/46389)

<div class="topic-metadata">

**Author:** [@Jens\_Claessens](https://community.folivora.ai/u/Jens_Claessens)\
**Replies:** 1\
**Last updated:** [March 2, 2026, 11:49pm UTC](https://community.folivora.ai/t/make-floating-menus-work-with-your-wacom-pen-or-express-buttons/46389 "2026-03-02T23:49:27Z")

</div>

I found a simple way to add floating menus to wacom, as wacoms own radial menus lack functionality. It uses the wacoms ability to open apps from any button. In BTT we’ll go to out trigger that opens the floating menu…

---

## [A clock widget that never disappears.](https://community.folivora.ai/t/a-clock-widget-that-never-disappears/46370)

<div class="topic-metadata">

**Author:** [@Hafiyyan\_Naufal](https://community.folivora.ai/u/Hafiyyan_Naufal)\
**Replies:** 0\
**Last updated:** [February 26, 2026, 9:11am UTC](https://community.folivora.ai/t/a-clock-widget-that-never-disappears/46370 "2026-02-26T09:11:33Z")

</div>

Hi everyone, I want to ask if there’s a way to show a nice clock that’s always visible wherever I am. Floating, movable, and medium-sized. I need it to keep track of time while I work. I’m using a 4K monitor, which makes…

---

## [Touches du pavé numérique.](https://community.folivora.ai/t/touches-du-pave-numerique/46316)

<div class="topic-metadata">

**Author:** [@Vladimok](https://community.folivora.ai/u/Vladimok)\
**Replies:** 0\
**Last updated:** [February 18, 2026, 2:00pm UTC](https://community.folivora.ai/t/touches-du-pave-numerique/46316 "2026-02-18T14:00:09Z")

</div>

Bonjour, Je sherche le moyen de simuler les touches de pavé numérique. Avez-vous une idée ? Merci

---

## [Tutorial: Circular Floating Menu that can be shown by long right-click or gesture](https://community.folivora.ai/t/tutorial-circular-floating-menu-that-can-be-shown-by-long-right-click-or-gesture/39847)

<div class="topic-metadata">

**Author:** [@Andreas\_Hegenberg](https://community.folivora.ai/u/Andreas_Hegenberg)\
**Replies:** 68\
**Last updated:** [February 9, 2026, 4:10am UTC](https://community.folivora.ai/t/tutorial-circular-floating-menu-that-can-be-shown-by-long-right-click-or-gesture/39847 "2026-02-09T04:10:28Z")

</div>

I'm trying to create small tutorials for various new features of BetterTouchTool. This tutorial covers circular Floating Menus, it requires BetterTouchTool v4.790! 1.) Create and configure new Floating Menu 2.) Define…

---

## [Control Macbook Using PS5 Controller](https://community.folivora.ai/t/control-macbook-using-ps5-controller/45868)

<div class="topic-metadata">

**Author:** [@61ages.lasso](https://community.folivora.ai/u/61ages.lasso)\
**Replies:** 2\
**Last updated:** [January 10, 2026, 7:09pm UTC](https://community.folivora.ai/t/control-macbook-using-ps5-controller/45868 "2026-01-10T19:09:49Z")

</div>

Tags: PS5, controler TL;DR: I turned my PS5 controller into a macOS productivity remote with a "kill switch" to toggle between gaming and work modes. Mandatory to work: | Software Purpose Install Karabiner-Ele…

---

## [Can BTT do that? Please GUIDE 🙏](https://community.folivora.ai/t/can-btt-do-that-please-guide/43267)

<div class="topic-metadata">

**Author:** [@amandaswtz](https://community.folivora.ai/u/amandaswtz)\
**Replies:** 12\
**Last updated:** [December 28, 2025, 1:59am UTC](https://community.folivora.ai/t/can-btt-do-that-please-guide/43267 "2025-12-28T01:59:19Z")

</div>

I’m currently using BetterTouchTool to map key sequences to Arc browser tab shortcuts, like qq to Cmd+1 etc., so I can jump to frequently used tabs more easily. I am using qq to trigger applescript tell application "Sy…

---

## [Disable horizontal scrolling while touching magic mouse 2](https://community.folivora.ai/t/disable-horizontal-scrolling-while-touching-magic-mouse-2/21056)

<div class="topic-metadata">

**Author:** [@Prapor\_UA](https://community.folivora.ai/u/Prapor_UA)\
**Replies:** 6\
**Last updated:** [November 29, 2025, 11:19am UTC](https://community.folivora.ai/t/disable-horizontal-scrolling-while-touching-magic-mouse-2/21056 "2025-11-29T11:19:33Z")

</div>

Hi Guys. I'm using Magic Mouse 2 and i found a problem that it scrolls while i'm clicking. I found a code for terminal to fix this and now i'm looking for another comand, While i gently touching my mouse, it sometimes s…

---

## [Using "Delete" and "Return" in Finder to Go Back and Forward](https://community.folivora.ai/t/using-delete-and-return-in-finder-to-go-back-and-forward/31807)

<div class="topic-metadata">

**Author:** [@sagar1996](https://community.folivora.ai/u/sagar1996)\
**Replies:** 17\
**Last updated:** [November 18, 2025, 1:12am UTC](https://community.folivora.ai/t/using-delete-and-return-in-finder-to-go-back-and-forward/31807 "2025-11-18T01:12:45Z")

</div>

For a while, I have been trying to use the "Delete" button to go 1 folder back in Finder and "Return" button to open the folder/file. This has been a feature of Windows File Explorer forever and wanted to replicate this …

---

## [Tahoe: Launchpad replacement (Use Dock instead of Launchpad)](https://community.folivora.ai/t/tahoe-launchpad-replacement-use-dock-instead-of-launchpad/45117)

<div class="topic-metadata">

**Author:** [@Andreas\_Hegenberg](https://community.folivora.ai/u/Andreas_Hegenberg)\
**Replies:** 0\
**Last updated:** [September 16, 2025, 9:40am UTC](https://community.folivora.ai/t/tahoe-launchpad-replacement-use-dock-instead-of-launchpad/45117 "2025-09-16T09:40:23Z")

</div>

I have had a few recent requests about whether BTT can re-enable launchpad (which is no longer available on Tahoe). While you could probably replicate it with floating menus to some degree, I want to share how I (and ma…

---

## [Create A Custom Hyper Key](https://community.folivora.ai/t/create-a-custom-hyper-key/42495)

<div class="topic-metadata">

**Author:** [@Andreas\_Hegenberg](https://community.folivora.ai/u/Andreas_Hegenberg)\
**Replies:** 15\
**Last updated:** [September 10, 2025, 5:41pm UTC](https://community.folivora.ai/t/create-a-custom-hyper-key/42495 "2025-09-10T17:41:39Z")

</div>

Note: If you just need a cassic Hyper Key (i.E. press Caps Lock to press ctrl + opt + cmd + shift (optional)) follow the standard instructions here: Defining a Hyper Key · GitBook Custom Hyper Key Tutorial In v5.221 I h…

---

## [Mouse Clicks: Configure different functionality for long or short presses](https://community.folivora.ai/t/mouse-clicks-configure-different-functionality-for-long-or-short-presses/29431)

<div class="topic-metadata">

**Author:** [@Andreas\_Hegenberg](https://community.folivora.ai/u/Andreas_Hegenberg)\
**Replies:** 22\
**Last updated:** [September 9, 2025, 11:56am UTC](https://community.folivora.ai/t/mouse-clicks-configure-different-functionality-for-long-or-short-presses/29431 "2025-09-09T11:56:47Z")

</div>

BetterTouchTool 3.960 added support for configuring long press actions for any mouse button. Here is a small tutorial on how to set this up: Configuring the long press 1.) Go to the "Normal Mouse" section in BTT. (Eve…

---

## [returnToBTT() 's resulting variable name in BTT macro should be documented more clearly](https://community.folivora.ai/t/returntobtt-s-resulting-variable-name-in-btt-macro-should-be-documented-more-clearly/44844)

<div class="topic-metadata">

**Author:** [@sm1ng](https://community.folivora.ai/u/sm1ng)\
**Replies:** 1\
**Last updated:** [August 26, 2025, 8:21am UTC](https://community.folivora.ai/t/returntobtt-s-resulting-variable-name-in-btt-macro-should-be-documented-more-clearly/44844 "2025-08-26T08:21:03Z")

</div>

Hi there, I'm a reasonably experienced BTT user and yet I have to dig for well over half an hour before I found a page that mentioned that the results of the execute JavaScript action is accessible in BTT scripts as {res…

---

## [How Do I do this, please help?](https://community.folivora.ai/t/how-do-i-do-this-please-help/43035)

<div class="topic-metadata">

**Author:** [@amandaswtz](https://community.folivora.ai/u/amandaswtz)\
**Replies:** 12\
**Last updated:** [April 9, 2025, 3:23pm UTC](https://community.folivora.ai/t/how-do-i-do-this-please-help/43035 "2025-04-09T15:23:38Z")

</div>

I use an app that has some options, I want to change it when using BTT I want to automate this process, my navigation bar is hidden, and reveals on hover. Next thing is exporting in keynote, each time I have to do …

---

## [Tutorial / New Feature: Text Selection Did Change Trigger](https://community.folivora.ai/t/tutorial-new-feature-text-selection-did-change-trigger/41773)

<div class="topic-metadata">

**Author:** [@Andreas\_Hegenberg](https://community.folivora.ai/u/Andreas_Hegenberg)\
**Replies:** 217\
**Last updated:** [August 11, 2025, 11:05am UTC](https://community.folivora.ai/t/tutorial-new-feature-text-selection-did-change-trigger/41773 "2025-08-11T11:05:42Z")

</div>

Requires BTT 5.135 Documentation is available here: https://docs.folivora.ai/docs/1009\_text\_selection\_did\_change.html I have never used apps like Popclip in the past, however I'm currently in a situation where I ha…

---

## [Translate anything displayed on the screen.](https://community.folivora.ai/t/translate-anything-displayed-on-the-screen/44563)

<div class="topic-metadata">

**Author:** [@Aurel\_Buche](https://community.folivora.ai/u/Aurel_Buche)\
**Replies:** 0\
**Last updated:** [July 29, 2025, 12:25pm UTC](https://community.folivora.ai/t/translate-anything-displayed-on-the-screen/44563 "2025-07-29T12:25:29Z")

</div>

Translate On-The-Fly Hi All, I am a French guy living in Germany and I have to deal very often with complicated translations. I don't like Safari's built-in translation tool for different reasons: It messes with the …

---

## [What can Keyboard Maestro do that BTT cannot, or "Why do I need KM for if I have BTT?"](https://community.folivora.ai/t/what-can-keyboard-maestro-do-that-btt-cannot-or-why-do-i-need-km-for-if-i-have-btt/44487)

<div class="topic-metadata">

**Author:** [@andyjacobs](https://community.folivora.ai/u/andyjacobs)\
**Replies:** 1\
**Last updated:** [July 26, 2025, 4:39pm UTC](https://community.folivora.ai/t/what-can-keyboard-maestro-do-that-btt-cannot-or-why-do-i-need-km-for-if-i-have-btt/44487 "2025-07-26T16:39:06Z")

</div>

What can Keyboard Maestro do that BTT cannot, or "Why do I need KM for if I have BTT?"

---

## [Experiment: Create Floating Menus With ChatGPT](https://community.folivora.ai/t/experiment-create-floating-menus-with-chatgpt/43746)

<div class="topic-metadata">

**Author:** [@Andreas\_Hegenberg](https://community.folivora.ai/u/Andreas_Hegenberg)\
**Replies:** 16\
**Last updated:** [May 25, 2025, 7:14am UTC](https://community.folivora.ai/t/experiment-create-floating-menus-with-chatgpt/43746 "2025-05-25T07:14:33Z")

</div>

So this is very experimental. I just gave ChatGPT some basic definitions on how to create floating menus and it seems to work pretty well: https://chatgpt.com/g/g-682f2d1fe228819189a378ff41eba002-bettertouchtool-floatin…

---

## [how to create a floating menu that accepts dropped items](https://community.folivora.ai/t/how-to-create-a-floating-menu-that-accepts-dropped-items/43489)

<div class="topic-metadata">

**Author:** [@ctf0](https://community.folivora.ai/u/ctf0)\
**Replies:** 13\
**Last updated:** [May 22, 2025, 8:49pm UTC](https://community.folivora.ai/t/how-to-create-a-floating-menu-that-accepts-dropped-items/43489 "2025-05-22T20:49:48Z")

</div>

am trying to create a floating menu window/box that accepts a dropped item (ex. a link), then run a script with that item. i tried with the notch example but i dont know what am doing exactly and how to get the drop to …

[Next page](https://community.folivora.ai/c/tutorials/11.md?page=1)
