Referência da CLI b64
O b64 codifica, decodifica e valida Base64. Esta página lista todas as flags, as regras para combiná-las e o que o comando imprime e retorna.
Instalação
| Método | Comando |
|---|---|
| Homebrew (macOS, Linux) | brew install base64hub-com/tap/b64 |
| Scoop (Windows) | scoop bucket add base64hub https://github.com/base64hub-com/homebrew-tap, depois scoop install b64 |
| winget (Windows) | winget install base64hub.b64 |
| AUR (Arch Linux) | yay -S b64-bin |
| Script de instalação | 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 |
Os arquivos de cada versão para macOS, Linux e Windows em x86_64 e arm64, os pacotes .deb e um arquivo SHA256SUMS estão na página de downloads. Confira a instalação com b64 --version, que imprime b64 1.0.0.
As versões do npm e do pipx são o mesmo comando, com as mesmas flags e mensagens. A única diferença: a versão em Go lê a entrada padrão em blocos, enquanto as versões do npm e do Python leem a entrada inteira para a memória antes.
Uso
b64 [flags] [TEXT]
Com TEXT, o b64 trabalha com os bytes UTF-8 de TEXT, sem acrescentar quebra de linha. Sem TEXT, ele lê a entrada padrão até o fim, ou o arquivo indicado com -i. As flags podem vir antes ou depois de TEXT.
A codificação imprime o Base64 seguido de uma quebra de linha. A decodificação escreve os bytes puros e nada mais, então a saída do b64 -d pode ser um arquivo binário.
Flags
| Flag | Significado |
|---|---|
-d, --decode | Decodifica Base64 para bytes puros. |
-u, --url | Codifica com o alfabeto URL-safe (- e _). |
-n, --no-pad | Codifica sem o preenchimento =. |
-w N, --wrap N | Quebra a saída codificada a cada N caracteres; 0 (padrão) é sem quebra, 76 é MIME. |
--data-uri | Codifica como uma URI data:; o tipo MIME é detectado pelo conteúdo. |
-m TYPE, --mime TYPE | Tipo MIME para --data-uri. |
--validate | Confere a entrada e informa a variante e o tamanho decodificado. |
-i FILE, --input FILE | Lê FILE em vez da entrada padrão; - significa entrada padrão. |
-o FILE, --output FILE | Escreve em FILE em vez da saída padrão; - significa saída padrão. |
-h, --help | Mostra a ajuda. |
-v, --version | Imprime b64 e a versão. |
-- | Fim das flags: o próximo argumento é TEXT, mesmo que comece com -. |
Regras para combinar flags
- Flags curtas não podem ser agrupadas:
-dné uma opção desconhecida. Os valores vêm depois de um espaço (-w 4) ou, nas flags longas, depois de=(--wrap=4);-w4não é aceito. -u,-n,-we--data-urivalem só para a codificação; com-dou--validate, são erros de uso.-de--validatenão podem ser combinados.--data-urisempre usa o alfabeto padrão, com preenchimento e numa linha só, então-u,-ne-wnão podem ser combinados com ele.--mimeexige--data-uri.- TEXT e
-inão podem ser usados juntos, e só um TEXT é permitido: coloque entre aspas um texto que tenha espaços. - Um TEXT que começa com
-, como Base64 URL-safe, precisa de--antes:b64 -d -- -_-_.
Códigos de saída e mensagens
| Código | Significado |
|---|---|
0 | Sucesso. |
1 | Entrada inválida, ou um arquivo que não pôde ser lido ou escrito. |
2 | Erro de uso: flag desconhecida, valor inválido ou flags que não podem ser combinadas. |
Os erros vão para a saída de erro padrão no formato b64: <message>. O --validate imprime valid (<variant>, <bytes> bytes) na saída padrão para uma entrada válida e, nos outros casos, invalid: <reason> na saída de erro padrão, com código de saída 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
As posições são contadas a partir de 0 na entrada, depois de removidos os espaços, as tabulações e as quebras de linha.
Exemplos
Codificar e decodificar texto:
$ b64 "Hello, hub!"
SGVsbG8sIGh1YiE=
$ b64 -d SGVsbG8sIGh1YiE=
Hello, hub!
URL-safe, com e sem preenchimento:
$ printf '\xfb\xff\xbf' | b64 --url
-_-_
$ b64 --url --no-pad "Привет"
0J_RgNC40LLQtdGC
$ b64 -n f
Zg
Quebrar linhas, e repare que o echo acrescenta uma quebra de linha que também é codificada:
$ b64 -w 4 foobar
Zm9v
YmFy
$ echo hello | b64
aGVsbG8K
Data URIs, com o tipo detectado ou explícito:
$ 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
A decodificação é tolerante: quebras de linha, um prefixo data: e preenchimento ausente são aceitos, e uma string que começa com - vai depois de --:
$ b64 -d 'data:text/plain;base64,SGk='
Hi
$ b64 -d -- -_-_ | xxd -p
fbffbf
Validar num 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
Arquivos na entrada e na saída:
b64 -i photo.jpg -o photo.b64
b64 -d -i photo.b64 -o photo-copy.jpg
Tipos MIME detectados
O --data-uri sem --mime olha os primeiros bytes: PNG, JPEG, GIF, WebP e PDF pelas assinaturas, e SVG quando o texto começa com <svg, ou com <?xml e contém <svg. Outros textos UTF-8 válidos sem caracteres de controle (tabulação, CR e LF são aceitos) viram text/plain;charset=utf-8; todo o resto vira application/octet-stream.
Atualizado 22 de nov. de 2026