Add read-only Docspell FUSE mount

README.md

@@ -21,3 +21,29 @@ Das Programm:
 ## Konfiguration
 
 Erstellen Sie eine `docspell-import.json` Datei in Ihrem Home-Verzeichnis: [Beispiel-Konfiguration](./docspell-import-example.json)
+
+## Read-only FUSE mount
+
+The `mount` subcommand exposes a Docspell collection as a read-only filesystem.
+It uses the same `~/docspell-import.json` configuration and password command as the import command.
+
+```bash
+mkdir -p ~/mnt/docspell
+docspell-import mount --query '*' ~/mnt/docspell
+# unmount when done
+fusermount -u ~/mnt/docspell
+```
+
+Mounted files are grouped as:
+
+```text
+<Docspell folder>/<year>/<month>/<attachment name>
+```
+
+Options:
+
+- `--query`: Docspell item query to expose, default `*`.
+- `--limit`: number of items fetched per API request, default `1000`.
+- `--auth-header`: token header, default `X-Docspell-Auth`.
+
+The mount is read-only. File contents are downloaded lazily from `/api/v1/sec/attachment/{id}` when read.