Metadata-Version: 2.3
Name: remarkable-multidownload
Version: 1.0.3
Summary: Download multiple files from your remarkable tablet at once.
Author: Jannik
Author-email: Jannik <32801117+spontanurlaub@users.noreply.github.com>
Requires-Dist: pydantic
Requires-Dist: requests
Requires-Dist: tqdm
Maintainer: Jannik
Maintainer-email: Jannik <32801117+spontanurlaub@users.noreply.github.com>
Requires-Python: >=3.10
Project-URL: Documentation, https://github.com/spontanurlaub/remarkable_multidownload#readme
Project-URL: Homepage, https://github.com/spontanurlaub/remarkable_multidownload
Project-URL: Issues, https://github.com/spontanurlaub/remarkable_multidownload/issues
Project-URL: Repository, https://github.com/spontanurlaub/remarkable_multidownload
Description-Content-Type: text/markdown

# remarkable-multidownload

Download multiple files from your reMarkable tablet and save them into a single ZIP archive. The CLI can be installed via pip and then run as `remarkable_multidownload` with options to choose the output file and an optional starting folder on the tablet.

## Installation

- From source (local checkout):
  - pip install -e .
- From PyPI:
  - pip install remarkable-multidownload

Once installed, the console command `remarkable_multidownload` is available.

## Usage

Basic usage (download everything into `example.zip`):

- remarkable_multidownload

Choose a custom output filename:

- remarkable_multidownload --output my_docs.zip

Start from a specific folder on the reMarkable (e.g., a collection called `Notes/Project`):

- remarkable_multidownload --path Notes/Project

Combine both:

- remarkable_multidownload -p Notes/Project -o project_notes.zip

The command shows a progress bar with the current filename while downloading. In non-interactive environments, the progress bar is automatically disabled.

## How it works

- Connects to the reMarkable web interface at 10.11.99.1.
- Recursively lists collections and documents
- Downloads each document as PDF and writes it to the ZIP, preserving folder paths

## Troubleshooting

- Ensure your computer can reach the tablet at 10.11.99.1. Make sure the USB connection is active under Settings > General settings > Storage settings and the tablet is awake.
- If you see network timeouts, try reconnecting the device and ensure it’s awake.
- If you need to narrow the scope, use `--path` to start from a specific collection.
