https://github.com/ris58h/Touch-Tab

Switch apps with trackpad on macOS.
https://github.com/ris58h/Touch-Tab

macos trackpad

Last synced: about 2 months ago
JSON representation

Switch apps with trackpad on macOS.

• Host: GitHub
• URL: https://github.com/ris58h/Touch-Tab
• Owner: ris58h
• Created: 2022-07-29T16:42:19.000Z (about 2 years ago)
• Default Branch: master
• Last Pushed: 2024-02-06T03:43:45.000Z (8 months ago)
• Last Synced: 2024-04-05T04:34:56.401Z (6 months ago)
• Topics: macos, trackpad
• Language: Swift
• Homepage:
• Size: 170 KB
• Stars: 156
• Watchers: 4
• Forks: 2
• Open Issues: 8
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Touch-Tab

![Touch-Tab AppSwitcher](https://user-images.githubusercontent.com/511242/185958284-e0f962aa-3f88-4d95-9176-3f3fe49a24c8.gif)

Switch apps with trackpad on macOS.

Use 3-fingers swipe right or 3-fingers swipe left to switch between apps.

Hold after the swipe or swipe slowly to show App Switcher UI.

## Installation

1. Download the [latest](https://github.com/ris58h/Touch-Tab/releases/latest/download/Touch-Tab.zip) `Touch-Tab.zip` from [Releases](https://github.com/ris58h/Touch-Tab/releases) page.

2. Unzip the archive and move `Touch-Tab.app` into the `Applications` folder.

3. The app is ad-hoc signed so when you run the app macOS will warn you: `"Touch-Tab" can’t be opened because Apple cannot check it for malicious software`. Right-click the app and click `Open`, a 

pop-up will appear, click `Open` again.

4. The app needs access to global trackpad events. Allow Touch-Tab to control your computer in `System Settings > Privacy & Security > Accesibility`. If you had Touch-Tab installed before you may need to remove Touch-Tab from the `Accessibility` list first and add it again.

5. Disable 3-finger swipe between full-screen apps or make it 4-finger in `System Settings > Trackpad > More Gestures > Swipe between full-screen apps`.

## Usage

- Use 3-fingers swipe right or 3-fingers swipe left to switch between apps.

- Hold after the swipe or swipe slowly to show App Switcher UI. Pro tip: you can use 2-fingers scroll to switch apps in App Switcher faster.

### Hide Status Bar Item

Holding ⌘ drag the item away from the status bar until you see ✖️ (cross icon) then let it go. To recover the item just open the app one more time.

## Troubleshooting

### "Touch-Tab" can’t be opened because Apple cannot check it for malicious software

Right-click the app and click `Open`, a pop-up will appear, click `Open` again.

### It's running but doesn't work

- Check that Touch-Tab is allowed to control your computer in `System Settings > Privacy & Security > Accesibility`.  If you had Touch-Tab installed before you may need to remove Touch-Tab from the `Accessibility` list first and add it again.

- Check that 3-finger swipe is disabled in `System Settings > Trackpad > More Gestures > Swipe between full-screen apps`.

### 3-finger swipe scrolls a content

It's a [known issue](https://github.com/ris58h/Touch-Tab/issues/1). The workaround is to setup `Mission Control` or `App Expose` to use 3-finger swipe in `System Settings > Trackpad > More Gestures`.

### It still doesn't work

Please create an [issue](https://github.com/ris58h/Touch-Tab/issues).