b64 CLI リファレンス
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 |
x86_64 と arm64 向けの macOS、Linux、Windows のリリースアーカイブ、.deb パッケージ、SHA256SUMS ファイルは ダウンロードページ にあります。インストールできたかどうかは b64 --version で確認できます。b64 1.0.0 と表示されれば成功です。
npm 版と pipx 版も、フラグもメッセージも同じコマンドです。違いは 1 つだけで、Go 版は標準入力をチャンク単位でストリーム処理しますが、npm 版と Python 版は入力全体をまずメモリに読み込みます。
使い方
b64 [flags] [TEXT]
TEXT を指定すると、b64 は TEXT の UTF-8 バイト列を処理し、改行は加えません。TEXT がなければ、標準入力を最後まで、または -i で指定したファイルを読みます。フラグは TEXT の前にも後にも置けます。
エンコードでは Base64 の後に改行を 1 つ出力します。デコードでは生のバイト列だけを書き出すので、b64 -d の出力はバイナリファイルにもなりえます。
フラグ
| フラグ | 意味 |
|---|---|
-d、--decode | Base64 を生のバイト列にデコードします。 |
-u、--url | URLセーフなアルファベット(- と _)でエンコードします。 |
-n、--no-pad | = パディングなしでエンコードします。 |
-w N、--wrap N | エンコード結果を N 文字ごとに折り返します。0(デフォルト)は折り返しなし、76 は MIME です。 |
--data-uri | data: URI としてエンコードします。MIME タイプは内容から判定します。 |
-m TYPE、--mime TYPE | --data-uri で使う MIME タイプです。 |
--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は常にパディング付きの標準アルファベットを 1 行で使うので、-u、-n、-wとは組み合わせられません。--mimeには--data-uriが必要です。- TEXT と
-iは同時に使えず、TEXT は 1 つだけです。空白を含むテキストは引用符で囲んでください。 - URLセーフな Base64 のように
-で始まる TEXT は、前に--が必要です(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セーフ、パディングありとなし:
$ 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 タイプ
--mime なしの --data-uri は先頭のバイトを調べます。PNG、JPEG、GIF、WebP、PDF はシグネチャで判定し、SVG は、テキストが <svg で始まるか、<?xml で始まって <svg を含む場合に判定します。それ以外で、制御文字(タブ、CR、LF は可)を含まない有効な UTF-8 テキストは text/plain;charset=utf-8 に、残りはすべて application/octet-stream になります。
更新日 2026/11/22