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
| Methode | Befehl |
|---|---|
| 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 |
| Installationsskript | curl -fsSL https://base64hub.com/install.sh | sh |
| npm | npm i -g base64hub |
| pipx | pipx install base64hub |
| Go | go 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
| Flag | Bedeutung |
|---|---|
-d, --decode | Base64 in rohe Bytes dekodieren. |
-u, --url | Mit dem URL-sicheren Alphabet (- und _) kodieren. |
-n, --no-pad | Ohne =-Padding kodieren. |
-w N, --wrap N | Kodierte Ausgabe nach je N Zeichen umbrechen; 0 (Standard) bedeutet kein Umbruch, 76 ist MIME. |
--data-uri | Als data:-URI kodieren; der MIME-Typ wird am Inhalt erkannt. |
-m TYPE, --mime TYPE | MIME-Typ für --data-uri. |
--validate | Die Eingabe prüfen und Variante und dekodierte Größe melden. |
-i FILE, --input FILE | FILE statt der Standardeingabe lesen; - steht für die Standardeingabe. |
-o FILE, --output FILE | FILE statt der Standardausgabe schreiben; - steht für die Standardausgabe. |
-h, --help | Die Hilfe anzeigen. |
-v, --version | b64 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:
-dnist eine unbekannte Option. Werte folgen nach einem Leerzeichen (-w 4) oder bei langen Flags nach=(--wrap=4);-w4wird nicht akzeptiert. -u,-n,-wund--data-urigelten nur fürs Kodieren; mit-doder--validatesind sie Aufruffehler.-dund--validatelassen sich nicht kombinieren.--data-uriverwendet immer das Standardalphabet mit Padding in einer Zeile,-u,-nund-wlassen sich daher nicht damit kombinieren.--mimesetzt--data-urivoraus.- TEXT und
-ilassen 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
| Code | Bedeutung |
|---|---|
0 | Erfolg. |
1 | Ungültige Eingabe, oder eine Datei konnte nicht gelesen oder geschrieben werden. |
2 | Aufruffehler: 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