Enviar um arquivo
  1. base64hub
  2. Docs
  3. CLI

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étodoComando
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çãocurl -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

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

FlagSignificado
-d, --decodeDecodifica Base64 para bytes puros.
-u, --urlCodifica com o alfabeto URL-safe (- e _).
-n, --no-padCodifica sem o preenchimento =.
-w N, --wrap NQuebra a saída codificada a cada N caracteres; 0 (padrão) é sem quebra, 76 é MIME.
--data-uriCodifica como uma URI data:; o tipo MIME é detectado pelo conteúdo.
-m TYPE, --mime TYPETipo MIME para --data-uri.
--validateConfere a entrada e informa a variante e o tamanho decodificado.
-i FILE, --input FILELê FILE em vez da entrada padrão; - significa entrada padrão.
-o FILE, --output FILEEscreve em FILE em vez da saída padrão; - significa saída padrão.
-h, --helpMostra a ajuda.
-v, --versionImprime 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); -w4 não é aceito.
  • -u, -n, -w e --data-uri valem só para a codificação; com -d ou --validate, são erros de uso.
  • -d e --validate não podem ser combinados.
  • --data-uri sempre usa o alfabeto padrão, com preenchimento e numa linha só, então -u, -n e -w não podem ser combinados com ele.
  • --mime exige --data-uri.
  • TEXT e -i nã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ódigoSignificado
0Sucesso.
1Entrada inválida, ou um arquivo que não pôde ser lido ou escrito.
2Erro 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