ファイルを選択
  1. base64hub
  2. ダウンロード
  3. CLI
v1.0.0 · オープンソース · MIT

b64:macOS・Linux・Windows 用の Base64 コマンドラインツール

b64 はターミナルで Base64 をエンコード、デコード、チェックするツールです。小さなバイナリ 1 つで、フラグは macOS、Linux、Windows のどれでも同じ。パイプとスクリプトでの利用を前提に作りました。

brew install base64hub-com/tap/b64
無料 アカウント不要・キー不要 MIT オープンソースライセンス ゼロ 実行時の依存関係 更新日 2026/11/22

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 base64b64
出力の行の長さ-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 のいずれかが表示されます。

base64hub のほかの製品