remarkable-tools
A compact Python toolkit for browsing your tablet, downloading the latest PDFs, uploading files, and fixing overly opaque highlights in exported documents.
The two-pane interface is optimized for quick document work: folders on the left, documents on the right, and status + toggles always visible above the list.
Start it with:
$ remarkable
Useful keys
Enter Open folderd Download PDFD Download rmdocu Upload fileh Toggle HL FixH Toggle snap annotations/ Filter viewq QuitUse remarkable to browse the tablet, pull down the newest document, or upload a
PDF without leaving the terminal. Downloaded PDFs keep highlight fixing enabled unless you
explicitly turn it off.
$ uv tool install remarkable-tools
$ remarkable --get-newest
$ remarkable --upload-file ./document.pdf
$ remarkable --no-hl-fix --get-newest
The fix reduces opaque export blocks into readable highlights, and snapped lines can become native PDF highlight annotations instead of raw filled rectangles.
Before
After
Actual sample crop from the project test document before and after running
remarkable-hlfix.
The project is lightweight by design: install it, point it at your tablet, and use it from a shell script or interactive terminal session.