O que o b64 faz
O b64 transforma bytes em texto Base64 e vice-versa. Passe o texto como argumento, mande os dados por um pipe ou aponte para um arquivo com -i. A codificação imprime o resultado e uma quebra de linha; a decodificação escreve os bytes puros e nada mais, então arquivos binários saem intactos.
$ b64 "Hello, hub!"
SGVsbG8sIGh1YiE=
$ b64 -d SGVsbG8sIGh1YiE=
Hello, hub!
$ printf '\xfb\xff\xbf' | b64 --url
-_-_
$ b64 --url --no-pad "Привет"
0J_RgNC40LLQtdGC
As duas últimas linhas mostram o alfabeto URL-safe (- e _ no lugar de + e /) e uma saída sem o preenchimento =, o formato usado em JWTs e URLs. Base64 vs Base64URL explica a diferença.
Instalação
A caixa de instalação acima tem um comando para cada gerenciador de pacotes. Em resumo:
| Plataforma | Comando |
|---|---|
| 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, depois scoop install b64 |
| Arch Linux (AUR) | yay -S b64-bin |
| Qualquer shell Unix | curl -fsSL https://base64hub.com/install.sh | sh |
| Com Node.js ou Python | npm i -g base64hub ou pipx install base64hub |
| Com Go | go install github.com/base64hub-com/base64hub-cli/cmd/b64@latest |
Para baixar direto, a página todos os downloads tem builds .tar.gz, .zip e .deb para x86_64 e arm64, com um arquivo SHA256SUMS para conferi-los. As versões do npm e do PyPI instalam o mesmo comando b64 com as mesmas flags.
Exemplos do dia a dia
Cuidado com a quebra de linha: o echo acrescenta uma, e o b64 codifica todos os bytes que recebe.
$ echo hello | b64
aGVsbG8K
$ printf 'hello' | b64
aGVsbG8=
Para quebrar uma saída longa, por exemplo em 76 caracteres para MIME, use -w:
$ printf 'foobar' | b64 -w 4
Zm9v
YmFy
Para montar uma data URI. O tipo MIME é detectado pelo conteúdo (PNG, JPEG, GIF, WebP, PDF, SVG, texto) ou definido com -m:
$ printf 'Hi' | b64 --data-uri
data:text/plain;charset=utf-8;base64,SGk=
$ b64 --data-uri -i logo.png -o logo.txt
Confira uma string antes de confiar nela. O veredito para uma entrada inválida vai para a stderr com código de saída 1. Uma string que começa com - precisa de -- antes dela para não ser lida como flag:
$ 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 vs o comando base64
O Linux traz o base64 do GNU coreutils, o macOS traz uma versão BSD, e as flags dos dois são diferentes (os detalhes estão em Base64 no Bash). O b64 se comporta igual em qualquer sistema. A coluna do GNU abaixo foi conferida com o coreutils 9.7.
| Tarefa | base64 do GNU | b64 |
|---|---|---|
| Tamanho da linha de saída | quebra em 76, a menos que se use -w 0 | uma linha, a menos que se use -w N |
| Alfabeto URL-safe | não (o basenc --base64url faz) | -u / --url |
Decodificar entrada com - ou _ | base64: invalid input | aceita |
URI data: na entrada ou na saída | não | --data-uri; o prefixo é removido ao decodificar |
| Conferir uma string | não | --validate, com variante e contagem de bytes |
| Detalhes do erro | invalid input | o caractere inválido e a posição dele |
A decodificação do b64 é tolerante de propósito: espaços, tabulações e quebras de linha são ignorados, o preenchimento é opcional e os dois alfabetos são aceitos. Qualquer outra coisa, como um ! perdido ou um = no meio, é erro com código de saída 1. Erros de uso saem com 2, para que os scripts consigam distinguir dados ruins de uma linha de comando errada.
Funciona offline
O b64 faz o trabalho na sua máquina e não precisa de conta nem de conexão com a rede. A versão em Go lê a stdin em blocos, o que mantém o uso de memória estável mesmo com entradas de vários gigabytes. Para strings avulsas no navegador, há o codificador Base64 e o decodificador deste site; a documentação da CLI cobre todas as flags e códigos de saída.
Perguntas frequentes
Como instalar uma ferramenta Base64 de linha de comando com o Homebrew?
Rode brew install base64hub-com/tap/b64. A fórmula fica no tap base64hub-com/tap e instala o comando b64 no macOS e no Linux.
O b64 substitui o comando base64 sem mudar nada?
Não, as flags são diferentes. O b64 não quebra linhas a menos que você passe -w, decodifica com -d em qualquer sistema e acrescenta saída URL-safe, data URIs e validação. Continue usando o base64 em scripts que dependem do comportamento exato dele.
Como codificar um arquivo em Base64 pela linha de comando?
b64 -i photo.jpg -o photo.b64, ou b64 < photo.jpg > photo.b64. Acrescente --data-uri para obter uma string data:image/jpeg;base64,… pronta para colar em HTML ou CSS.
Por que o b64 imprime 'valid (either, …)'?
A string não contém nenhum de + / - _, então é válida tanto no alfabeto padrão quanto no URL-safe. standard, url e mixed aparecem quando esses caracteres estão presentes.