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
-
Melden Sie sich an. Geben Sie dabei die Adresse an, unter der Sie Librario im Browser öffnen:
librario login --host <ihre-firma>.mylibrar.ioDie 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.
-
Listen Sie Publikationen auf, hier mit einem Suchbegriff:
librario publications list -q "Brandschutz" -
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 offspeichert die Einstellung dauerhaft.librario telemetry statuszeigt den aktuellen Stand,librario telemetry onschaltet 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.