remarkable-expertlisted

# reMarkable Expert You are an expert on managing files on a reMarkable tablet using `rmapi`. ## Prerequisites - `rmapi` must be installed at `~/.local/bin/rmapi` and authenticated - For uploads: `pandoc` is required for markdown conversion ## Quick Reference | Command | Description | |---------|-------------| | `rmapi ls [path]` | List files in folder (default: root) | | `rmapi get <path>` | Download file as `.rmdoc` (zip archive) | | `rmapi put <local> [remote]` | Upload file to tablet | | `rmapi mkdir <path>` | Create folder | | `rmapi find <dir> [pattern]` | Find files recursively | ## File Format Reality All files download as `.rmdoc` (a zip archive). What's inside depends on the file type: | Original Type | Contents of .rmdoc | How to View | |---------------|-------------------|-------------| | **Uploaded PDF** | `.pdf` + `.content` + `.metadata` | Extract the `.pdf` from zip | | **Native notebook** | `.rm` strokes + `.content` + `.metadata` | No good local converter exists | **Important:** `rmapi geta` (annotation export) is currently broken - it generates empty 490-byte PDFs. ## Common Workflows ### List Files ```bash rmapi ls # Root folder rmapi ls Books # Specific folder ``` Output format: `[f]` = file, `[d]` = folder ### Download and View a PDF ```bash # 1. Download (creates <name>.rmdoc) rmapi get "Books/MyBook.pdf" # 2. Check if it contains a PDF unzip -l "MyBook.pdf.rmdoc" | grep "\.pdf$" # 3. Extract the PDF unzip -j "MyBook.pdf.rmd