b64 でできること
b64 はバイト列を Base64 のテキストに変換し、また元に戻します。テキストを引数で渡しても、データをパイプで流し込んでも、-i でファイルを指定してもかまいません。エンコードでは結果と改行 1 つを出力します。デコードでは生のバイト列だけを書き出すので、バイナリファイルも壊れずに出てきます。
$ b64 "Hello, hub!"
SGVsbG8sIGh1YiE=
$ b64 -d SGVsbG8sIGh1YiE=
Hello, hub!
$ printf '\xfb\xff\xbf' | b64 --url
-_-_
$ b64 --url --no-pad "Привет"
0J_RgNC40LLQtdGC
最後の 2 つは、URLセーフなアルファベット(+ と / の代わりに - と _)と、= パディングなしの出力の例です。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 |
ファイルを直接ダウンロードしたい場合は、すべてのダウンロード に x86_64 と arm64 向けの .tar.gz、.zip、.deb のビルドがあり、検証用の SHA256SUMS ファイルも付いています。npm 版と PyPI 版も、同じフラグを持つ同じ b64 コマンドをインストールします。
よく使う例
改行に注意してください。echo は改行を付け、b64 は受け取ったバイトをすべてエンコードします。
$ echo hello | b64
aGVsbG8K
$ printf 'hello' | b64
aGVsbG8=
長い出力は -w で折り返せます。MIME なら 76 文字です。
$ 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
信用する前に文字列をチェックしましょう。無効な入力の判定結果は標準エラー出力に出て、終了コードは 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 には GNU coreutils の base64、macOS には BSD 版が入っていて、フラグが異なります(詳しくは Bash での Base64 を参照)。b64 はどのシステムでも同じように動きます。下の GNU の列は coreutils 9.7 で確認したものです。
| 操作 | GNU base64 | b64 |
|---|---|---|
| 出力の行の長さ | -w 0 を付けない限り 76 文字で折り返す | -w N を付けない限り 1 行 |
| URLセーフなアルファベット | なし(basenc --base64url なら可) | -u / --url |
- や _ を含む入力のデコード | base64: invalid input | 受け付ける |
data: URI の入出力 | なし | --data-uri。デコード時は接頭辞を取り除く |
| 文字列のチェック | なし | --validate で種類とバイト数を表示 |
| エラーの詳細 | invalid input | 問題の文字とその位置 |
b64 のデコードは意図的に寛容です。空白、タブ、改行は無視され、パディングは省略でき、どちらのアルファベットも受け付けます。それ以外、たとえば紛れ込んだ ! や途中の = はエラーとなり、終了コードは 1 です。使い方の誤りは終了コード 2 なので、スクリプトはデータの不備とコマンドラインの誤りを区別できます。
オフラインで動作
b64 は処理をすべてお使いのマシン上で行い、アカウントもネットワーク接続も必要ありません。Go 版は標準入力をチャンク単位でストリーム処理するので、数 GB の入力でもメモリ使用量は増えません。ブラウザでちょっとした文字列を変換するなら、このサイトの Base64 エンコーダー と デコーダー があります。すべてのフラグと終了コードは CLI のドキュメント にまとめています。
よくある質問
Homebrew で Base64 のコマンドラインツールをインストールするには?
brew install base64hub-com/tap/b64 を実行します。フォーミュラは base64hub-com/tap という tap にあり、macOS と Linux に b64 コマンドをインストールします。
b64 は base64 コマンドの代わりにそのまま使えますか?
そのままでは使えません。フラグが違います。b64 は -w を付けない限り行を折り返さず、どの OS でも -d でデコードし、URLセーフ出力、data URI、検証の機能が加わっています。base64 の挙動をそのまま前提にしたスクリプトでは、引き続き base64 を使ってください。
コマンドラインでファイルを Base64 エンコードするには?
b64 -i photo.jpg -o photo.b64 か b64 < photo.jpg > photo.b64 です。--data-uri を付けると、HTML や CSS に貼り付けられる data:image/jpeg;base64,… 形式の文字列になります。
b64 が「valid (either, …)」と表示するのはなぜですか?
文字列に + / - _ のどれも含まれていないので、標準と URLセーフのどちらのアルファベットでも有効だからです。これらの文字が含まれていれば、standard、url、mixed のいずれかが表示されます。