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étodo | Comando |
|---|---|
| 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ón | 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 |
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ón | Significado |
|---|---|
-d, --decode | Decodifica Base64 a bytes tal cual. |
-u, --url | Codifica con el alfabeto URL-safe (- y _). |
-n, --no-pad | Codifica sin relleno =. |
-w N, --wrap N | Corta la salida codificada cada N caracteres; 0 (por defecto) es sin corte, 76 es MIME. |
--data-uri | Codifica como URI data:; el tipo MIME se detecta a partir del contenido. |
-m TYPE, --mime TYPE | Tipo MIME para --data-uri. |
--validate | Comprueba la entrada e informa de su variante y su tamaño decodificado. |
-i FILE, --input FILE | Lee FILE en lugar de la entrada estándar; - significa entrada estándar. |
-o FILE, --output FILE | Escribe en FILE en lugar de la salida estándar; - significa salida estándar. |
-h, --help | Muestra la ayuda. |
-v, --version | Imprime 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:
-dnes una opción desconocida. Los valores van tras un espacio (-w 4) o, en las opciones largas, tras=(--wrap=4);-w4no se acepta. -u,-n,-wy--data-urisolo se aplican al codificar; con-do--validateson errores de uso.-dy--validateno se pueden combinar.--data-urisiempre usa el alfabeto estándar con relleno en una sola línea, así que-u,-ny-wno se pueden combinar con ella.--mimenecesita--data-uri.- TEXT y
-ino 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ódigo | Significado |
|---|---|
0 | Éxito. |
1 | Entrada no válida, o no se pudo leer o escribir un archivo. |
2 | Error 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