r1tool — Rabbit R1 Rabbithole CLI Tool

CLI tool to bulk download images, export journal data, and manage entries on the Rabbit R1 rabbithole (hole.rabbit.tech). Built with Python.

Download your Rabbit R1 photos, magic camera images, and journal entries. Delete entries in bulk. Export everything as JSON.

quickstart

macOS / Linux:

./run.sh

Windows (PowerShell):

.\run.ps1

this creates a venv, installs dependencies, and runs the tool. if everything is already set up it just runs.

manual setup

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 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 (original + magic camera)
• download images by month
• export rabbithole journal as JSON
• bulk delete journal entries (all or by month)

utils

extract_token.js

run utils/extract_token.js in browser console on hole.rabbit.tech to auto-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 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.