Справочник по 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 |
| npm | npm i -g base64hub |
| pipx | pipx install base64hub |
| Go | go 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 TYPE | MIME-тип для --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 г.