Загрузить файл
  1. base64hub
  2. Документация
  3. CLI

Справочник по CLI b64

b64 кодирует, декодирует и проверяет Base64. Здесь перечислены все флаги, правила их сочетания и то, что команда выводит и возвращает.

Установка

СпособКоманда
Homebrew (macOS, Linux)brew install base64hub-com/tap/b64
Scoop (Windows)scoop bucket add base64hub https://github.com/base64hub-com/homebrew-tap, затем scoop install b64
winget (Windows)winget install base64hub.b64
AUR (Arch Linux)yay -S b64-bin
Скрипт установкиcurl -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

Архивы релизов для macOS, Linux и Windows на x86_64 и arm64, пакеты .deb и файл SHA256SUMS есть на странице загрузок. Проверьте установку командой b64 --version, она выводит b64 1.0.0.

Сборки из npm и pipx – это та же команда с теми же флагами и сообщениями. Отличие одно: сборка на Go читает стандартный ввод частями, а сборки для npm и Python сначала загружают весь вход в память.

Использование

b64 [flags] [TEXT]

С TEXT b64 работает с байтами UTF-8 этого текста, без добавленного перевода строки. Без TEXT команда читает стандартный ввод до конца или файл, указанный в -i. Флаги можно ставить до или после TEXT.

При кодировании выводится Base64 и один перевод строки. При декодировании записываются только сырые байты, поэтому вывод b64 -d может быть бинарным файлом.

Флаги

ФлагЗначение
-d, --decodeДекодировать Base64 в сырые байты.
-u, --urlКодировать URL-safe алфавитом (- и _).
-n, --no-padКодировать без дополнения =.
-w N, --wrap NПереносить закодированный вывод каждые N символов; 0 (по умолчанию) – без переноса, 76 – MIME.
--data-uriКодировать в data: URI; MIME-тип определяется по содержимому.
-m TYPE, --mime TYPEMIME-тип для --data-uri.
--validateПроверить вход и сообщить его вариант и размер после декодирования.
-i FILE, --input FILEЧитать FILE вместо стандартного ввода; - означает стандартный ввод.
-o FILE, --output FILEПисать в FILE вместо стандартного вывода; - означает стандартный вывод.
-h, --helpПоказать справку.
-v, --versionВывести b64 и номер версии.
--Конец флагов: следующий аргумент считается TEXT, даже если начинается с -.

Правила сочетания флагов

  • Короткие флаги нельзя объединять: -dn – неизвестный параметр. Значение пишется через пробел (-w 4) или, у длинных флагов, после = (--wrap=4); -w4 не принимается.
  • -u, -n, -w и --data-uri относятся только к кодированию; вместе с -d или --validate это ошибка использования.
  • -d и --validate нельзя сочетать.
  • --data-uri всегда использует стандартный алфавит с дополнением в одну строку, поэтому -u, -n и -w с ним не сочетаются.
  • --mime работает только вместе с --data-uri.
  • TEXT и -i нельзя использовать вместе, и TEXT допускается только один: текст с пробелами заключайте в кавычки.
  • Перед TEXT, который начинается с -, например URL-safe Base64, нужен --: b64 -d -- -_-_.

Коды выхода и сообщения

КодЗначение
0Успех.
1Некорректные входные данные, или файл не удалось прочитать или записать.
2Ошибка использования: неизвестный флаг, неверное значение или несовместимые флаги.

Ошибки выводятся в стандартный поток ошибок в виде b64: <message>. --validate для корректного входа выводит valid (<variant>, <bytes> bytes) в стандартный вывод, а иначе invalid: <reason> в стандартный поток ошибок с кодом выхода 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

Позиции отсчитываются от 0 во входных данных после удаления пробелов, табуляций и переводов строк.

Примеры

Кодирование и декодирование текста:

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

URL-safe, с дополнением и без:

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

Перенос строк; заметьте, что echo добавляет перевод строки, и он тоже кодируется:

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

Data URI с автоматически определённым или явно заданным типом:

$ 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

Декодирование нестрогое: оно принимает переводы строк, префикс data: и строки без дополнения, а строку, которая начинается с -, ставят после --:

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

Проверка в скрипте:

$ 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

Файлы на входе и выходе:

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

Определяемые MIME-типы

--data-uri без --mime смотрит на первые байты: PNG, JPEG, GIF, WebP и PDF определяются по сигнатурам, а SVG – если текст начинается с <svg или начинается с <?xml и содержит <svg. Остальной корректный текст UTF-8 без управляющих символов (табуляция, CR и LF допустимы) получает тип text/plain;charset=utf-8, всё прочее – application/octet-stream.

Обновлено 22 нояб. 2026 г.