New BetterTouchTool Documentation

(last updated: 24.05.2010)

  1. System Requirements
  2. First Steps
  3. The Main Window
  4. Adding A New Gesture
  5. How to use keyboard shortcuts to trigger predefined actions
  6. The Live View
  7. List and Description of all Gestures
    1. Magic Mouse
    2. Touchpad
  8. List and Description of all Predefined Actions
  9. Window Moving Stuff (to be done)
    1. Window Moving
    2. Window Snapping
  10. General BetterTouchTool Settings (to be done)
  11. Magic Mouse Settings (to be done)
    1. General
    2. Clicks
    3. Swipes
    4. Ignore
    5. TipTaps
    6. Three Finger Taps
    7. Other Gestures
  12. Touchpad Settings (to be done)
    1. General
    2. Taps
    3. TipTaps
    4. Other
  13. Troubleshooting (to be done)
  14. Licenses

System Requirements

BetterTouchTool works only with Snow Leopard (>= 10.6 ) but could stop working everytime because it uses undocumented stuff and apple could easily disable that.

First Steps

  • You can open the preferences window using the menubar icon.

  • After you have opened the window you’ll see this:

The Main Window

  1. Here you can select if you want to set the gesture for Magic Mouse or for the Trackpad or for the Keyboard (Shortcuts are available with versions >= 0.5185). Be sure to select the correct tab!
  2. This button is the first step in adding a new gesture. Press it and in the table above a new entry will be created. (see section “Adding A New Gesture“)
  3. This button deletes the gesture which is selected in the table above.
  4. This will open the live view. The live view can show all your fingers BTT recognizes. It will show you exactly how BTT sees your fingers. Also you can see which gesture was just executed. While live view is open gestures will have no effect!
  5. This is for creating / importing / exporting sets of gestures. If you hit export it will create a file with all your gestures in it (touchpad and magic mouse) and lets you save it.
  6. Here you have to select the application for which the gesture you add will work. You can set different gestures for different apps. If you set gestures while “global” is selected, the gesture will work in every app unless a specific app overwrites it (uses the same gesture).
  7. Here you can add or remove applications.

Adding A New Gesture

  1. After you hit the “Add new gesture” button this one will become available. If you hit it you’ll see a list of available gestures. Select the one you want by clicking on it.
  2. This are modifier keys. If you select one of them you’ll have to press it while performing the selected gesture in order to trigger the action you connected to the gesture. For most gestures you’ll want to select “none”.
  3. Here you can enter shortcuts that will be sent to the system if you perform the selected gesture. It will simulate key presses. With shortcuts you can control nearly everything in every program. If you want to be able to record shortcuts that are used by other programs you’ll have to activate access for assistive devices in your System Preferences => Universal Access.
  4. Here you can select one of the predefined actions (see list & description of all predefined actions). It will be executed if you perform the gesture. If a predefined action is selected and at the same time a shortcut is entered in the shortcut field, the predefined action will be sent, not the shortcut.

Here you can see some configured gestures:

How to use keyboard shortcuts to trigger predefined actions

In order to use shortcuts for triggering predefined actions just go to the keyboard tab in the main view (available with versions >= 0.5185 )

Then add a new shortcut, instead of selecting a gesture from a list you have to press the keys you want to use as shortcut. Assign the predefined action and you are done.


The LiveView

  1. Here you can select different areas which will be shown in the view. In the screenshot above the orange bar shows the range in which a single finger middleclick will be recognized.
  2. Here you see the last gesture performed and the connected action (the number before is the time, every time this number changes the gesture has been recognized). Some gestures are only recognized if they are added to your gesturelist.  While in live view no action will actually be executed!
  3. See Video

