Datei hochladen
  1. base64hub
  2. Doku
  3. CLI

b64-CLI-Referenz

b64 kodiert, dekodiert und prüft Base64. Diese Seite listet jedes Flag, die Regeln für ihre Kombination und was der Befehl ausgibt und zurückgibt.

Installation

MethodeBefehl
Homebrew (macOS, Linux)brew install base64hub-com/tap/b64
Scoop (Windows)scoop bucket add base64hub https://github.com/base64hub-com/homebrew-tap, dann scoop install b64
winget (Windows)winget install base64hub.b64
AUR (Arch Linux)yay -S b64-bin
Installationsskriptcurl -fsSL https://base64hub.com/install.sh | sh
npmnpm i -g base64hub
pipxpipx install base64hub
Gogo install github.com/base64hub-com/base64hub-cli/cmd/b64@latest

Release-Archive für macOS, Linux und Windows auf x86_64 und arm64, .deb-Pakete und eine Datei SHA256SUMS finden Sie auf der Download-Seite. Prüfen Sie die Installation mit b64 --version, das b64 1.0.0 ausgibt.

Die Builds aus npm und pipx sind derselbe Befehl mit denselben Flags und Meldungen. Der einzige Unterschied: Der Go-Build streamt die Standardeingabe in Blöcken, während die Builds für npm und Python die gesamte Eingabe zuerst in den Speicher lesen.

Aufruf

b64 [flags] [TEXT]

Mit TEXT arbeitet b64 auf den UTF-8-Bytes von TEXT, ohne angehängten Zeilenumbruch. Ohne TEXT liest es die Standardeingabe bis zum Ende oder die mit -i angegebene Datei. Flags dürfen vor oder nach TEXT stehen.

Beim Kodieren gibt es das Base64 gefolgt von einem Zeilenumbruch aus. Beim Dekodieren schreibt es die rohen Bytes und sonst nichts, die Ausgabe von b64 -d kann also eine Binärdatei sein.

Flags

FlagBedeutung
-d, --decodeBase64 in rohe Bytes dekodieren.
-u, --urlMit dem URL-sicheren Alphabet (- und _) kodieren.
-n, --no-padOhne =-Padding kodieren.
-w N, --wrap NKodierte Ausgabe nach je N Zeichen umbrechen; 0 (Standard) bedeutet kein Umbruch, 76 ist MIME.
--data-uriAls data:-URI kodieren; der MIME-Typ wird am Inhalt erkannt.
-m TYPE, --mime TYPEMIME-Typ für --data-uri.
--validateDie Eingabe prüfen und Variante und dekodierte Größe melden.
-i FILE, --input FILEFILE statt der Standardeingabe lesen; - steht für die Standardeingabe.
-o FILE, --output FILEFILE statt der Standardausgabe schreiben; - steht für die Standardausgabe.
-h, --helpDie Hilfe anzeigen.
-v, --versionb64 und die Version ausgeben.
--Ende der Flags: Das nächste Argument ist TEXT, auch wenn es mit - beginnt.

Regeln für die Kombination von Flags

  • Kurze Flags lassen sich nicht bündeln: -dn ist eine unbekannte Option. Werte folgen nach einem Leerzeichen (-w 4) oder bei langen Flags nach = (--wrap=4); -w4 wird nicht akzeptiert.
  • -u, -n, -w und --data-uri gelten nur fürs Kodieren; mit -d oder --validate sind sie Aufruffehler.
  • -d und --validate lassen sich nicht kombinieren.
  • --data-uri verwendet immer das Standardalphabet mit Padding in einer Zeile, -u, -n und -w lassen sich daher nicht damit kombinieren.
  • --mime setzt --data-uri voraus.
  • TEXT und -i lassen sich nicht zusammen verwenden, und es ist nur ein TEXT erlaubt: Setzen Sie Text mit Leerzeichen in Anführungszeichen.
  • TEXT, der mit - beginnt, etwa URL-sicheres Base64, braucht -- davor: b64 -d -- -_-_.

Exit-Codes und Meldungen

CodeBedeutung
0Erfolg.
1Ungültige Eingabe, oder eine Datei konnte nicht gelesen oder geschrieben werden.
2Aufruffehler: unbekanntes Flag, falscher Wert oder Flags, die sich nicht kombinieren lassen.

Fehler gehen als b64: <message> auf die Standardfehlerausgabe. --validate gibt bei gültiger Eingabe valid (<variant>, <bytes> bytes) auf der Standardausgabe aus, andernfalls invalid: <reason> auf der Standardfehlerausgabe mit Exit-Code 1.

$ b64 -d 'Zm9v!'
b64: invalid character '!' at position 4
$ b64 -d 'Zm=9v'
b64: unexpected '=' at position 2: padding is only allowed at the end
$ b64 -d 'Zg==='
b64: too much padding: 3 '=' at position 2, at most 2 are allowed
$ b64 -d 'Zm9vY'
b64: invalid length: 5 characters leave a single character in the last group
$ b64 -d -u Zm9v
b64: --url only applies to encoding, not to --decode

Positionen zählen ab 0 in der Eingabe, nachdem Leerzeichen, Tabs und Zeilenumbrüche entfernt wurden.

Beispiele

Text kodieren und dekodieren:

$ b64 "Hello, hub!"
SGVsbG8sIGh1YiE=
$ b64 -d SGVsbG8sIGh1YiE=
Hello, hub!

URL-sicher, mit und ohne Padding:

$ printf '\xfb\xff\xbf' | b64 --url
-_-_
$ b64 --url --no-pad "Привет"
0J_RgNC40LLQtdGC
$ b64 -n f
Zg

Zeilen umbrechen; beachten Sie, dass echo einen Zeilenumbruch anhängt, der mitkodiert wird:

$ b64 -w 4 foobar
Zm9v
YmFy
$ echo hello | b64
aGVsbG8K

Data-URIs, mit erkanntem oder explizit angegebenem Typ:

$ b64 --data-uri Hello
data:text/plain;charset=utf-8;base64,SGVsbG8=
$ b64 --data-uri -m text/csv 'a,b'
data:text/csv;base64,YSxi
$ b64 --data-uri -i logo.png -o logo.txt

Das Dekodieren ist tolerant: Zeilenumbrüche, ein data:-Präfix und fehlendes Padding werden akzeptiert, und ein String, der mit - beginnt, kommt hinter --:

$ b64 -d 'data:text/plain;base64,SGk='
Hi
$ b64 -d -- -_-_ | xxd -p
fbffbf

In einem Skript prüfen:

$ b64 --validate SGVsbG8sIGh1YiE=
valid (either, 11 bytes)
$ b64 --validate 'a+b_'
valid (mixed, 3 bytes)
if b64 --validate -i token.txt >/dev/null 2>&1; then
  echo "token looks like Base64"
else
  echo "token is broken" >&2
fi

Dateien als Ein- und Ausgabe:

b64 -i photo.jpg -o photo.b64
b64 -d -i photo.b64 -o photo-copy.jpg

Erkannte MIME-Typen

--data-uri ohne --mime sieht sich die ersten Bytes an: PNG, JPEG, GIF, WebP und PDF anhand ihrer Signaturen, SVG, wenn der Text mit <svg beginnt oder mit <?xml beginnt und <svg enthält. Anderer gültiger UTF-8-Text ohne Steuerzeichen (Tab, CR und LF sind erlaubt) wird zu text/plain;charset=utf-8, alles andere zu application/octet-stream.

Aktualisiert 22.11.2026