Merge changes to 'master'
This commit is contained in:
commit
2d8a885814
71
README.md
71
README.md
@ -1,38 +1,65 @@
|
||||
# Comfortable Swipe (Ubuntu)
|
||||
[](https://www.gnu.org/licenses/gpl-3.0)
|
||||
|
||||
Comfortable 3-finger (and 4-finger) swipe gestures for Ubuntu 14.04 LTS+
|
||||
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. `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.
|
||||
|
||||
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. 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`
|
||||
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. Perform these steps to solve the permission issue:
|
||||
Sometimes, you'll need some permissions to read touchpad input data.
|
||||
|
||||
1. `sudo gpasswd -a $USER input`
|
||||
2. Log out / log back in
|
||||
1. Find out your permission group with `ls -l /dev/input/event*`
|
||||
```bash
|
||||
$ ls -l /dev/input/event*
|
||||
|
||||
### Optional: Add to Startup Applications
|
||||
1. `gnome-session-properties`
|
||||
2. Click `Add`
|
||||
3. Enter the following:
|
||||
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
|
||||
```
|
||||
|
||||
Name | Comforable Swipe
|
||||
------- | -------------------
|
||||
Command | `comfortable-swipe-start`
|
||||
Comment | Comfortable 3 or 4 finger swipe gestures
|
||||
2. Check the fourth column (e.g. `input`) then run
|
||||
```bash
|
||||
sudo gpasswd -a $USER input
|
||||
```
|
||||
|
||||
4. Save
|
||||
3. ***Important***: Log out / Log back in
|
||||
|
||||
## Configurations
|
||||
The configuration file is located at `~/.config/comfortable-swipe.conf`.
|
||||
@ -51,7 +78,7 @@ 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`
|
||||
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.
|
||||
|
||||
@ -302,7 +302,7 @@ namespace service {
|
||||
cerr << "Error: failed to switch on autostart. "
|
||||
<< "Are you sure you have the permissions?"
|
||||
<< endl;
|
||||
else
|
||||
else {
|
||||
fout <<
|
||||
"[Desktop Entry]\n"
|
||||
"Type=Application\n"
|
||||
@ -312,11 +312,14 @@ namespace service {
|
||||
"X-GNOME-Autostart-enabled=true\n"
|
||||
"Name=Comfortable Swipe\n"
|
||||
"Comment=3 or 4 touchpad gestures\n";
|
||||
cout << "Autostart switched on" << endl;
|
||||
}
|
||||
}
|
||||
}
|
||||
// shows help
|
||||
void help() {
|
||||
puts("comfortable-swipe [start|stop|restart|buffer|help]");
|
||||
puts("comfortable-swipe [start|stop|restart|autostart|buffer|help]");
|
||||
puts("");
|
||||
puts("start - starts 3/4-finger gesture service");
|
||||
puts("stop - stops 3/4-finger gesture service");
|
||||
puts("restart - stops then starts 3/4-finger gesture service");
|
||||
|
||||
Loading…
Reference in New Issue
Block a user