Subir un archivo
  1. base64hub
  2. Docs
  3. CLI

Referencia de la CLI b64

b64 codifica, decodifica y valida Base64. Esta página recoge todas las opciones, las reglas para combinarlas y lo que el comando imprime y devuelve.

Instalación

MétodoComando
Homebrew (macOS, Linux)brew install base64hub-com/tap/b64
Scoop (Windows)scoop bucket add base64hub https://github.com/base64hub-com/homebrew-tap y después scoop install b64
winget (Windows)winget install base64hub.b64
AUR (Arch Linux)yay -S b64-bin
Script de instalacióncurl -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

Los archivos de cada versión para macOS, Linux y Windows en x86_64 y arm64, los paquetes .deb y un archivo SHA256SUMS están en la página de descargas. Comprueba la instalación con b64 --version, que imprime b64 1.0.0.

Las versiones de npm y pipx son el mismo comando, con las mismas opciones y mensajes. La única diferencia: la versión de Go procesa la entrada estándar por bloques, mientras que las de npm y Python leen primero toda la entrada en memoria.

Uso

b64 [flags] [TEXT]

Con TEXT, b64 trabaja con los bytes UTF-8 de TEXT, sin añadir salto de línea. Sin TEXT lee la entrada estándar hasta el final, o el archivo indicado con -i. Las opciones pueden ir antes o después de TEXT.

Al codificar imprime el Base64 seguido de un salto de línea. Al decodificar escribe los bytes tal cual y nada más, así que la salida de b64 -d puede ser un archivo binario.

Opciones

OpciónSignificado
-d, --decodeDecodifica Base64 a bytes tal cual.
-u, --urlCodifica con el alfabeto URL-safe (- y _).
-n, --no-padCodifica sin relleno =.
-w N, --wrap NCorta la salida codificada cada N caracteres; 0 (por defecto) es sin corte, 76 es MIME.
--data-uriCodifica como URI data:; el tipo MIME se detecta a partir del contenido.
-m TYPE, --mime TYPETipo MIME para --data-uri.
--validateComprueba la entrada e informa de su variante y su tamaño decodificado.
-i FILE, --input FILELee FILE en lugar de la entrada estándar; - significa entrada estándar.
-o FILE, --output FILEEscribe en FILE en lugar de la salida estándar; - significa salida estándar.
-h, --helpMuestra la ayuda.
-v, --versionImprime b64 y la versión.
--Fin de las opciones: el siguiente argumento es TEXT aunque empiece por -.

Reglas para combinar opciones

  • Las opciones cortas no se pueden agrupar: -dn es una opción desconocida. Los valores van tras un espacio (-w 4) o, en las opciones largas, tras = (--wrap=4); -w4 no se acepta.
  • -u, -n, -w y --data-uri solo se aplican al codificar; con -d o --validate son errores de uso.
  • -d y --validate no se pueden combinar.
  • --data-uri siempre usa el alfabeto estándar con relleno en una sola línea, así que -u, -n y -w no se pueden combinar con ella.
  • --mime necesita --data-uri.
  • TEXT y -i no se pueden usar juntos, y solo se admite un TEXT: pon entre comillas el texto que contenga espacios.
  • Un TEXT que empieza por -, como el Base64 URL-safe, necesita -- delante: b64 -d -- -_-_.

Códigos de salida y mensajes

CódigoSignificado
0Éxito.
1Entrada no válida, o no se pudo leer o escribir un archivo.
2Error de uso: opción desconocida, valor incorrecto u opciones que no se pueden combinar.

Los errores van a la salida de error estándar como b64: <message>. --validate imprime valid (<variant>, <bytes> bytes) en la salida estándar si la entrada es válida y, si no, invalid: <reason> en la salida de error estándar con código de salida 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

Las posiciones se cuentan desde 0 en la entrada, después de quitar espacios, tabuladores y saltos de línea.

Ejemplos

Codificar y decodificar texto:

$ b64 "Hello, hub!"
SGVsbG8sIGh1YiE=
$ b64 -d SGVsbG8sIGh1YiE=
Hello, hub!

URL-safe, con y sin relleno:

$ printf '\xfb\xff\xbf' | b64 --url
-_-_
$ b64 --url --no-pad "Привет"
0J_RgNC40LLQtdGC
$ b64 -n f
Zg

Cortar líneas, y ojo: echo añade un salto de línea que también se codifica:

$ b64 -w 4 foobar
Zm9v
YmFy
$ echo hello | b64
aGVsbG8K

Data URI, con el tipo detectado o indicado explícitamente:

$ 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

La decodificación es tolerante: acepta saltos de línea, un prefijo data: y la falta de relleno, y una cadena que empieza por - va después de --:

$ b64 -d 'data:text/plain;base64,SGk='
Hi
$ b64 -d -- -_-_ | xxd -p
fbffbf

Validar en un 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

Archivos de entrada y de salida:

b64 -i photo.jpg -o photo.b64
b64 -d -i photo.b64 -o photo-copy.jpg

Tipos MIME detectados

--data-uri sin --mime mira los primeros bytes: PNG, JPEG, GIF, WebP y PDF por sus firmas, y SVG cuando el texto empieza por <svg, o por <?xml y contiene <svg. El resto del texto UTF-8 válido sin caracteres de control (tabulador, CR y LF sí se permiten) pasa a ser text/plain;charset=utf-8; todo lo demás, application/octet-stream.

Actualizado 22 nov 2026