86 lines
2.8 KiB
Markdown
86 lines
2.8 KiB
Markdown
# Comfortable Swipe (Ubuntu)
|
|
[](https://www.gnu.org/licenses/gpl-3.0)
|
|
|
|
Comfortable, seamless, and fast 3-finger (and 4-finger) touchpad swipe gestures for Ubuntu 14.04 LTS and beyond. May work for other Linux distros that support `libinput`.
|
|
|
|
## Installation
|
|
|
|
1. Install `libinput-tools` and `libxdo-dev`
|
|
|
|
```bash
|
|
sudo apt-get install libinput-tools libxdo-dev
|
|
```
|
|
|
|
2. Clone this repository
|
|
|
|
```bash
|
|
git clone https://github.com/Hikari9/comfortable-swipe-ubuntu.git
|
|
cd comfortable-swipe-ubuntu
|
|
```
|
|
|
|
3. Install
|
|
|
|
```bash
|
|
bash install
|
|
```
|
|
|
|
4. You may delete the downloaded `comfortable-swipe-ubuntu` folder after installation.
|
|
|
|
## How to Run
|
|
|
|
1. Make sure `~/.local/bin/` is added to your PATH.
|
|
2. Run
|
|
|
|
```
|
|
comfortable-swipe start
|
|
```
|
|
|
|
3. Optional: Automatically run on startup
|
|
|
|
```
|
|
comfortable-swipe autostart
|
|
```
|
|
|
|
### Permissions
|
|
Sometimes, you'll need some permissions to read touchpad input data.
|
|
|
|
1. Find out your permission group with `ls -l /dev/input/event*`
|
|
```bash
|
|
$ ls -l /dev/input/event*
|
|
|
|
crw-rw---- 1 root input 13, 64 Oct 23 23:09 /dev/input/event0
|
|
crw-rw---- 1 root input 13, 65 Oct 23 23:09 /dev/input/event1
|
|
crw-rw---- 1 root input 13, 66 Oct 23 23:09 /dev/input/event2
|
|
crw-rw---- 1 root input 13, 67 Oct 23 23:09 /dev/input/event3
|
|
```
|
|
|
|
2. Check the fourth column (e.g. `input`) then run:
|
|
```bash
|
|
sudo gpasswd -a $USER input
|
|
```
|
|
> Note: Don't forget to input your `sudo` password!
|
|
|
|
3. ***Important***: Log out / Log back in
|
|
|
|
## 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
|
|
--------- | ----------- | -------------- | -----
|
|
threshold | mouse pixels to activate swipe; higher = less sensitive; floating-point | 0.0
|
|
left3 | 3-finger swipe left | ctrl+shift+Right | switch to right workspace
|
|
left4 | 4-finger swipe left | ctrl+alt+shift+Right | move window to right workspace
|
|
right3 | 3-finger swipe right | ctrl+shift+Left | switch to left workspace
|
|
right4 | 4-finger swipe right | ctrl+alt+shift+Left | move window to left workspace
|
|
up3 | 3-finger swipe up | ctrl+shift+Down | switch to bottom workspace
|
|
up4 | 4-finger swipe up | ctrl+alt+shift+Down | move window to bottom workspace
|
|
down3 | 3-finger swipe down | ctrl+shift+Down | switch to above workspace
|
|
down4 | 4-finger swipe down | ctrl+alt+shift+Up | move window to above workpace
|
|
|
|
## Uninstall
|
|
Download the `uninstall` script then run `bash uninstall`
|
|
|
|
## Bug Reports
|
|
Create an issue [here](https://github.com/Hikari9/comfortable-swipe-ubuntu/issues/new) to report a bug.
|