https://github.com/Evidlo/remarkable_mouse

use your reMarkable as a graphics tablet
https://github.com/Evidlo/remarkable_mouse

graphics-tablet remarkable-tablet wacom

Last synced: 29 days ago
JSON representation

use your reMarkable as a graphics tablet

• Host: GitHub
• URL: https://github.com/Evidlo/remarkable_mouse
• Owner: Evidlo
• License: gpl-3.0
• Created: 2019-02-24T09:26:32.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2024-11-10T03:41:48.000Z (about 1 month ago)
• Last Synced: 2024-11-10T04:17:07.273Z (about 1 month ago)
• Topics: graphics-tablet, remarkable-tablet, wacom
• Language: Python
• Size: 2.81 MB
• Stars: 513
• Watchers: 19
• Forks: 49
• Open Issues: 19
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# remarkable_mouse

Use your reMarkable as a graphics tablet.

Special thanks to [canselcik](https://github.com/canselcik/libremarkable) and [LinusCDE](https://github.com/LinusCDE/rmWacomToMouse) for inspiration.



# Quick Start

On the host machine with the tablet plugged in via USB:

``` bash

pip install remarkable-mouse

remouse

```

By default, `10.11.99.1` is used as the address.  Find your password in the reMarkable's [settings menu](https://remarkablewiki.com/tech/ssh).  If you are on Linux using X11, you can use the `--evdev` option for pressure support.

To use the `--region` flag, you may need to install the `python3-tk` or `python3-tkinter` package with your package manager.

# Examples

specify monitor, orientation, password

``` bash

remouse --orientation right --mode fit --monitor 1 --password foobar

```

passwordless login

``` bash

ssh-keygen -m PEM -t rsa -f ~/.ssh/remarkable -N ''

ssh-copy-id -i ~/.ssh/remarkable.pub [email protected]

remouse

```

running with pressure sensitivity (Linux only)

``` bash

sudo --preserve-env=USER,PATH env remouse --evdev

```

# Usage

```

usage: remouse [-h] [--debug] [--key PATH] [--password PASSWORD] [--address ADDRESS] [--mode {fit,fill,stretch}] [--orientation {top,left,right,bottom}] [--monitor NUM] [--region] [--threshold THRESH]

               [--evdev]

use reMarkable tablet as a mouse input

optional arguments:

  -h, --help            show this help message and exit

  --debug               enable debug messages

  --key PATH            ssh private key

  --password PASSWORD   ssh password

  --address ADDRESS     device address

  --mode {fit,fill,stretch}

                        Scale setting. Fit (default): take up the entire tablet, but not necessarily the entire monitor. Fill: take up the entire monitor, but not necessarily the entire tablet. Stretch:

                        take up both the entire tablet and monitor, but don't maintain aspect ratio.

  --orientation {top,left,right,bottom}

                        position of tablet buttons

  --monitor NUM         monitor to output to

  --region              Use a GUI to position the output area. Overrides --monitor

  --threshold THRESH    stylus pressure threshold (default 600)

  --evdev               use evdev to support pen pressure (requires root, Linux only)

```