Что делает b64
b64 превращает байты в текст Base64 и обратно. Передайте текст аргументом, подайте данные через конвейер или укажите файл в -i. При кодировании выводится результат и один перевод строки; при декодировании записываются только сами байты, поэтому бинарные файлы выходят целыми.
$ b64 "Hello, hub!"
SGVsbG8sIGh1YiE=
$ b64 -d SGVsbG8sIGh1YiE=
Hello, hub!
$ printf '\xfb\xff\xbf' | b64 --url
-_-_
$ b64 --url --no-pad "Привет"
0J_RgNC40LLQtdGC
Последние две строки показывают URL-safe алфавит (- и _ вместо + и /) и вывод без дополнения =: в таком виде Base64 встречается в JWT и URL. Разница объяснена в статье Base64 и Base64URL.
Установка
В блоке установки выше есть команда для каждого менеджера пакетов. Коротко:
| Платформа | Команда |
|---|---|
| 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, затем scoop install b64 |
| Arch Linux (AUR) | yay -S b64-bin |
| Любая Unix-оболочка | curl -fsSL https://base64hub.com/install.sh | sh |
| Через Node.js или Python | npm i -g base64hub или pipx install base64hub |
| Через Go | go install github.com/base64hub-com/base64hub-cli/cmd/b64@latest |
Обычные архивы лежат в разделе все загрузки: там есть сборки .tar.gz, .zip и .deb для x86_64 и arm64 и файл SHA256SUMS для их проверки. Сборки из npm и PyPI ставят ту же команду b64 с теми же флагами.
Примеры на каждый день
Помните о переводе строки: echo его добавляет, а b64 кодирует каждый полученный байт.
$ echo hello | b64
aGVsbG8K
$ printf 'hello' | b64
aGVsbG8=
Длинный вывод разбивается на строки флагом -w, например по 76 символов для MIME:
$ printf 'foobar' | b64 -w 4
Zm9v
YmFy
Data URI. MIME-тип определяется по содержимому (PNG, JPEG, GIF, WebP, PDF, SVG, текст) или задаётся через -m:
$ printf 'Hi' | b64 --data-uri
data:text/plain;charset=utf-8;base64,SGk=
$ b64 --data-uri -i logo.png -o logo.txt
Проверьте строку, прежде чем ей доверять. Вердикт для некорректных данных уходит в stderr с кодом выхода 1. Перед строкой, которая начинается с -, нужен --, иначе её примут за флаг:
$ 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 и команда base64
В Linux есть base64 из GNU coreutils, в macOS – версия из BSD, и флаги у них разные (подробности в статье Base64 в Bash). b64 ведёт себя одинаково в любой системе. Столбец GNU ниже проверен на coreutils 9.7.
| Задача | GNU base64 | b64 |
|---|---|---|
| Длина строки вывода | перенос через 76 символов, если не указать -w 0 | одна строка, если не указать -w N |
| URL-safe алфавит | нет (умеет basenc --base64url) | -u / --url |
Декодирование входа с - или _ | base64: invalid input | принимается |
data: URI на входе или выходе | нет | --data-uri; при декодировании префикс отбрасывается |
| Проверка строки | нет | --validate с вариантом и числом байтов |
| Подробности ошибки | invalid input | неверный символ и его позиция |
Декодирование в b64 намеренно нестрогое: пробелы, табуляции и переводы строк игнорируются, дополнение необязательно, принимаются оба алфавита. Всё остальное, например случайный ! или = в середине, считается ошибкой с кодом выхода 1. Ошибки использования завершаются с кодом 2, так что скрипт может отличить плохие данные от неверной командной строки.
Работает офлайн
b64 делает всю работу на вашем компьютере, ему не нужны ни аккаунт, ни сеть. Сборка на Go читает stdin частями, поэтому расход памяти не растёт даже на входе в несколько гигабайт. Для разовых строк в браузере на этом сайте есть кодировщик Base64 и декодер; каждый флаг и код выхода описан в документации CLI.
Вопросы и ответы
Как установить утилиту Base64 для командной строки через Homebrew?
Выполните brew install base64hub-com/tap/b64. Формула лежит в tap base64hub-com/tap и устанавливает команду b64 в macOS и Linux.
Можно ли просто заменить команду base64 на b64?
Нет, флаги отличаются. b64 не переносит строки без -w, везде декодирует с -d и вдобавок умеет URL-safe, data URI и проверку. В скриптах, которые рассчитаны на точное поведение base64, оставьте base64.
Как закодировать файл в Base64 из командной строки?
b64 -i photo.jpg -o photo.b64 или b64 < photo.jpg > photo.b64. Добавьте --data-uri, чтобы получить строку data:image/jpeg;base64,…, которую можно вставить в HTML или CSS.
Почему b64 выводит «valid (either, …)»?
В строке нет ни одного из символов + / - _, поэтому она допустима и в стандартном, и в URL-safe алфавите. Если такие символы есть, выводится standard, url или mixed.