Загрузить файл
  1. base64hub
  2. Скачать
  3. CLI
v1.0.0 · Открытый код · MIT

b64: Base64 в командной строке macOS, Linux и Windows

b64 кодирует, декодирует и проверяет Base64 в терминале. Это один небольшой бинарный файл с одинаковыми флагами в macOS, Linux и Windows, рассчитанный на конвейеры и скрипты.

brew install base64hub-com/tap/b64
Бесплатно без аккаунта и ключа MIT открытая лицензия Ноль зависимостей во время выполнения Обновлено 22 нояб. 2026 г.

Что делает 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 или Pythonnpm i -g base64hub или pipx install base64hub
Через Gogo 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 base64b64
Длина строки выводаперенос через 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.

Ещё от base64hub