Gute Werkzeuge decken den häufigsten Workflow ab. Sehr gute Werkzeuge lassen Platz für den Workflow, den nur du hast. Das Plugin-System von Nova Navigator macht aus eigenen Skripten echte Dateiaktionen – direkt im Kontextmenü, in der Menüleiste oder hinter einem Tastenkürzel. Die Paperless-ngx-Integration zeigt, wie praktisch das wird: Dokument auswählen, an das eigene Archiv senden, fertig.

Ein Nova-Plugin ist kein isoliertes Skript. Es kennt die ausgewählten Dateien, den aktuellen Ordner, das aktive Pane und auf Wunsch den Remote-Kontext – und kann sein Ergebnis wieder an Nova zurückgeben.

Warum ein Dateimanager ein Plugin-System braucht

Dateien sind selten das Endergebnis eines Workflows. Eine Rechnung soll ins Dokumentenarchiv, ein Bild wird optimiert, ein Build-Artefakt auf den Server übertragen oder eine Prüfsumme an ein Ticket angehängt. Klassische Dateimanager können dafür höchstens eine andere App öffnen. Nova kann die Aktion dort ausführen, wo Auswahl, Pfad und Ziel bereits bekannt sind.

Das ersetzt keine universelle Automatisierungsplattform. Es verkürzt die kleinen, häufigen Abläufe zwischen „Datei gefunden“ und „Aufgabe erledigt“. Ein Plugin kann eine einzelne Aktion kapseln oder mehrere Werkzeuge zu einer nachvollziehbaren Pipeline verbinden.

So arbeiten Plugins in Nova Navigator

Nova unterstützt Plugins in sieben Sprachen: Bash, Python, Ruby, Node.js, Perl, AppleScript und JXA. Damit kannst du die Sprache verwenden, die zu deiner bestehenden Toolchain passt, statt ein proprietäres SDK lernen zu müssen.

Eingaben: vom Dateipfad bis zum JSON-Kontext

Je nach Aufgabe erhält ein Plugin seine Eingaben als Argumente, über Standardinput oder als strukturierten JSON-Kontext. Dieser kann unter anderem ausgewählte Dateien, Metadaten, das aktuelle Verzeichnis sowie den Pane- und Remote-Status enthalten. Eine Aktion kann dadurch lokal und auf entfernten Verbindungen passend reagieren.

Ausgaben, die in den Workflow zurückführen

Ein Plugin kann sein Ergebnis als macOS-Benachrichtigung oder in einem schwebenden Panel zeigen, Text in die Zwischenablage legen, das aktuelle Verzeichnis aktualisieren oder einen erzeugten Pfad direkt in Nova öffnen. So endet die Automatisierung nicht in einem unübersichtlichen Terminal-Log.

Dort starten, wo die Datei liegt

Häufig verwendete Aktionen lassen sich ins Kontextmenü und in die Menüleiste integrieren oder mit einem Tastenkürzel verbinden. Plugins können als ZIP exportiert und importiert werden. Das erleichtert es, einen funktionierenden Ablauf auf einen zweiten Mac oder an ein Team weiterzugeben.

Paperless-ngx direkt aus Nova befüllen

Paperless-ngx ist ein communitygetragenes Open-Source-Dokumentenmanagement. Es archiviert Originaldokumente, erzeugt durchsuchbare Fassungen, führt OCR aus und organisiert Dokumente mit Tags, Korrespondenten, Dokumenttypen, Speicherpfaden und benutzerdefinierten Feldern.

Die Integration passt ideal zum Nova-Plugin-Modell: Du markierst eine oder mehrere PDFs, Bilder oder Office-Dokumente und startest „An Paperless senden“. Das Plugin überträgt die Auswahl über die offizielle REST API an deine eigene Paperless-ngx-Instanz. Paperless übernimmt danach asynchron Verbrauch, Texterkennung und Archivierung.

Dokumente in einem lokalen oder erreichbaren Ordner auswählen.
Die Paperless-Aktion über Kontextmenü oder Tastenkürzel starten.
Optional Titel, Tags, Korrespondent oder Dokumenttyp vorgeben.
Dateien per token-authentifiziertem API-Aufruf hochladen.
Den gestarteten Verarbeitungsauftrag bestätigen lassen.

