Jitouch

Jitouch is a Mac application that expands the set of multi-touch gestures for MacBook, Magic Mouse, and Magic Trackpad. These thoughtfully designed gestures enable users to perform frequent tasks more easily such as changing tabs in web browsers, closing windows, minimizing windows, changing spaces, and a lot more.

For more details, see https://www.jitouch.com/.

Hacking

To build or modify Jitouch, please install the necessary prerequisites and then follow the building steps below.

Prerequisites

Xcode (necessary)
- Install Xcode from the Mac App Store
Homebrew (recommended):
- Follow the official instructions
- or run /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
CocoaPods (necessary)
- brew install cocoapods
- or follow the official instructions
npm (required for release builds)
- brew install npm
appdmg (required for release builds)
- npm install -g appdmg

Building

Clone this repository:

git clone https://github.com/JitouchApp/Jitouch
cd Jitouch

Install the dependencies:
```
pod install
```
Either open the project in Xcode:
```
open Jitouch.xcworkspace
```

❗ Please note that you must not open `Jitouch.xcodeproj`, otherwise CocoaPods dependencies will not be built correctly.

Or compile from the shell:
```
make build
```

Install and run:

open DerivedData/Build/Products/Debug/Jitouch.prefPane

Contributing

Fork this project, commit your changes and open a pull-request

❗ You need to sign-off your commits to acknowledge the Developer Certificate of Origin (DCO).

This will be enforced automatically on pull requests. For more information, read about the DCO App and the following section.

Developer Certificate of Origin (DCO)

To sign-off on a commit, read the DCO and then add the -s flag to git commit:

-s, --signoff
    Add Signed-off-by line by the committer at the end of the commit log
    message. The meaning of a signoff depends on the project, but it typically
    certifies that committer has the rights to submit this work under the same
    license and agrees to a Developer Certificate of Origin (see
    http://developercertificate.org/ for more information).

License

Jitouch is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

Jitouch is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with Jitouch. If not, see https://www.gnu.org/licenses/.

Crazor / Jitouch-project