List and Description of all Gestures

  • Magic Mouse Gestures:

  • Single Finger Tap Left
    (Tap with one finger on the left half of the mouse, the area is configurable)
  • Single Finger Tap Right
    (Tap with one finger on the right half of the mouse, the area is configurable)
  • Single Finger Tap Middle
    (Tap with one finger on the middle of the mouse, the area is configurable)
  • Single Finger Tap
    (Tap with one finger somewhere on the mouse, only useful if you don’t use single finger tap left, right or middle)
  • Single Finger Click Middle
    (CLICK with one finger
  • Single Finger Tap Above Apple
    (Tap with one finger directly ABOVE the apple drawn on the magic mouse)
    ———————————-
  • Singe Finger Swipe Up
    (move one finger up, conflicts with scrolling so only use in apps where you can’t scroll or if you have disabled single finger scrolling)
  • Single Finger Swipe Down
    (move one finger down, conflicts with scrolling so only use in apps where you can’t scroll or if you have disabled single finger scrolling)
  • Single Finger Swipe Left
    (move one finger left, conflicts with scrolling so only use in apps where you can’t scroll or if you have disabled single finger scrolling)
  • Single Finger Swipe Right
    (move one finger right, conflicts with scrolling so only use in apps where you can’t scroll or if you have disabled single finger scrolling)
    ———————————-
  • Two Finger Tap
    (tap with two fingers, this one can easily create false positives because it often happens that you have two fingers on the mouse… so check if it works for you)
  • Two Finger Click
    (click with two fingers, this one can easily create false positives because it often happens that you have two fingers on the mouse while clicking.. so check if it works for you)
  • Two Finger Swipe Up
    (swipe up with two of your fingers at the same time)
  • Two Finger Swipe Down
    (swipe down with two of your fingers at the same time)
  • Two Finger Swipe Left
    (this replaces the original apple two finger swipe lefton the magic mouse, only use if necessary. The apple two finger swipes have to be ACTIVATED in the System Preferences)
  • Two Finger Swipe Right
    (this replaces the original apple two finger swipe right on the magic mouse, only use if necessary. The apple two finger swipes have to be ACTIVATED in the System Preferences)
    ———————————-
  • Three Finger Tap
    (Tap with three fingers)
  • Three Finger Click
    (Click with three fingers)
  • Three Finger Swipe Up
    (move three fingers up at the same time)
  • Three Finger Swipe Down
    (move three fingers down at the same time)
  • Three Finger Swipe Left
    (move three fingers left at the same time)
  • Three Finger Swipe Right
    (move three fingers right the same time)
  • TipSwipe Left Finger Up
    (Begin with 3 fingers on the mouse. Leave the right two fingers at their initial position and move the left finger up, see picture)
  • TipSwipe Left Finger Down
    (Begin with 3 fingers on the mouse. Leave the right two fingers at their initial position and move the left finger down, see picture)
    ———————————-
  • Four Finger Click
    (click with four fingers on the mouse)
  • Four Finger Swipe Up
    (move four of your fingers up at the same time)
  • Four Finger Swipe Down
    (move four of your fingers down at the same time)
    ———————————
  • TipTap Left
    (tap with one finger on the mouse, leave that finger where it is and after a very little time period tap with a second finger on the left of the first finger then release that second finger from the mouse surface immediately)
    see Video)
  • TipTap Right
    (tap with one finger on the mouse, leave that finger where it is and after a very little time period tap with a second finger on the right of the first finger then release that second finger from the mouse surface immediately)
    see Video)
  • Two Finger TipTap Left
    (First tap with two fingers on the mouse, leave those fingers where they are and after a very little time period tap with a third finger on the left of the first fingers and release that finger from the mouse again immediately)
    see Video)
  • Two Finger TipTap Right
    (First tap with two fingers on the mouse, leave those fingers where they are and after a very little time period tap with a third finger on the right  of the first fingers and release that finger from the mouse again immediately)
    see Video)
  • Two Finger TipTap Middle
    (First tap with two fingers on the mouse, leave space between those fingers. Then tap with a third finger between the two first fingers and release this third finger again immediately)
    ———————————-
  • Scroll Up (+modifier)
    (This only works in combination with a modifier key (fn/ctrl/alt/cmd), it is useful for e.g. adjusting the volume or brightness. You have to press the chosen modifier key and scroll  up with your magic mouse at the same time)
  • Scroll Down (+modifier)
    (This only works in combination with a modifier key (fn/ctrl/alt/cmd), it is useful for e.g. adjusting the volume or brightness. You have to press the chosen modifier key and scroll down with your magic mouse at the same time)
    ———————————
  • Pinch In
    See Video
  • Pinch Out
    See Video
    ——————————–
  • Single Finger Touch Top
    (This one should only be used in combination with the predefined action start/stop moving or start/stop resizing. Touch the mouse with only one finger on the very top. Then move the mouse to move or resize (depends on the chosen action) the windows which is currently under the cursor.)
    See Video
  • Two Finger Touch Top
    (This one should only be used in combination with the predefined action start/stop moving or start/stop resizing. Touch the mouse with two fingers on the very top. Then move the mouse to move or resize (depends on the chosen action) the windows which is currently under the cursor.)
    See Video
  • Three Finger Touch Top
    (This one should only be used in combination with the predefined action start/stop moving or start/stop resizing. Touch the mouse with three fingers on the very top. Then move the mouse to move or resize (depends on the chosen action) the windows which is currently under the cursor.)
    See Video

