comfortable-swipe/README.md

3.2 KiB

Comfortable Swipe (Ubuntu)

License: GPL v3

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

    sudo apt-get install libinput-tools libxdo-dev
    
  2. Clone this repository

    git clone https://github.com/Hikari9/comfortable-swipe-ubuntu.git
    cd comfortable-swipe-ubuntu
    
  3. Install

    bash install
    
  4. You may delete the downloaded comfortable-swipe-ubuntu folder after installation.

How to Run

Comfortable swipe should already be running as a service upon installation. Some notes:

  • The program makes use of keyboard gestures for swiping (e.g. ctrl+alt+Right)
  • By default, comfortable swipe uses Ubuntu workspace shortcuts (see configurations).

Useful References:

Other Commands

You can run comfortable-swipe help to see a list of commands:

$ comfortable-swipe help

comfortable-swipe [start|stop|status|restart|buffer|help]

start      - starts 3/4-finger gesture service
stop       - stops 3/4-finger gesture service
status     - shows the status of the program (service log)
restart    - stops then starts 3/4-finger gesture service
buffer     - parses output of libinput-debug-events
help       - shows the help dialog

Configuration file can be found in /usr/local/share/comfortable-swipe.conf

Configurations

The configuration file is located at /usr/local/share/comfortable-swipe.conf. 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

Clone the repository then run bash uninstall.

Bug Reports

Create an issue here to report a bug. Please make sure to add the following to your issue:

  1. Content of .log (found in the cloned folder)
  2. Output of comfortable-swipe status