ファイルを選択
  1. base64hub
  2. ドキュメント
  3. CLI

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
npmnpm i -g base64hub
pipxpipx install base64hub
Gogo 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、--decodeBase64 を生のバイト列にデコードします。
-u、--urlURLセーフなアルファベット(- と _)でエンコードします。
-n、--no-pad= パディングなしでエンコードします。
-w N、--wrap Nエンコード結果を N 文字ごとに折り返します。0(デフォルト)は折り返しなし、76 は MIME です。
--data-uridata: URI としてエンコードします。MIME タイプは内容から判定します。
-m TYPE、--mime TYPE--data-uri で使う MIME タイプです。
--validate入力をチェックし、種類とデコード後のサイズを報告します。
-i FILE、--input FILE標準入力の代わりに FILE を読みます。- は標準入力です。
-o FILE、--output FILE標準出力の代わりに FILE に書きます。- は標準出力です。
-h、--helpヘルプを表示します。
-v、--versionb64 とバージョンを表示します。
--フラグの終わり。次の引数は - で始まっていても 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