Touchpad Gestures:

  • Single Finger Tap Top Left
  • Single Finger Tap Top Right
  • Single Finger Tap Top Middle
  • Single Finger Tap Bottom Left
  • Single Finger Tap Bottom Right
  • Single Finger Tap Bottom Middle
  • Single Finger Tap Left Side Middle
  • Single Finger Tap Right Side Middle
    You can configure those taps here:

    Here a image of the areas if it is configured as shown above:
  • ———————————–
  • Triangle Swipe s, see this picture:
  • Three Finger Tap
    (Tap fast with three fingers but don’t click the touchpad)
  • Three Finger Tap Bottom
    (Tap fast with three fingers on the bottom half of the touchpad, may cause three finger click on some touchpads :-( )
  • Three Finger Tap Top
    (Tap fast with three fingers on the top half of the touchpad)
  • Three Finger Click
    (Click the touchpad with three fingers)
  • Three Finger Swipe Up
    (Swipe Up with three fingers, replaces the apple three finger swipe but the apple three finger swipe has to be ENABLED if you want to use this)
  • Three Finger Swipe Down
    (Swipe Down with three fingers, replaces the apple three finger swipe but the apple three finger swipe has to be ENABLED if you want to use this)
  • Three Finger Swipe Left
    (Swipe Left with three fingers, replaces the apple three finger swipe but the apple three finger swipe has to be ENABLED if you want to use this)
  • Three Finger Swipe Right
    (Swipe Right with three fingers, replaces the apple three finger swipe but the apple three finger swipe has to be ENABLED if you want to use this)
    ———————————–
  • TipSwipe Left Finger Down
    (Begin with 3 fingers on the touchpad. Leave the right two fingers at their initial position and move the left finger down, see picture)
  • TipSwipe Left Finger Up
    (Begin with 3 fingers on the touchpad. Leave the right two fingers at their initial position and move the left finger up,see picture)
  • TipSwipe Left Finger Left
    (Begin with 3 fingers on the touchpad. Leave the right two fingers at their initial position and move the left finger left,see picture)
  • TipSwipe Left Finger Right
    (Begin with 3 fingers on the touchpad. Leave the right two fingers at their initial position and move the left finger right,see picture)
    ———————————–
  • Four Finger Tap
    (Tap fast with four fingers but don’t click the touchpad)
  • Four Finger Click
    (Click the touchpad with four fingers)
  • Four Finger Swipe Down
    (Swipe down with four fingers. The original apple four finger swipe down  has to be DISABLED if you want to use this)
  • Four Finger Swipe Up
    (Swipe up with four fingers. The original apple four finger swipe up has to be DISABLED if you want to use this)
  • Four Finger Swipe Left
    (Swipe left with four fingers. The original apple four finger swipe left has to be DISABLED if you want to use this)
  • Four Finger Swipe Right
    (Swipe right with four fingers. The original apple four finger swipe right has to be DISABLED if you want to use this)
    ———————————–
  • Five Finger Tap
    (Tap fast with five fingers but don’t click the touchpad)
  • Five Finger Click
    (Click the touchpad with five fingers)
  • Five Finger Swipe Down
    (Swipe down with five fingers)
  • Five Finger Swipe Up
    (Swipe up with five fingers)
  • Five Finger Swipe Left
    (Swipe left with five fingers)
  • Five Finger Swipe Right
    (Swipe right with five fingers)
    ———————————–
  • TipTap Left
    (tap with one finger on the touchpad, leave that finger where it is and after a very little time period tap with a second finger on the left of the first finger then release that second finger from the touchpad surface immediately)
    see Video)
  • TipTap Right
    (tap with one finger on the touchpad, leave that finger where it is and after a very little time period tap with a second finger on the right of the first finger then release that second finger from the touchpad surface immediately)
    see Video)
  • Two Finger TipTap Left
    (First tap with two fingers on the touchpad, leave those fingers where they are and after a very little time period tap with a third finger on the left  of the first fingers and release that finger from the touchpad again immediately)
    see Video)
  • Two Finger TipTap Right
    (First tap with two fingers on the touchpad, leave those fingers where they are and after a very little time period tap with a third finger on the right  of the first fingers and release that finger from the touchpad again immediately)
    see Video)
  • Two Finger TipTap Middle
    (First tap with two fingers on the touchpad, leave space between those fingers. Then tap with a third finger between the two first fingers and release this third finger again immediately)
  • Three Finger TipTap Left
    (First tap with three fingers on the touchpad, leave those fingers where they are and after a very little time period tap with a fourth finger on the left  of the first fingers and release that finger from the touchpad again immediately)
  • Three Finger TipTap Right
    First tap with three fingers on the touchpad, leave those fingers where they are and after a very little time period tap with a fourth finger on the right  of the first fingers and release that finger from the touchpad again immediately)
    ———————————–
  • Scroll Up (+modifier)
    (This only works in combination with a modifier key (fn/ctrl/alt/cmd), it is useful for e.g. adjusting the volume or brightness. You have to press the chosen modifier key and scroll  up with your magic mouse at the same time)
    Sensitivity can be set in the touchpad tab in the preferences and there in the sub-tab “Scroll & Zoom & Rotate”
  • Scroll Down (+modifier)
    (This only works in combination with a modifier key (fn/ctrl/alt/cmd), it is useful for e.g. adjusting the volume or brightness. You have to press the chosen modifier key and scroll  down with your magic mouse at the same time)
    Sensitivity can be set in the touchpad tab in the preferences and there in the sub-tab “Scroll & Zoom & Rotate”
    ———————————–
  • Rotate Left
  • Rotate Right
    Replace the apple rotate, apple rotate gestures has to be ENABLED, can be configured here (how sensitive it is and how long it can’t be repeated after it has been done once):

    ———————————–
  • Pinch In
  • Pinch Out
    Replace the apple pinch/zoom gesture. Apple pinch/zoom gestures has to be ENABLED in order to use this. Can be configured as as shown in the screenshot above.
    ———————————–
  • 11 Finger Tap
    Thats just for fun ;-) May also trigger if you swipe with your whole hand over the touchpad.

