Charger un fichier
  1. base64hub
  2. Docs
  3. CLI

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éthodeCommande
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’installationcurl -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

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

OptionRôle
-d, --decodeDécode le Base64 en octets bruts.
-u, --urlEncode avec l’alphabet URL-safe (- et _).
-n, --no-padEncode sans remplissage =.
-w N, --wrap NCoupe la sortie encodée tous les N caractères ; 0 (par défaut) ne coupe pas, 76 correspond à MIME.
--data-uriEncode sous forme d’URI data: ; le type MIME est détecté d’après le contenu.
-m TYPE, --mime TYPEType MIME pour --data-uri.
--validateVérifie l’entrée et indique sa variante et sa taille décodée.
-i FILE, --input FILELit 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, --helpAffiche l’aide.
-v, --versionAffiche 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 : -dn est une option inconnue. Les valeurs se placent après une espace (-w 4) ou, pour les options longues, après = (--wrap=4) ; -w4 n’est pas accepté.
  • -u, -n, -w et --data-uri ne s’appliquent qu’à l’encodage ; avec -d ou --validate, ce sont des erreurs d’utilisation.
  • -d et --validate ne peuvent pas être combinés.
  • --data-uri utilise toujours l’alphabet standard avec remplissage, sur une seule ligne : -u, -n et -w ne peuvent donc pas l’accompagner.
  • --mime nécessite --data-uri.
  • TEXT et -i ne 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

CodeSignification
0Succès.
1Entrée invalide, ou fichier impossible à lire ou à écrire.
2Erreur 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