Use a reMarkable as a pressure-sensitive drawing tablet on macOS.
remarkable-inkbridge-web.mp4
(Early video shown above. Might not use correct build command as we go along. Read below on how to use the tool)
inkbridge runs on the Mac, reads the pen over SSH and posts native macOS tablet events, so Photoshop and other apps see pressure, tilt, hover and the eraser end. Nothing is installed on the tablet.
Status: early, but usable for drawing. Developed and tested on a reMarkable Pure (firmware 3.28) over USB with Photoshop on Apple Silicon. Reported working on a reMarkable Paper Pro too. Other models may need different device names; see below.
- Pressure (4096 levels), tilt, hover and the eraser end
- Landscape or portrait mapping onto the main display
- Pen and touch are grabbed while running, so the tablet UI does not react to drawing or finger gestures; released again on exit
- Around 500 reports per second over USB, with under 1 ms added by the link
Known limits:
- Hover lags a little. The pen firmware filters positions and delivers them in batches on a ~16 ms cycle, before inkbridge sees them. Drawing feels fine.
- No barrel rotation (twisting the pen); the hardware does not report it.
- macOS with Swift (Xcode or the Command Line Tools:
xcode-select --install) - A reMarkable in developer mode, which gives root SSH access. Turning on developer mode factory resets the tablet. Sync or export your notebooks first.
- A USB cable, at least for the first connection. After that Wi-Fi works too; see Wi-Fi.
-
Enable developer mode on the tablet and finish the setup screens. The root SSH password is under Settings > Help > About > Copyrights and licenses, at the bottom of the GPLv3 Compliance section.
-
Connect the tablet by USB. Every reMarkable is at
10.11.99.1over USB, which inkbridge uses by default. -
Download and build, in a terminal:
git clone https://github.com/eddiedale/inkbridge.git cd inkbridge makemakebuilds inkbridge and asks whether to add aninkbridgecommand, so you can start it from any folder (a link in/usr/local/bin). Say no and you start it with./inkbridgein this folder instead; your answer is remembered.To update later, run
git pullandmakeagain in the same folder.inkbridge unlinkremoves the link again (the nextmakeasks again);./inkbridge linkadds it any time. If linking needs admin rights on your Mac, usesudo ./inkbridge link, or./inkbridge link --prefix ~/.localif~/.local/binis on your PATH. -
Allow your terminal app to control the computer, so it can post pen events: System Settings > Privacy & Security > Device control and data access (called Accessibility on older macOS versions).
inkbridge
Hold the tablet in landscape with its top edge on the right. A live panel lets you tune settings while drawing:
╷╭╮╷╷╭ ╭╮ ╭─╮╷╶┬╮╭─╴╭─╴
││╰┤├┴╮├┴╮├┬╯│ │││╶╮├╴
╵╵ ╵╵ ╵╰─╯╵╰╴╵╶┴╯╰─╯╰─╴
● connected USB 10.11.99.1
← → pressure curve 1.5 firm ▁▁▂▂▂▃▃▃▄▄▅▆▆▇▇█
↓ ↑ min pressure 3% less does not draw
⇧↓↑ max pressure 80% more is full pressure
s smoothing on evens out steps in pressure
r rotation 90° landscape, top edge right
a area map crop to screen middle 73% of tablet height
p padding 2% margin at the tablet edge
d draw on tablet off the pen only drives the Mac
t touch on tablet off fingers are ignored by the tablet
w connection USB switch to Wi-Fi
h help q quit settings are saved automatically
inkbridge --full also shows live pen meters (state, output and raw
pressure) at the top, handy while tuning the pressure settings, and the
report rate and link lag at the bottom.
| setting | key | default | what it does |
|---|---|---|---|
| pressure curve | ← → | 1.5 (firm) | below 1 is soft (light strokes get heavier), above 1 is firm |
| min pressure | ↓ ↑ | 3% | pressure below this does not draw, so a resting pen leaves no ink |
| max pressure | Shift ↓ ↑ | 80% | pressure from this point is full, so you reach the thickest stroke without pushing hard |
| smoothing | s | on | the pen reports pressure only ~38 times a second; smoothing removes the steps this leaves in tapered strokes, at about 10 ms of pressure delay |
| rotation | r | 90° | how the tablet is held; 90° is landscape with its top edge on the right |
| area map | a | crop to screen | crop to screen: a centred part of the tablet in your screen's shape, so shapes stay true and the whole screen is reachable (on a 16:9 screen, the middle ~73% of the tablet's height). fill screen: the whole tablet, shapes stretch a little. keep proportions: the whole tablet, with bars on the screen |
| padding | p | 2% | a margin around the tablet edge that maps just past the screen edge, so you reach the screen edges before the bezel (2% is about 3 mm) |
| draw on tablet | d | off | on: the tablet sees the pen too and draws on the open page with its current tool |
| touch on tablet | t | off | on: fingers work on the tablet; off keeps a resting hand from scrolling or zooming it |
| connection | w | USB | switch between USB (lowest lag) and Wi-Fi; see Wi-Fi |
Press h in the panel for a help screen explaining each setting. Settings
are saved to ~/.config/inkbridge/settings.json. Press q to quit.
In Photoshop, set Brush Settings > Shape Dynamics > Size Jitter Control to Pen Pressure to see pressure.
On the first run, inkbridge offers to set up an SSH key so you never need the tablet password again:
Set up an SSH key so you won't need the tablet password?
1) use ~/.ssh/id_ed25519.pub
n) create a new key just for the tablet (~/.ssh/id_ed25519_inkbridge)
s) skip, and don't ask again
Pick one of your existing keys or n for a dedicated key (recommended), then
enter the password once to install it. The choice is saved in
~/.config/inkbridge/, and keys on the tablet survive reMarkable software
updates. Delete that folder to be asked again.
Without a key, inkbridge asks for the password and keeps the connection open for 10 minutes, so restarts in between do not ask again.
USB has the lowest and steadiest latency. Wi-Fi works too, with a bit more lag and occasional short stalls.
Easiest: start inkbridge over USB and press w in the panel. inkbridge
turns on SSH over Wi-Fi on the tablet (once, it stays on), finds the
tablet's Wi-Fi address and switches to it. You can unplug the cable then.
Press w again to go back to USB.
You do not need to choose at start: inkbridge tries the link that worked last, then the other one, so plugging or unplugging the cable just works (the missing one costs a few seconds of timeout). This needs the SSH key from above, since the panel cannot ask for a password.
By hand: with the cable in, run ssh root@10.11.99.1 rm-ssh-over-wlan on
once. Find the tablet's Wi-Fi address under Settings > Help > About on the
tablet, then:
./inkbridge --host 192.168.1.23
Over Wi-Fi, inkbridge turns off the tablet's Wi-Fi power saving, which noticeably lowers latency. It comes back on when the tablet reboots.
| command | what it does |
|---|---|
make |
build inkbridge, and the first time offer to add the inkbridge link |
make clean |
delete the built program |
inkbridge |
start inkbridge from any folder, once linked |
./inkbridge |
start inkbridge from the inkbridge folder, if you haven't linked it |
inkbridge link |
add the inkbridge link, so inkbridge runs from any folder (--prefix DIR puts it in DIR/bin) |
inkbridge unlink |
remove the inkbridge link |
git pull then make |
update to the latest version |
Before it is linked, use ./inkbridge link from the inkbridge folder.
| option | default | |
|---|---|---|
--host |
10.11.99.1 |
tablet address |
--rotate 0|90|180|270 |
90 |
how far the tablet is turned clockwise from portrait |
--area fill|keep|crop |
crop |
how the tablet maps onto the display (see area map above) |
--device |
event2 |
pen input device on the tablet |
--touch-device |
event3 |
touch input device, grabbed so gestures are ignored |
--no-grab |
off | turn on draw on tablet and touch on tablet |
--full |
off | add pen meters and link stats to the panel |
--plain |
off | print lines instead of the live panel |
--stats |
off | in plain mode, print report rate and link lag once a second |
--rate N |
0 |
cap motion events per second (0 = every report) |
--debug |
off | print every pen report |
The device names differ between models. Find the pen and touch devices with:
ssh root@10.11.99.1 cat /proc/bus/input/devices
and pass them with --device and --touch-device. The axis ranges in
bridge/Pen.swift are the Pure's; tools/recon.sh collects them for
another model. Reports from other devices are welcome.
You only need this if make could not add the inkbridge command, or you
want it somewhere other than /usr/local/bin. The command is just a link to
the program in your inkbridge folder, placed in any folder on your PATH
(echo $PATH lists them).
From the inkbridge folder:
ln -sf "$PWD/inkbridge" /usr/local/bin/inkbridge
and to remove it:
rm /usr/local/bin/inkbridge
Use sudo in front of either if that folder needs admin rights, and swap
/usr/local/bin for your folder of choice. inkbridge link --prefix DIR
does the same for DIR/bin and remembers it, so inkbridge unlink can
remove it later; links made by hand outside /usr/local/bin it does not
know about.
inkbridge opens SSH to the tablet and runs its built-in evtest --grab on the
pen device, which takes exclusive access and prints each input event. The Mac
side parses those, groups them per report, maps tablet coordinates onto the
display and posts CGEvent tablet proximity and pointer events with pressure
and tilt. When the connection drops, the tablet releases the grab.
Background and measurements are in docs/:
docs/recon-pure.md: the Pure's input devices, axis ranges, report rates and the firmware batching behind the hover lagdocs/results.md: test results per phase
tools/pressure-test.swift checks, without a tablet, whether an app honours
synthetic pen pressure on your Mac.
reMarkable is a trademark of reMarkable AS.
inkbridge is not affiliated with reMarkable or Wacom.
MIT