Subir un archivo
  1. base64hub
  2. Descargas
  3. CLI
v1.0.0 · Código abierto · MIT

b64: herramienta de línea de comandos Base64 para macOS, Linux y Windows

b64 codifica, decodifica y comprueba Base64 desde la terminal. Un binario pequeño con las mismas opciones en macOS, Linux y Windows, pensado para tuberías y scripts.

brew install base64hub-com/tap/b64
Gratis sin cuenta, sin clave MIT licencia de código abierto Cero dependencias en tiempo de ejecución Actualizado 22 nov 2026

Qué hace b64

b64 convierte bytes en texto Base64 y al revés. Pásale el texto como argumento, envíale datos por una tubería o indícale un archivo con -i. Al codificar imprime el resultado y un salto de línea; al decodificar escribe los bytes tal cual y nada más, así que los archivos binarios salen intactos.

$ b64 "Hello, hub!"
SGVsbG8sIGh1YiE=
$ b64 -d SGVsbG8sIGh1YiE=
Hello, hub!
$ printf '\xfb\xff\xbf' | b64 --url
-_-_
$ b64 --url --no-pad "Привет"
0J_RgNC40LLQtdGC

Las dos últimas órdenes muestran el alfabeto URL-safe (- y _ en lugar de + y /) y la salida sin relleno =, la forma que se usa en los JWT y en las URL. Base64 frente a Base64URL explica la diferencia.

Instalación

El cuadro de instalación de arriba tiene un comando para cada gestor de paquetes. En resumen:

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 y después scoop install b64
Arch Linux (AUR)yay -S b64-bin
Cualquier shell Unixcurl -fsSL https://base64hub.com/install.sh | sh
Con Node.js o Pythonnpm i -g base64hub o pipx install base64hub
Con Gogo install github.com/base64hub-com/base64hub-cli/cmd/b64@latest

Para una descarga directa, en todas las descargas hay compilaciones .tar.gz, .zip y .deb para x86_64 y arm64, con un archivo SHA256SUMS para comprobarlas. Las versiones de npm y PyPI instalan el mismo comando b64 con las mismas opciones.

Ejemplos del día a día

Ojo con el salto de línea: echo añade uno y b64 codifica todos los bytes que recibe.

$ echo hello | b64
aGVsbG8K
$ printf 'hello' | b64
aGVsbG8=

Corta la salida larga en líneas con -w, por ejemplo a 76 caracteres para MIME:

$ printf 'foobar' | b64 -w 4
Zm9v
YmFy

Crea un data URI. El tipo MIME se detecta a partir del contenido (PNG, JPEG, GIF, WebP, PDF, SVG, texto) o se indica con -m:

$ printf 'Hi' | b64 --data-uri
data:text/plain;charset=utf-8;base64,SGk=
$ b64 --data-uri -i logo.png -o logo.txt

Comprueba una cadena antes de fiarte de ella. Con una entrada no válida, el veredicto va a stderr con código de salida 1. Una cadena que empieza por - necesita -- delante para que no se lea como una opción:

$ 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 frente al comando base64

Linux trae el base64 de GNU coreutils, macOS trae una versión BSD, y sus opciones no coinciden (los detalles están en Base64 en Bash). b64 se comporta igual en todos los sistemas. La columna de GNU se comprobó con coreutils 9.7.

TareaGNU base64b64
Longitud de línea de la salidacorta a 76 salvo con -w 0una sola línea salvo con -w N
Alfabeto URL-safeno (basenc --base64url sí)-u / --url
Decodificar entrada con - o _base64: invalid inputse acepta
URI data: de entrada o de salidano--data-uri; al decodificar se quita el prefijo
Comprobar una cadenano--validate con la variante y el número de bytes
Detalle de los erroresinvalid inputel carácter incorrecto y su posición

La decodificación de b64 es tolerante a propósito: ignora espacios, tabuladores y saltos de línea, el relleno es opcional y acepta los dos alfabetos. Cualquier otra cosa, como un ! suelto o un = en medio, es un error con código de salida 1. Los errores de uso terminan con 2, así que un script puede distinguir datos incorrectos de un comando mal escrito.

Funciona sin conexión

b64 hace su trabajo en tu equipo y no necesita cuenta ni conexión a la red. La versión de Go procesa stdin en bloques, así que el consumo de memoria no crece con entradas de varios gigabytes. Para cadenas sueltas en el navegador tienes el codificador Base64 y el decodificador de este sitio; la documentación de la CLI cubre todas las opciones y códigos de salida.

Preguntas frecuentes

¿Cómo instalo una herramienta de línea de comandos Base64 con Homebrew?

Ejecuta brew install base64hub-com/tap/b64. La fórmula está en el tap base64hub-com/tap e instala el comando b64 en macOS y Linux.

¿b64 sustituye directamente al comando base64?

No, las opciones son distintas. b64 no corta las líneas salvo que pases -w, decodifica con -d en todos los sistemas y añade salida URL-safe, data URI y validación. Sigue usando base64 en los scripts que dependen de su comportamiento exacto.

¿Cómo codifico un archivo en Base64 desde la línea de comandos?

b64 -i photo.jpg -o photo.b64, o b64 < photo.jpg > photo.b64. Añade --data-uri para obtener una cadena data:image/jpeg;base64,… que puedes pegar en HTML o CSS.

¿Por qué b64 imprime «valid (either, …)»?

La cadena no contiene ninguno de + / - _, así que es válida tanto en el alfabeto estándar como en el URL-safe. standard, url y mixed aparecen cuando la cadena contiene esos caracteres.

Más de base64hub