Ce que fait b64
b64 transforme des octets en texte Base64, et inversement. Passez-lui le texte en argument, envoyez-lui des données par un pipe ou indiquez-lui un fichier avec -i. L’encodage affiche le résultat suivi d’un saut de ligne ; le décodage écrit les octets bruts et rien d’autre, si bien que les fichiers binaires ressortent intacts.
$ b64 "Hello, hub!"
SGVsbG8sIGh1YiE=
$ b64 -d SGVsbG8sIGh1YiE=
Hello, hub!
$ printf '\xfb\xff\xbf' | b64 --url
-_-_
$ b64 --url --no-pad "Привет"
0J_RgNC40LLQtdGC
Les deux dernières commandes montrent l’alphabet URL-safe (- et _ au lieu de + et /) et une sortie sans remplissage =, la forme utilisée dans les JWT et les URL. Base64 ou Base64URL explique la différence.
Installation
Le bloc d’installation ci-dessus propose une commande pour chaque gestionnaire de paquets. En résumé :
| Plateforme | Commande |
|---|---|
| macOS, Linux (Homebrew) | brew install base64hub-com/tap/b64 |
| Windows (winget) | winget install base64hub.b64 |
| Windows (Scoop) | scoop bucket add base64hub https://github.com/base64hub-com/homebrew-tap, puis scoop install b64 |
| Arch Linux (AUR) | yay -S b64-bin |
| N’importe quel shell Unix | curl -fsSL https://base64hub.com/install.sh | sh |
| Avec Node.js ou Python | npm i -g base64hub ou pipx install base64hub |
| Avec Go | go install github.com/base64hub-com/base64hub-cli/cmd/b64@latest |
Pour un simple téléchargement, Tous les téléchargements propose des archives .tar.gz et .zip et des paquets .deb pour x86_64 et arm64, avec un fichier SHA256SUMS pour les vérifier. Les versions npm et PyPI installent la même commande b64, avec les mêmes options.
Exemples du quotidien
Attention au saut de ligne : echo en ajoute un, et b64 encode chaque octet qu’il reçoit.
$ echo hello | b64
aGVsbG8K
$ printf 'hello' | b64
aGVsbG8=
Pour couper une sortie longue, par exemple à 76 caractères pour MIME, utilisez -w :
$ printf 'foobar' | b64 -w 4
Zm9v
YmFy
Pour construire une data URI : le type MIME est détecté d’après le contenu (PNG, JPEG, GIF, WebP, PDF, SVG, texte) ou fixé avec -m :
$ printf 'Hi' | b64 --data-uri
data:text/plain;charset=utf-8;base64,SGk=
$ b64 --data-uri -i logo.png -o logo.txt
Vérifiez une chaîne avant de vous y fier. Pour une entrée non valide, le verdict part sur la sortie d’erreur avec le code de sortie 1. Une chaîne qui commence par - doit être précédée de -- pour ne pas être lue comme une option :
$ b64 --validate -- -_-_
valid (url, 3 bytes)
$ b64 --validate 'Zm9vY'
invalid: invalid length: 5 characters leave a single character in the last group
$ b64 -d 'Zm9v!'
b64: invalid character '!' at position 4
b64 ou la commande base64
Linux fournit le base64 de GNU coreutils, macOS une version BSD, et leurs options diffèrent (voir Base64 en Bash pour le détail). b64 se comporte de la même façon sur tous les systèmes. La colonne GNU ci-dessous a été vérifiée avec coreutils 9.7.
| Tâche | base64 GNU | b64 |
|---|---|---|
| Longueur des lignes en sortie | coupe à 76 sauf avec -w 0 | une seule ligne sauf avec -w N |
| Alphabet URL-safe | non (basenc --base64url le permet) | -u / --url |
Décoder une entrée avec - ou _ | base64: invalid input | acceptée |
URI data: en entrée ou en sortie | non | --data-uri ; le préfixe est retiré au décodage |
| Vérifier une chaîne | non | --validate, avec variante et nombre d’octets |
| Détail des erreurs | invalid input | le caractère fautif et sa position |
Le décodage de b64 est volontairement tolérant : espaces, tabulations et sauts de ligne sont ignorés, le remplissage est facultatif et les deux alphabets sont acceptés. Tout le reste, comme un ! égaré ou un = au milieu, est une erreur avec le code de sortie 1. Les erreurs d’utilisation sortent avec le code 2 : un script distingue ainsi des données invalides d’une ligne de commande erronée.
Fonctionne hors ligne
b64 travaille sur votre machine et n’a besoin ni de compte ni de connexion réseau. La version Go lit l’entrée standard par blocs, ce qui garde une consommation mémoire constante même sur des entrées de plusieurs gigaoctets. Pour une chaîne ponctuelle dans le navigateur, il y a l’encodeur Base64 et le décodeur de ce site ; la documentation de la CLI détaille chaque option et chaque code de sortie.
FAQ
Comment installer un outil Base64 en ligne de commande avec Homebrew ?
Lancez brew install base64hub-com/tap/b64. La formule se trouve dans le tap base64hub-com/tap et installe la commande b64 sous macOS et Linux.
b64 peut-il remplacer directement la commande base64 ?
Non, les options diffèrent. b64 ne coupe pas les lignes sauf si vous passez -w, décode avec -d sur tous les systèmes et ajoute la sortie URL-safe, les data URI et la validation. Gardez base64 dans les scripts qui dépendent de son comportement exact.
Comment encoder un fichier en Base64 en ligne de commande ?
b64 -i photo.jpg -o photo.b64, ou b64 < photo.jpg > photo.b64. Ajoutez --data-uri pour obtenir une chaîne data:image/jpeg;base64,… à coller dans du HTML ou du CSS.
Pourquoi b64 affiche-t-il « valid (either, …) » ?
La chaîne ne contient aucun des caractères + / - _ : elle est donc valide à la fois dans l’alphabet standard et dans l’alphabet URL-safe. standard, url et mixed apparaissent quand ces caractères sont présents.