Predefined Actions

  • No Action
    Nothing is done (e.g. useful to block apple gestures in programs where you don’t want them)
  • Use Apple default or do nothing
    Useful if you have redefined a apple gesture globally and still want to have the original apple behavior in some programs.
  • Touchpad Mode On/Off
    Still pretty experimental. Allows you to use the magic mouse like a touchpad. May improve this in a future version.
  • Middleclick
    Performs a middleclick like a normal mouse would do if you hit the middle button/the scroll wheel. E.g. useful to open new tabs by middleclicking on a link.
  • CMD-Click
    Performs a CMD-Click.
  • Leftclick
    Performs a normal leftclick. Useful in combination with e.g. single finger tap left for enabling tap to click.
  • Rightclick
    Performs a normal rightclick. Useful in combination with e.g. single finger tap left for enabling tap to click.
  • Doubleclick
    Performs a doubleclick
  • Zoom In
  • Zoom Out
    Zoom like on the touchpad. Should only be used with the magic mouse or maybe with scrolling + modifier.
  • Expose
    Opens Exposé with all windows
  • Hide All Windows
    Hides all windows. Unfortunately as a sideeffect the BTT Icon will appear in the dock if used.
  • Hide Menubar items temporarily.
    Hides all menubar items. Useful if you have many menubar icons and can’t see them all on you small laptop screen.
  • Show Desktop
    Shows the desktop
  • Application Expose
    Expose with the currents applications windows
  • Application Switcher
    Opens the Application Switcher. Also checkout the special application switcher mode in the tab predefined actions.
  • Spaces
    Shows spaces overview
  • Dashboard
  • opens the Dasboard
  • Open Finder
    will open a new Finder Window if there is none and if there is already a Finder window it will bring this window to front
  • Open Application / File / Script
    Is able to launch applications, open files with their standard application or execute applescripts if they are saved as scpt.
  • Open URL / Open URL with selection
    Open a URL in your Browser. If you put %@ in the URL it will be replaced by the currently selected text.
  • Search selected text with Google
    searchs the currently selected text with google.
  • 3F Swipe Left (Page Back)
    Performs a apple 3 finger swipe left. Does whatever the current app would do with a three finger swipe left the touchpad. Usually used for going a page back in your browser.
  • 3F Swipe Right (Page Forward)
    Performs a apple 3 finger swipe left. Does whatever the current app would do with a three finger swipe right on the touchpad. Usually used for going a page forward in your browser .
  • 3F Swipe Up
    Performs a apple 3 finger swipe up. Does whatever the current app would do with a three finger swipe up on the touchpad
  • 3F Swipe Down
    Performs a apple 3 finger swipe down. Usually used for going a page back. Does whatever the current app would do with a three finger swipe down on the touchpad
  • Sleep Display
    Should sleep the display but doesn’t work on some systems. Will try to fix that sooner or later ;-)
  • Sleep Computer
    Puts your computer to sleep without asking
  • Logout immediately.
    Logs you out immediately ;-)
  • Show Loginscreen
  • Show Hidden Files in Finder
  • Create new file in current folder
    Creates a new txt file in the current folder
  • Start/Stop Moving Window
    Starts or stops the moving of the window under the cursor if any gesture other than single finger touch top, two finger touch top and three finger touch top or TipTaps  is used.
    If one of those gestures is used the window under the cursor will move as long as you leave the fingers touching the mouse
  • Start/Stop Resizing Window
    Starts or stops the resizing of the window under the cursor if any gesture other than single finger touch top, two finger touch top and three finger touch top or TipTaps is used.
    If one of those gestures is used the window under the cursor will move as long as you leave the fingerstouching the mouse
  • Move Window Left
    Moves the window to the left side of the monitor and resizes it’s width to the value defined in the preferences (usually 50%)
  • Move Window Right
    Moves the window to the right side of the monitor and resizes it’s width to the value defined in the preferences (usually 50%)
  • Maximize Window Left
  • Maximize Window Right
    In addition to the move window left/right gestures those will also change the height of the window so that it fills the screen.
  • Maximize Window
    Will maximize the window (really maximize, not like the green zoom button)
  • Window to next Monitor
    Moves the window to the next monitor
  • Maximize to next monitor
    Maximizes the window to the next monitor
  • Restore old window size
    Restores the old size of the window (Try to resize back has to be enabled in the window snapping preferences in order for this to work)
  • Mute
  • Play/Pause
  • Volume Up
  • Volume Down
  • Previous
    Previous Track
  • Next
    Next Track
  • Brightness up
  • Brightness down
  • Eject
  • Keyboard Illumination up
  • Keyboard Illumination down
  • Page Down
  • Page Up
  • Forward delete
  • End (end of page)
  • Home (beginning of the page)

 

Licenses

Here the licenses of the frameworks BTT uses will be listed.

HIDRemote.m by  IOSPIRIT GmbH (http://www.iospirit.com/)

//
//  HIDRemote.m
//  HIDRemote V1.2 (27th May 2011)
//
//  Created by Felix Schwarz on 06.04.07.
//  Copyright 2007-2011 IOSPIRIT GmbH. All rights reserved.
//
//  The latest version of this class is available at
//     http://www.iospirit.com/developers/hidremote/
//
//  ** LICENSE *************************************************************************
//
//  Copyright (c) 2007-2011 IOSPIRIT GmbH (http://www.iospirit.com/)
//  All rights reserved.



Leave a Reply