Technisch nutzt der Upload den von Paperless dokumentierten Endpunkt /api/documents/post_document/. Die offizielle API-Dokumentation beschreibt sowohl den Multipart-Upload als auch die optionale Übergabe von Metadaten. Der Server antwortet zunächst mit einer Task-ID; die eigentliche Dokumentverarbeitung läuft anschließend im Paperless-Consumer.

Nicht nur hochladen: Dokumente direkt vorsortieren

Ein einfacher Upload überlässt Paperless die automatische Klassifikation. Für wiederkehrende Abläufe kann das Plugin bereits bekannte Informationen mitsenden. Das ist besonders nützlich, wenn der Speicherort in Nova eine klare Bedeutung hat.

Nova-Kontext	Mögliche Paperless-Angabe	Beispiel
Dateiname	Titel	„Stromabrechnung 2025“
Gewählte Plugin-Aktion	Dokumenttyp	Rechnung, Vertrag oder Beleg
Aktueller Ordner	Tag oder Speicherpfad	Finanzen, Haus oder Projektname
Dialogauswahl	Korrespondent	Energieversorger oder Versicherung
Datei-Metadaten	Erstellungsdatum	Datum des Scans oder Dokuments

Paperless kann weiterhin selbst Regeln und automatische Zuordnungen anwenden. Vom Plugin gesetzte Angaben sind kein Zwang, sondern eine Abkürzung für Informationen, die im Moment der Ablage bereits feststehen.

Alternative ohne API: das Consumption-Verzeichnis

Paperless-ngx kann außerdem ein festgelegtes Consumption-Verzeichnis überwachen. Neue Dateien in diesem Ordner werden vom Consumer aufgenommen und anschließend aus dem Eingangsordner entfernt. Die Paperless-Nutzungsdokumentation beschreibt diesen Ablauf ausdrücklich.

Wenn der Consume-Ordner deines Servers über SMB, NFS oder SFTP erreichbar ist, kann Nova Dokumente auch mit seiner normalen Transfer-Engine dorthin kopieren. Diese Variante ist einfach und benötigt keinen API-Aufruf. Der direkte API-Workflow ist komfortabler, sobald Metadaten mitgesendet oder der Verarbeitungsauftrag nachvollzogen werden soll.

Berechtigungen, Tokens und nachvollziehbare Aktionen

Plugins werden in Nova nicht still im Hintergrund aktiv. Vor der Ausführung ist eine Genehmigung erforderlich. Für eine Paperless-Anbindung sollte ein API-Token verwendet und sicher außerhalb des eigentlichen Skripttexts gespeichert werden. Paperless unterstützt Token-Authentifizierung; der Server muss für den Mac erreichbar sein und sollte bei Zugriff über ein nicht vertrauenswürdiges Netzwerk per HTTPS geschützt werden.

Der große Vorteil einer selbst gehosteten Kombination bleibt erhalten: Nova sendet das Dokument an genau die Paperless-Instanz, die du konfiguriert hast. Es ist kein zusätzlicher Nova-Clouddienst zwischengeschaltet. Welche Daten verarbeitet und gespeichert werden, bestimmen dein Plugin und deine Paperless-Konfiguration.

Was sich noch als Nova-Plugin anbietet

Paperless ist nur ein Beispiel. Über denselben Mechanismus lassen sich viele dateinahe Aufgaben abbilden:

Bilder komprimieren, skalieren oder Metadaten entfernen,
Prüfsummen erzeugen und mit einer Release-Datei vergleichen,
ausgewählte Dateien an ein Deployment- oder Backup-Skript übergeben,
Metadaten als JSON exportieren oder an eine interne API senden,
Dokumente nach eigener Logik umbenennen und taggen,
Projektdateien prüfen und das Ergebnis in einem Nova-Panel anzeigen.

Das Plugin-System macht Nova damit nicht zu einer abgeschlossenen Funktionssammlung, sondern zu einem anpassbaren Arbeitsplatz. Paperless-ngx zeigt den Nutzen besonders deutlich: Aus „Datei ablegen“ wird eine einzige Aktion, die ein durchsuchbares, strukturiertes Dokumentenarchiv befüllt.

Mehr zu selbst gehosteten Speichern findest du in unserem Beitrag über Nova und offene Systeme. Einen breiteren Überblick über Automatisierung, Remote-Dateien und Entwicklerwerkzeuge bietet der Vergleich mit Path Finder.