forked from https://github.com/Evidlo/remarkable_mouse | patches include cool mapping mode that actually does proper aspect ratio conversion and fixing it for smartcard ssh setups

evan 9a5fff9227 bump version 7.0.0		3 years ago
remarkable_mouse	bump version 7.0.0	3 years ago
.gitignore	add photo, ssh connection message	6 years ago
LICENSE	add	4 years ago
Makefile	add makefile	5 years ago
README.md	Add GUI to position target range, and stretch mode (#55 )	3 years ago
logo.svg	add logo	4 years ago
photo.gif	add animated image	5 years ago
photo.jpg	add photo, ssh connection message	6 years ago
setup.py	bump version	5 years ago

README.md

remarkable_mouse

Use your reMarkable as a graphics tablet.

Special thanks to canselcik and LinusCDE for inspiration.

Quick Start

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

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. 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 address, monitor, orientation, password

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

passwordless login

ssh-keygen -m PEM -t rsa -f ~/.ssh/remarkable -N ''
ssh-copy-id -i ~/.ssh/remarkable.pub root@10.11.99.1
remouse --key ~/.ssh/remarkable

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)