zpaqfranz 使い方メモ

macOS での zpaqfranz の基本的な使い方をまとめる。

アーカイブの作成・追加

# アーカイブを作成（既存なら差分追加）
zpaqfranz a archive.zpaq /path/to/dir

# 最大圧縮で作成
zpaqfranz a archive.zpaq /path/to/dir -m5

# 圧縮レベル: 0=無圧縮, 1..5=高速..高圧縮（デフォルト: 1）

a コマンドはアーカイブが存在しなければ新規作成する。既存のアーカイブに対して再実行すると、新しいバージョンとして差分バックアップ（重複排除付き）が追加される。

中身の確認

zpaqfranz l archive.zpaq
zpaqfranz l archive.zpaq -summary       # 簡潔な出力
zpaqfranz l archive.zpaq -find keyword  # 名前でフィルタ
zpaqfranz l archive.zpaq -all           # 全バージョンを表示

展開

# カレントディレクトリに展開
zpaqfranz x archive.zpaq

# 指定ディレクトリに展開
zpaqfranz x archive.zpaq -to /path/to/output

# 特定のファイルだけ展開
zpaqfranz x archive.zpaq "filename.txt" -to /output

削除・整理

zpaq アーカイブは追記専用の設計のため、アーカイブからファイルを直接削除することはできない。代わりに以下の方法を使う。

論理削除

ソースディレクトリからファイルを削除した後に a を再実行する。zpaqfranz は削除を新しいバージョンとして記録する。

同期（余分なファイルの削除）

k コマンドは、アーカイブに存在しないファイルを展開先から削除する。特定のスナップショットを正確に復元したい場合に有用。

zpaqfranz k archive.zpaq /source -to /destination

アーカイブの物理的な縮小

古いバージョンを削除してアーカイブを縮小する。

zpaqfranz consolidate archive.zpaq   # 最新バージョンのみに圧縮
zpaqfranz trim archive.zpaq          # 古い・未参照データを削除

備考

• アーカイブはバージョン管理される。a を実行するたびに新しいスナップショットが作成される
• 重複排除はデフォルトで有効。変更のないブロックは再保存されない
• -m5 は最高圧縮だが CPU 負荷が高い。写真や動画など既に圧縮済みのファイルに対しては効果が薄い