QR-Code per Kommandozeile: Die sameqr-CLI installieren und nutzen

Warum die Kommandozeile

Eine CLI (Command Line Interface) ist ein Programm, das du über Textbefehle im Terminal bedienst. Ein Befehl lässt sich wiederholen, in ein Skript schreiben, mit anderen Werkzeugen verketten und von einem Coding-Agent ausführen. Die sameqr-CLI bringt Same-QR genau dorthin. Sie hat keine weiteren Abhängigkeiten und braucht nur Node.js ab Version 18.

Schritt 1: Installieren

Die CLI kommt über npm, den Paketmanager von Node.js:

npm install -g sameqr
sameqr --version

Schritt 2: API-Schlüssel anlegen

Im Dashboard unter Konto findest du den Abschnitt „Zugang für CLI, Skripte und Agenten“. Leg dort einen Schlüssel an. Für den Anfang reicht „lesen + schreiben“: anlegen, Namen und Texte ändern. Wer auch Ziele bestehender Codes ändern, Seiten offline nehmen oder löschen will, wählt „voll“. Er beginnt mit sqr_live_ und wird nur einmal angezeigt. Speichere ihn sofort in deinem Passwortmanager.

Schritt 3: Anmelden

Der Schlüssel wird nie als Argument übergeben, sonst stünde er in der Shell-Historie. „sameqr login“ fragt ihn verdeckt ab, prüft ihn und speichert ihn nur für dich lesbar in ~/.config/sameqr/config.json. Alternativ setzt du die Umgebungsvariable SAMEQR_API_KEY, die immer Vorrang hat.

sameqr login
sameqr whoami

„sameqr whoami“ zeigt dein Konto, den Tarif und wie viele Codes du anlegen kannst.

Schritt 4: Den ersten Code anlegen

sameqr qr create --name "Speisekarte Tische" --url https://example.com/karte
sameqr qr list
sameqr qr update <id> --url https://example.com/winterkarte
sameqr qr stats <id>

Mit --slug legst du beim Anlegen einen eigenen Kurzlink fest, mit --label hängst du Labels an. Ihre Kennungen zeigt „sameqr labels list“. Ziel ändern, offline nehmen und löschen brauchen einen Schlüssel „voll“. Die CLI fragt dann im Terminal nach, in Skripten ohne Terminal geht es nur mit ausdrücklichem --yes. Über die API sind höchstens 10 solcher Änderungen je Stunde und 30 je Tag möglich.

Schritt 5: Gastseiten und Speisekarten

sameqr seite create --vorlage speisekarte --name "Gasthof zum Löwen"
sameqr karte import karte-1.jpg karte-2.jpg --seite menu/gasthof-zum-loewen
sameqr seite publish menu/gasthof-zum-loewen
sameqr qr create --name "Tischaufsteller" --seite menu/gasthof-zum-loewen

„seite create“ gibt die Adresse der neuen Seite aus, im Beispiel menu/gasthof-zum-loewen. Die brauchst du für die folgenden Befehle. Die Seite entsteht als Entwurf. „karte import“ liest die Fotos per KI ein und hängt die erkannten Gruppen an die Seite an, ohne etwas zu überschreiben. Sieh den Entwurf durch, bevor du veröffentlichst. Zum Veröffentlichen müssen die Betreiberangaben ausgefüllt sein. Der letzte Befehl legt einen Code an, der direkt auf die Seite zeigt. Weitere Vorlagen: preisliste, zeiten, links, aktion, weingut, etikett und kontakt.

Schritt 6: In Skripten mit --json

Hängst du --json an einen Befehl, kommt die Antwort als JSON. Fehler landen dann ebenfalls als JSON auf der Fehlerausgabe, und der Rückgabewert verrät die Art: 3 heißt nicht angemeldet, 4 fehlende Rechte, 2 eine falsche Eingabe. So reagiert ein Skript gezielt, statt Text zu deuten.

sameqr qr list --json

Fazit: Warum Same-QR

Die sameqr-CLI bringt den vollen Funktionsumfang von Same-QR ins Terminal: Codes, Statistik, Gastseiten, Speisekarten aus Fotos, Labels und Projekte. Sie ist schlank, behandelt deinen Schlüssel sorgfältig und spricht JSON für Skripte und Coding-Agents. Und sie funktioniert in jedem Tarif.

Leg gleich los: Registriere dich kostenlos auf sameqr.com, zwei dynamische QR-Codes sind dauerhaft gratis. API, CLI und MCP-Server gibt es in jedem Tarif, die Dokumentation steht auf sameqr.com/entwickler.

Häufig gestellte Fragen