# Fusuma [![Gem Version](https://badge.fury.io/rb/fusuma.svg)](https://badge.fury.io/rb/fusuma)

Fusuma is multitouch gesture recognizer.
This gem makes your linux PC able to recognize swipes or pinchs and assign shortcuts to them.

[![https://gyazo.com/757fef526310b9d68f68e80eb1e4540f](https://i.gyazo.com/757fef526310b9d68f68e80eb1e4540f.png)](https://gyazo.com/757fef526310b9d68f68e80eb1e4540f)

襖(Fusuma) means sliding door used to partition off rooms in a Japanese house.

## Installation

IMPORTANT: You must be a member of the _input_ group to have permission
to read the touchpad device:

    $ sudo gpasswd -a $USER input  # Log out and back in to assign this group

You need libinput release 1.0 or later. Install libinput-tools: 

    $ sudo apt-get install libinput-tools

For sending shortcuts:

    $ sudo apt-get install xdotool

Install Fusuma:

    $ gem install fusuma

## Usage

    $ fusuma

## Update

    $ gem update fusuma

## Customize

You can customize the settings for gestures to put and edit `~/.config/fusuma/config.yml`.  
*NOTE*: You will need to create the `~.config/fusuma` directory if it doesn't exist yet.


### Sample (default keymap for Elementary OS)

```yaml
swipe:
  3: 
    left: 
      shortcut: 'alt+Left'
    right: 
      shortcut: 'alt+Right'
    up: 
      shortcut: 'ctrl+t'
    down: 
      shortcut: 'ctrl+w'
  4:
    left: 
      shortcut: 'super+Left'
    right: 
      shortcut: 'super+Right'
    up: 
      shortcut: 'super+a'
    down: 
      shortcut: 'super+s'
pinch:
  in:
    shortcut: 'ctrl+plus'
  out:
     shortcut: 'ctrl+minus'

threshold:
  swipe: 1
  pinch: 1
```

if `shortcut: ` is blank, the swipe/pinch doesn't trigger a keyevent.

`threshold:` is sensitivity to swipe/pinch. Default value is 1.
if the swipe's threshold change to `0.5`, shorten swipe-length by half

## Options

*   `-v` : Enable debug mode.

## Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/iberianpig/fusuma. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.


## License

The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).