balrogg: Ogg Vorbis/Opus ファイルのロスレス再圧縮ツール

balrogg は、Ogg Vorbis および Opus 形式のファイルをロスレスで再圧縮するユーティリティです。アーカイブファイルサイズは通常以下の比率で削減されます。

• Ogg Vorbis (

  .ogg

  ): 約 8〜12% の削減
• Opus (

  .opus

  ): 約 3〜8% の削減

ライセンスと連絡先

• ライセンス: GNU GPL バージョン 3
  • 詳細は

    COPYING

    ファイルを参照してください。
• ホスト元: GitHub

  iczelia/balrogg

• 問題報告: Kamila Szewczyk 氏宛て（k@iczelia.net）
• 互換性について: バージョン 2.0 以前は後方・前方互換性がありません。

クイックスタート

以下のコマンドを使用してファイルの圧縮（エンコード）と展開（デコード）を行ってください。

# 基本動作
balrogg e music.ogg music.blr        # 圧縮（エンコード）
balrogg d music.blr music.ogg        # 展開（デコード）

# バッチ処理モード
balrogg -b e *.ogg *.opus            # 残りの全パスを既存コアとメモリで一括処理

# エンコーディング時の進捗表示（レベル -9）
balrogg --progress -9 e music.ogg music.blr

コマンドオプション解説

• e

  : ファイルを**圧縮（エンコード）**します。

• d

  : ファイルを**展開（デコード）**します。
  • バッチ処理時、入力ファイルの拡張子

    .blr

    は圧縮時には追加され、展開時には除去されます。
• コーデック検出: コーデックの種類はツールが自動的に判別します。

• -b

  (Batch):
  • 残りの全パスを利用可能な CPU コアとメモリを使って並列処理します。
  • 大きいファイルほど先に処理されます。

• --progress

  /

  -p

  :
  • エンコードおよびデコード時に標準エラー出力（stderr）に進捗バーを表示します。
  • ログ詳細表示には

    --progress-lines

    を使用してください。
  • バッチ処理では、入力ファイル名でラベル付けされた別行が使用されます。

インストール方法

パッケージマネージャーまたはバイナリ

パッケージマネージャーを使用するか、GitHub Releases からバイナリをダウンロードしてインストールしてください。

ソースからのビルド

リリース用アーカイブを構築する場合は、以下の手順を実行します。

基本コマンド:

./configure
make
sudo make install

Git チェックアウト時の注意:

• 最初に

  ./bootstrap

  を実行してください（autoconf と automake のインストールが必要です）。

ビルド設定オプション

--enable-sanitizers

--disable-simd

--with-windows-target=win95

エフォート（努力）レベル

圧縮率とデコード速度のバランスを調整するために、エフォートレベルを設定できます。デフォルトは

-9

• レベル -4 まで: 残留モデルのステージが追加され、デコード動作にも影響を与えます。
• レベル -5 〜 -9: パラメータ検索範囲を広げるだけであり、デコード速度はレベル -4 と同等に保たれます。
• 処理内容: 設定ごとにファイル全体が評価されます。最適な候補のみ宛先ファイルに保持され、試行中は最多 2 つの候補のみが存在します。

レベルごとの性能比較

制限事項と注意点

拒絶されるファイル

エンコーダーは以下の理由でファイルを正確に再復元できないものとして拒否します。

• チェックサムが破損している場合
• 無効なページ順序を持つ場合
• サポートされていない Vorbis の機能を使用している場合
• 最終的なストリーミング終了ページがない場合

Vorbis に関する詳細

• 追加パディング・フロー: 通常のフローと残留部圧縮は維持されます。クラスワード補正およびパディングは別途モデル化されます。
• 短縮されたパケット: パケットピーリングには適応的なバイトモデルが使用されます。

Opus に関する詳細

Opus のサポートは以下の条件に限定されています。

• チャネルマッピングファミリ 0 を持つモノラルまたはステレオの論理的ストリーム 1 つのみ。
• サイズ制限: OpusHead および OpusTags を含む全パケットは 61,440 バイト以内に制限されます（拡張フレームヘッダーおよびパディング対応）。
• 拒絶対象: チェーン化されたマルチチャンネルファイルや、複数ストリームを持つファイルは拒否されます。
  • 拒否時は診断メッセージが表示され、終了ステータスが

    1

    となります。

終了ステータスコード

バッチ処理モード: 報告されたすべてのファイルの中で最も高い非ゼロステータスが返されます。

パフォーマンスとポータビリティ

• スレッド数: 各ファイルは 1 スレッドを使用します（検索可能な入出力ファイルを必要とします）。
• メモリ管理: Vorbis モデルページは使用時だけに割り当てられ、遅延 OS 割り当てに依存しません。
  • 不合理な割当を避けるため、デフォルトではプロセスメモリ上限を 2 GiB に設定します。

  • BLR_MEMCAP

    を別の MiB サイズに設定するか、

    0

    にして制限を無効にできます。
• ポータビリティ: 生成されたアーカイブファイルは異なるホスト間でも利用可能です。

OS 別ビルド手順

Windows (MinGW)

通常の Windows ビルドには以下のコマンドを使用します：

./configure --host=x86_64-w64-mingw32 \
    CC=x86_64-w64-mingw32-gcc \
    LDFLAGS=-static make

Windows 95 (MinGW)

小さな KERNEL32 ランタイムを使用した i486 ターゲットビルドです：

./configure --host=i686-w64-mingw32 \
    --with-windows-target=win95 \
    CC=i686-w64-mingw32-gcc \
    LDFLAGS=-static make && make win95-check

• win95-check

  は、ローダーのベースライン、PE フラグ、および KERNEL32 インポートを検証します。

MS-DOS (DJGPP)

DPMI ホスト（例：CWSDPMI）を必要とする i386 システム向けです：

./configure --host=i586-pc-msdosdjgpp \
    CC=i586-pc-msdosdjgpp-gcc make

DOS バッチモード

• 拡張子が置換され、**シリアル処理（1 つずつ）**で実行されます。
• 例:

  song.ogg

  →

  song.blr

• Opus の場合:

  song.blr

  →

  song.ogg

  または

  song.opu