Référence de la CLI b64
b64 encode, décode et valide du Base64. Cette page liste chaque option, les règles pour les combiner, et ce que la commande affiche et renvoie.
Installation
| Méthode | Commande |
|---|---|
| Homebrew (macOS, Linux) | brew install base64hub-com/tap/b64 |
| Scoop (Windows) | scoop bucket add base64hub https://github.com/base64hub-com/homebrew-tap, puis scoop install b64 |
| winget (Windows) | winget install base64hub.b64 |
| AUR (Arch Linux) | yay -S b64-bin |
| Script d’installation | 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 |
Les archives de version pour macOS, Linux et Windows sur x86_64 et arm64, les paquets .deb et un fichier SHA256SUMS se trouvent sur la page de téléchargement. Vérifiez l’installation avec b64 --version, qui affiche b64 1.0.0.
Les versions npm et pipx sont la même commande, avec les mêmes options et les mêmes messages. Seule différence : la version Go lit l’entrée standard en flux, par blocs, alors que les versions npm et Python chargent d’abord toute l’entrée en mémoire.
Utilisation
b64 [flags] [TEXT]
Avec TEXT, b64 travaille sur les octets UTF-8 de TEXT, sans ajouter de saut de ligne. Sans TEXT, il lit l’entrée standard jusqu’au bout, ou le fichier indiqué avec -i. Les options peuvent se placer avant ou après TEXT.
L’encodage affiche le Base64 suivi d’un saut de ligne. Le décodage écrit les octets bruts et rien d’autre : la sortie de b64 -d peut donc être un fichier binaire.
Options
| Option | Rôle |
|---|---|
-d, --decode | Décode le Base64 en octets bruts. |
-u, --url | Encode avec l’alphabet URL-safe (- et _). |
-n, --no-pad | Encode sans remplissage =. |
-w N, --wrap N | Coupe la sortie encodée tous les N caractères ; 0 (par défaut) ne coupe pas, 76 correspond à MIME. |
--data-uri | Encode sous forme d’URI data: ; le type MIME est détecté d’après le contenu. |
-m TYPE, --mime TYPE | Type MIME pour --data-uri. |
--validate | Vérifie l’entrée et indique sa variante et sa taille décodée. |
-i FILE, --input FILE | Lit FILE au lieu de l’entrée standard ; - désigne l’entrée standard. |
-o FILE, --output FILE | Écrit dans FILE au lieu de la sortie standard ; - désigne la sortie standard. |
-h, --help | Affiche l’aide. |
-v, --version | Affiche b64 et le numéro de version. |
-- | Fin des options : l’argument suivant est TEXT, même s’il commence par -. |
Règles de combinaison des options
- Les options courtes ne se regroupent pas :
-dnest une option inconnue. Les valeurs se placent après une espace (-w 4) ou, pour les options longues, après=(--wrap=4) ;-w4n’est pas accepté. -u,-n,-wet--data-urine s’appliquent qu’à l’encodage ; avec-dou--validate, ce sont des erreurs d’utilisation.-det--validatene peuvent pas être combinés.--data-uriutilise toujours l’alphabet standard avec remplissage, sur une seule ligne :-u,-net-wne peuvent donc pas l’accompagner.--mimenécessite--data-uri.- TEXT et
-ine peuvent pas être utilisés ensemble, et un seul TEXT est autorisé : mettez entre guillemets un texte qui contient des espaces. - Un TEXT qui commence par
-, comme du Base64 URL-safe, doit être précédé de--:b64 -d -- -_-_.
Codes de sortie et messages
| Code | Signification |
|---|---|
0 | Succès. |
1 | Entrée invalide, ou fichier impossible à lire ou à écrire. |
2 | Erreur d’utilisation : option inconnue, valeur incorrecte ou options incompatibles. |
Les erreurs partent sur la sortie d’erreur sous la forme b64: <message>. --validate affiche valid (<variant>, <bytes> bytes) sur la sortie standard pour une entrée valide, et sinon invalid: <reason> sur la sortie d’erreur avec le code de sortie 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
Les positions sont comptées à partir de 0 dans l’entrée, une fois les espaces, tabulations et sauts de ligne retirés.
Exemples
Encoder et décoder du texte :
$ b64 "Hello, hub!"
SGVsbG8sIGh1YiE=
$ b64 -d SGVsbG8sIGh1YiE=
Hello, hub!
URL-safe, avec et sans remplissage :
$ printf '\xfb\xff\xbf' | b64 --url
-_-_
$ b64 --url --no-pad "Привет"
0J_RgNC40LLQtdGC
$ b64 -n f
Zg
Couper les lignes ; notez aussi que echo ajoute un saut de ligne, qui est encodé lui aussi :
$ b64 -w 4 foobar
Zm9v
YmFy
$ echo hello | b64
aGVsbG8K
Data URI, avec type détecté ou explicite :
$ 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
Le décodage est tolérant : sauts de ligne, préfixe data: et remplissage manquant sont acceptés, et une chaîne qui commence par - se place après -- :
$ b64 -d 'data:text/plain;base64,SGk='
Hi
$ b64 -d -- -_-_ | xxd -p
fbffbf
Valider dans un script :
$ 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
Fichiers en entrée et en sortie :
b64 -i photo.jpg -o photo.b64
b64 -d -i photo.b64 -o photo-copy.jpg
Types MIME détectés
Sans --mime, --data-uri examine les premiers octets : PNG, JPEG, GIF, WebP et PDF d’après leur signature, et SVG quand le texte commence par <svg, ou par <?xml et contient <svg. Tout autre texte UTF-8 valide sans caractères de contrôle (tabulation, CR et LF sont acceptés) devient text/plain;charset=utf-8 ; tout le reste, application/octet-stream.
Mis à jour 22 nov. 2026