r1tool — Rabbit R1 Rabbithole CLI

A Python CLI for the Rabbit R1 rabbithole (hole.rabbit.tech). Bulk download your photos and magic camera images, export the journal as JSON, and delete entries by month or all at once.

quickstart

macOS / Linux:

./run.sh

Windows (PowerShell):

.\run.ps1

the script creates a venv, installs dependencies, and runs the tool. on subsequent runs it skips setup.

manual setup

requires Python 3.10+.

python3 -m venv .venv
source .venv/bin/activate    # Windows: .venv\Scripts\Activate.ps1
pip install -r requirements.txt
playwright install chromium
python r1tool.py

login

on first run you'll be asked how to log in:

• open browser — a browser window opens, you log in on hole.rabbit.tech as usual, and the access token is captured automatically
• paste token — manually paste your access token (browser devtools → network tab → fetchUserJournal → payload → accessToken)

the token is cached in ~/.r1tool_token and reused until it expires.

features

• download all Rabbit R1 images (originals + magic camera output)
• download images filtered by month
• export the rabbithole journal as JSON
• bulk delete journal entries (all, or by month)

utils

extract_token.js

run utils/extract_token.js in the browser console on hole.rabbit.tech to capture your rabbithole access token. useful as a fallback if browser login doesn't work.

r1cleanpics.py

cleans up downloaded Rabbit R1 images — detects duplicate JPGs (by md5 hash) and unpaired original/magic camera files, moves them to subfolders.

python utils/r1cleanpics.py

run from the folder containing your downloaded images. creates duplicates/ and broken/ subfolders as needed.

license

MIT — see LICENSE.