Merge changes to 'master'
This commit is contained in:
commit
2d8a885814
71
README.md
71
README.md
@ -1,38 +1,65 @@
|
|||||||
# Comfortable Swipe (Ubuntu)
|
# Comfortable Swipe (Ubuntu)
|
||||||
[](https://www.gnu.org/licenses/gpl-3.0)
|
[](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
|
## Installation
|
||||||
1. `sudo apt-get install git libinput-tools libxdo-dev`
|
|
||||||
2. `git clone https://github.com/Hikari9/comfortable-swipe-ubuntu.git`
|
1. Install `libinput-tools` and `libxdo-dev`
|
||||||
3. `cd comfortable-swipe-ubuntu`
|
|
||||||
4. `bash install`
|
```bash
|
||||||
5. You may delete the downloaded `comfortable-swipe-ubuntu` folder.
|
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
|
## 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
|
### 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`
|
1. Find out your permission group with `ls -l /dev/input/event*`
|
||||||
2. Log out / log back in
|
```bash
|
||||||
|
$ ls -l /dev/input/event*
|
||||||
|
|
||||||
### Optional: Add to Startup Applications
|
crw-rw---- 1 root input 13, 64 Oct 23 23:09 /dev/input/event0
|
||||||
1. `gnome-session-properties`
|
crw-rw---- 1 root input 13, 65 Oct 23 23:09 /dev/input/event1
|
||||||
2. Click `Add`
|
crw-rw---- 1 root input 13, 66 Oct 23 23:09 /dev/input/event2
|
||||||
3. Enter the following:
|
crw-rw---- 1 root input 13, 67 Oct 23 23:09 /dev/input/event3
|
||||||
|
```
|
||||||
|
|
||||||
Name | Comforable Swipe
|
2. Check the fourth column (e.g. `input`) then run
|
||||||
------- | -------------------
|
```bash
|
||||||
Command | `comfortable-swipe-start`
|
sudo gpasswd -a $USER input
|
||||||
Comment | Comfortable 3 or 4 finger swipe gestures
|
```
|
||||||
|
|
||||||
4. Save
|
3. ***Important***: Log out / Log back in
|
||||||
|
|
||||||
## Configurations
|
## Configurations
|
||||||
The configuration file is located at `~/.config/comfortable-swipe.conf`.
|
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
|
threshold | mouse pixels to activate swipe; higher = less sensitive; integers only | 20
|
||||||
|
|
||||||
## Uninstall
|
## Uninstall
|
||||||
1. `bash uninstall`
|
Download the `uninstall` script then run `bash uninstall`
|
||||||
|
|
||||||
## Bug Reports
|
## Bug Reports
|
||||||
Create an issue [here](https://github.com/Hikari9/comfortable-swipe-ubuntu/issues/new) to report a bug.
|
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. "
|
cerr << "Error: failed to switch on autostart. "
|
||||||
<< "Are you sure you have the permissions?"
|
<< "Are you sure you have the permissions?"
|
||||||
<< endl;
|
<< endl;
|
||||||
else
|
else {
|
||||||
fout <<
|
fout <<
|
||||||
"[Desktop Entry]\n"
|
"[Desktop Entry]\n"
|
||||||
"Type=Application\n"
|
"Type=Application\n"
|
||||||
@ -312,11 +312,14 @@ namespace service {
|
|||||||
"X-GNOME-Autostart-enabled=true\n"
|
"X-GNOME-Autostart-enabled=true\n"
|
||||||
"Name=Comfortable Swipe\n"
|
"Name=Comfortable Swipe\n"
|
||||||
"Comment=3 or 4 touchpad gestures\n";
|
"Comment=3 or 4 touchpad gestures\n";
|
||||||
|
cout << "Autostart switched on" << endl;
|
||||||
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
// shows help
|
// shows help
|
||||||
void 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("start - starts 3/4-finger gesture service");
|
||||||
puts("stop - stops 3/4-finger gesture service");
|
puts("stop - stops 3/4-finger gesture service");
|
||||||
puts("restart - stops then starts 3/4-finger gesture service");
|
puts("restart - stops then starts 3/4-finger gesture service");
|
||||||
|
|||||||
@ -1,5 +1,6 @@
|
|||||||
#!/bin/bash
|
#!/bin/bash
|
||||||
echo "Uninstalling..."
|
echo "Uninstalling..."
|
||||||
|
rm ${XDG_CONFIG_HOME:-$HOME/.config}/autostart/comfortable-swipe.desktop 2> /dev/null
|
||||||
comfortable-swipe stop 2> /dev/null
|
comfortable-swipe stop 2> /dev/null
|
||||||
rm $HOME/.local/bin/comfortable-swipe 2> /dev/null
|
rm $HOME/.local/bin/comfortable-swipe 2> /dev/null
|
||||||
sleep 1
|
sleep 1
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user