Enviar um arquivo
  1. base64hub
  2. Downloads
  3. CLI
v1.0.0 · Código aberto · MIT

b64: Base64 na linha de comando para macOS, Linux e Windows

O b64 codifica, decodifica e confere Base64 no terminal. Um binário pequeno com as mesmas flags no macOS, no Linux e no Windows, feito para pipes e scripts.

brew install base64hub-com/tap/b64
Grátis sem conta, sem chave MIT licença de código aberto Zero dependências em tempo de execução Atualizado 22 de nov. de 2026

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:

PlataformaComando
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 Unixcurl -fsSL https://base64hub.com/install.sh | sh
Com Node.js ou Pythonnpm i -g base64hub ou pipx install base64hub
Com Gogo 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.

Tarefabase64 do GNUb64
Tamanho da linha de saídaquebra em 76, a menos que se use -w 0uma linha, a menos que se use -w N
Alfabeto URL-safenão (o basenc --base64url faz)-u / --url
Decodificar entrada com - ou _base64: invalid inputaceita
URI data: na entrada ou na saídanão--data-uri; o prefixo é removido ao decodificar
Conferir uma stringnão--validate, com variante e contagem de bytes
Detalhes do erroinvalid inputo 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.

Mais do base64hub