# Comfortable Swipe (Ubuntu)
[![License: GPL v3](https://img.shields.io/badge/License-GPL%20v3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)  

Comfortable 3-finger (and 4-finger) swipe gestures for Ubuntu 14.04 LTS+

## Installation
1. `sudo apt-get install git libinput-tools libxdo-dev`
2. `git clone https://github.com/Hikari9/comfortable-swipe-ubuntu.git`
3. `cd comfortable-swipe-ubuntu`
4. `bash install`
5. You may delete the downloaded `comfortable-swipe-ubuntu` folder.

## How to Run
1. Run `comfortable-swipe start` in Terminal
2. Flick away!

    > If you're getting *command not found*, try running: `/home/$USER/.local/bin/comfortable-swipe start`

### Permissions
Sometimes, you'll need some permissions to read touchpad input data. Perform these steps to solve the permission issue:

1. `sudo gpasswd -a $USER input`
2. Log out / log back in

### Optional: Add to Startup Applications
1. `gnome-session-properties`
2. Click `Add`
3. Enter the following:
    
    Name    | Comforable Swipe
    ------- | -------------------
    Command | `comfortable-swipe-start`
    Comment | Comfortable 3 or 4 finger swipe gestures

4. Save

## Configurations
The configuration file is located at `~/.config/comfortable-swipe.conf`.  
Make sure to run `comfortable-swipe restart` after making changes.

Property  | Description | Default Value | Default Behavior
--------- | ----------- | -------------- | -----
left3     | 3-finger swipe left | ctrl+shift+Right | switch to right workspace
right3    | 3-finger swipe right | ctrl+shift+Left | switch to left workspace
up3       | 3-finger swipe up | super+w | window spread
down3     | 3-finger swipe down | super+w | window spread
left4     | 4-finger swipe left | ctrl+alt+shift+Right | move window to right workspace
right4    | 4-finger swipe right | ctrl+alt+shift+Left | move window to left workspace
up4       | 4-finger swipe up | super+d | show desktop
down4     | 4-finger swipe down | super+d | show desktop
threshold | mouse pixels to activate swipe; higher = less sensitive; integers only | 20

## Uninstall
1. `bash uninstall`

## Bug Reports
Create an issue [here](https://github.com/Hikari9/comfortable-swipe-ubuntu/issues/new) to report a bug.