Zum Inhalt springen
Dokumentation
Als Markdown ansehen

Kommandozeile (librario CLI)

Die librario CLI bringt Ihre Bibliothek in das Terminal. Sie suchen Publikationen, legen Datensätze an, laden PDFs hoch und erstellen eine vollständige Sicherung Ihres Kontos, ohne den Browser zu öffnen. Weil jeder Befehl Text oder JSON ausgibt, eignet sich die CLI auch für Skripte und für KI-Agenten, die im Terminal arbeiten.

Die CLI arbeitet über die REST-API und im Namen der angemeldeten Person: Sie sieht und ändert genau das, was diese Person auch in der Web-Oberfläche sehen und ändern darf.

Installieren

Die CLI ist eine einzelne Programmdatei für Windows (64 Bit), macOS (Apple Silicon) und Linux (64 Bit, x86 und ARM). Das Installationsskript lädt die aktuelle Version, prüft ihre Prüfsumme und legt sie in Ihrem Benutzerverzeichnis ab. Administratorrechte brauchen Sie dafür nicht.

Windows

Öffnen Sie PowerShell und führen Sie aus:

irm https://www.librario.de/install.ps1 | iex

Das Skript installiert die CLI nach %LOCALAPPDATA%\Programs\librario und trägt dieses Verzeichnis in Ihren Benutzer-PATH ein. Der Befehl librario funktioniert sofort in diesem Fenster und in jedem neuen.

macOS und Linux

Öffnen Sie ein Terminal und führen Sie aus:

curl -fsSL https://www.librario.de/install.sh | bash

Das Skript installiert die CLI nach ~/.local/bin, dazu die Befehlsvervollständigung für bash, zsh und fish sowie die Handbuchseiten (man librario). Findet Ihr Terminal librario danach nicht, nehmen Sie ~/.local/bin in Ihren PATH auf; die letzte Meldung des Skripts zeigt die Zeile, die Sie dafür eintragen.

Für Intel-Macs gibt es keine eigene Version.

Manuell herunterladen

Wer kein Installationsskript ausführen möchte, lädt das Archiv für sein System direkt herunter:

System Download
Windows (64 Bit) librario_windows_amd64.zip
macOS (Apple Silicon) librario_darwin_arm64.tar.gz
Linux (64 Bit, x86) librario_linux_amd64.tar.gz
Linux (64 Bit, ARM) librario_linux_arm64.tar.gz

Entpacken Sie das Archiv und legen Sie librario (unter Windows librario.exe) in ein Verzeichnis, das in Ihrem PATH steht.

Download prüfen

Zu jeder Version gehört die Datei checksums.txt mit den SHA-256-Prüfsummen aller Archive. Laden Sie sie in dasselbe Verzeichnis wie das Archiv und vergleichen Sie:

# Linux
sha256sum --ignore-missing -c checksums.txt
# macOS
shasum -a 256 --ignore-missing -c checksums.txt

Unter Windows zeigt PowerShell die Prüfsumme des Archivs an; sie muss mit der Zeile für librario_windows_amd64.zip in checksums.txt übereinstimmen:

Get-FileHash .\librario_windows_amd64.zip -Algorithm SHA256

Die Installationsskripte führen diese Prüfung selbst aus und brechen ab, wenn die Prüfsumme nicht passt.

Hinweise zu Windows und macOS

Die CLI ist nicht mit einem Code-Signing-Zertifikat signiert. Je nach Weg auf Ihren Rechner meldet sich deshalb das Betriebssystem.

  • Windows SmartScreen: Haben Sie das Archiv im Browser heruntergeladen, erscheint beim ersten Start der Hinweis Der Computer wurde durch Windows geschützt. Klicken Sie auf Weitere Informationen und dann auf Trotzdem ausführen. Das Installationsskript für PowerShell löst diesen Hinweis nicht aus.
  • Windows Smart App Control: Auf manchen neu eingerichteten Windows-11-Rechnern blockiert Smart App Control unsignierte Programme, ohne eine Ausnahme anzubieten. Auf verwalteten Firmenrechnern ist diese Funktion meist ausgeschaltet. Melden Sie sich bei uns, wenn Sie davon betroffen sind.
  • Firmenrichtlinien: Wenn Ihre IT Programme über AppLocker, App Control for Business oder eine ähnliche Richtlinie freigibt, muss sie die CLI erst zulassen, zum Beispiel über die Prüfsumme der Datei oder den Installationspfad.
  • macOS Gatekeeper: Haben Sie das Archiv im Browser heruntergeladen, verweigert macOS beim ersten Start die Ausführung. Entfernen Sie die Quarantäne-Markierung mit xattr -d com.apple.quarantine ./librario. Das Installationsskript ist davon nicht betroffen.

Erste Schritte

  1. Melden Sie sich an. Geben Sie dabei die Adresse an, unter der Sie Librario im Browser öffnen:

    librario login --host <ihre-firma>.mylibrar.io
    

    Die CLI öffnet Ihren Browser. Dort melden Sie sich wie gewohnt an und stimmen der Verbindung zu. Danach liegt der Zugang im Schlüsselbund Ihres Betriebssystems (unter Windows in der Anmeldeinformationsverwaltung), nicht in einer Datei.

  2. Listen Sie Publikationen auf, hier mit einem Suchbegriff:

    librario publications list -q "Brandschutz"
    
  3. Lassen Sie sich alle Befehle zeigen. Jeder Befehl erklärt seine Optionen mit --help:

    librario --help
    librario publications list --help
    

Die Verbindung der CLI erscheint auf Ihrer Seite Integrationen unter Verbundene Anwendungen. Dort können Sie sie jederzeit widerrufen, wie unter Verbindungen verwalten und widerrufen beschrieben.

Telemetrie

Die CLI sendet Nutzungsdaten an AppSignal (Rechenzentrum in der EU), damit wir Fehler und langsame Befehle früh bemerken. Beim ersten Start weist die CLI einmalig darauf hin.

  • Übertragen werden: der Befehl (etwa publications list), die Version der CLI, Betriebssystem und Prozessorarchitektur, die Dauer, die Art des Ergebnisses (Erfolg oder Fehlerklasse), pro Anfrage an Librario die HTTP-Methode, der Pfad der Anfrage ohne IDs und der Statuscode, eine zufällige Anfrage-ID, mit der unser Support einen fehlgeschlagenen Aufruf in den Serverprotokollen wiederfindet, und die Adresse Ihrer Bibliothek (etwa <ihre-firma>.mylibrar.io).
  • Nie übertragen werden: Argumente und Optionen, Suchbegriffe, IDs von Datensätzen, Inhalte von Anfragen und Antworten, Zugangsdaten, der Name Ihres Rechners, Ihr Benutzername und Dateipfade.

So schalten Sie die Telemetrie aus, jede Variante genügt für sich:

  • librario telemetry off speichert die Einstellung dauerhaft. librario telemetry status zeigt den aktuellen Stand, librario telemetry on schaltet sie wieder ein.
  • Die Umgebungsvariable LIBRARIO_TELEMETRY_DISABLED=1
  • Die Umgebungsvariable DO_NOT_TRACK=1

Die CLI funktioniert auch ohne Internetverbindung zum Telemetrie-Dienst vollständig. Ein fehlgeschlagener Versand ändert nie das Ergebnis eines Befehls.

Aktualisieren

Führen Sie das Installationsskript erneut aus. Es ersetzt die installierte Version durch die aktuelle.