omnooth

Caution

omnooth は実験的な開発期間中であり、正常に動作しないことがほとんどです。

実使用は避けてください。

omnooth（オムノース）は、BOOTHのライブラリからダウンロードしたファイルを整理するためのマルチプラットフォームCLIです。

対応環境

• Windows、macOS、またはXDG準拠のLinuxデスクトップ

はじめる

go build -o omnooth .
./omnooth scheme install

これで、BOOTHから開かれた booth-library-manager:// URLをomnoothが受け取れるようになります。管理者権限は不要です。

登録状態と直近の取込結果は、次のコマンドで確認できます。

./omnooth scheme status

インポート

通常はBOOTHから自動的に開始されます。Custom URLを直接処理する場合は、次のように実行します。

./omnooth import 'booth-library-manager://item-import?dlurl=...&downloadable_filename=...&item_id=...&order_id=...&variation_id=...'

ギフト商品では order_id が省略されることがありますが、そのまま取り込めます。

取込結果は次の構造で保存されます。

~/omnooth/items/
  {SHOP_ID}_{SHOP_NAME}/
    {ITEM_ID}_{ITEM_NAME}/
      {downloadable_filename}/
        {ダウンロードしたファイル、または展開内容}

更新確認

取込済み商品の配布ファイルがBOOTH上で変更されたかは、次のコマンドで確認できます。

./omnooth outdated

omnoothは取込時のvariationに含まれる配布ファイル一覧を保存し、現在の一覧と比較します。ファイル名に含まれるバージョン表記には依存せず、ファイルの追加、削除、同名ファイルのサイズまたは更新日時の変更を検出します。商品説明、価格、配布ファイルの表示順だけの変更は対象外です。

同じvariationから複数ファイルを取り込んだ場合は1行にまとめ、更新の影響を受けるローカルファイルを表示します。更新が見つかっても終了コードは0です。APIへの接続失敗などで確認できない商品がある場合はunknownを表示し、終了コードは非ゼロになります。

この機能の導入前に取り込んだ商品には比較用情報がないため、再度取り込むまでunknownと表示されます。初回確認時の状態を自動的な基準にはしません。

取込ディレクトリ内の.omnooth/installation.jsonは更新確認に使う管理情報です。削除または編集しないでください。

対応書庫

• ZIP
• TARおよび圧縮TAR（.tar.gz、.tar.bz2、.tar.xz、.tar.zstなど）
• 7z
• RAR

書庫は展開して保存します。通常ファイルはそのまま保存します。パスワードで暗号化された書庫には対応していません。

URLスキームの管理

./omnooth scheme install
./omnooth scheme status
./omnooth scheme uninstall

バイナリを更新した場合は、更新後のバイナリから scheme install を再実行してください。scheme uninstall を実行しても、取込済みの商品は削除されません。

omnoothは、HTTPSの booth.pm またはそのサブドメインから提供されるダウンロードだけを受け付けます。

ログ

omnoothは起動ごとに、処理段階と成功・失敗を次の場所へ記録します。

~/omnooth/logs/log_YYYYMMDD_HHMMSS.nnnnnnnnn.txt

コマンドが失敗した場合は、標準エラーにも該当するログファイルのパスを表示します。Custom URLや署名付きダウンロードURLなどの機密情報はログへ記録しません。