設定リファレンス

FlowPickは豊富な設定オプションを提供し、ダウンロード動作、フィルタリングルール、ストレージ戦略、UI設定をカバーしています。本ドキュメントでは各設定項目の役割、デフォルト値、適用シーンについて順に説明します。

クイックリファレンス

設定エントリ

設定は2つの階層に分かれており、異なる使用シーンに対応します：

保存と同期：

• 拡張機能設定はchrome.storage.syncに保存され、Chromeアカウントでログインすると他のデバイスに自動同期されます
• ダウンロードパネルの設定は現在のタブセッションのみに存在し、ページをリロードするとデフォルトに戻ります
• 保存ディレクトリ名はlocalStorageのflowpick_save_dir_nameキーにキャッシュされ、デバイス間では同期されません

ダウンロード設定

並列スレッド数

同時にダウンロードするセグメント数を制御します。より高い並列数はダウンロード速度を向上させますが、ネットワーク帯域幅の占有とブラウザメモリ負荷も増加します。

選択ガイドライン：

実際の並列数はセグメント総数を超えません。例えばセグメントが3つしかない場合、8に設定しても3つのダウンロードタスクしか起動しません。

出力形式

ストリーミングセグメントマージ後の出力コンテナ形式です。

選択ガイドライン：

• 最大互換性が必要（プレイヤー、編集ソフトウェア、他者への共有）の場合 → MP4を選択
• 最速マージ速度を求め、後で他のツールでトランスコードする予定 → TSを選択
• 元ストリーム自体がTS形式で二次処理が不要 → TSを選択

MP4出力時、FlowPickは自動的に-movflags +faststartフラグを追加し、moov atomを先頭に配置します。これにより、動画がダウンロード完了前から再生可能になります（プログレッシブダウンロードシーン向け）。

保存ディレクトリ

FlowPickは2種類のファイル保存戦略をサポートしています：

戦略1：ブラウザデフォルトダウンロードフォルダ

保存ディレクトリを設定しない場合、すべてのファイルはブラウザのDownloads APIを使用してシステムデフォルトのダウンロードフォルダに保存されます。毎回ダウンロード時に追加確認は不要です。

戦略2：カスタム保存ディレクトリ（File System Access API）

ダウンロードパネルの「保存ディレクトリを選択」ボタンをクリックしてフォルダを認証すると、その後のすべてのダウンロードが直接そのフォルダに書き込まれ、保存ダイアログは表示されなくなります。

ディレクトリ権限の説明：

• 認証状態はnavigator.permissions.query()でサイレントチェックされ、繰り返しポップアップ表示されることはありません
• 権限が取り消された場合（ユーザーがシステム設定で手動削除した場合）、FlowPickは自動的にポップアップモードにフォールバックします
• ディレクトリ名はlocalStorageのflowpick_save_dir_nameキーにキャッシュされ、UI表示のみに使用されます
• カスタムディレクトリはデバイス間同期に対応しておらず、各デバイスで個別に認証が必要です

ファイル名

ダウンロードファイルの命名規則：

• デフォルトで動画ページタイトルまたはストリームURLからファイル名部分を使用
• 手動編集可能、ダウンロードパネルのファイル名入力欄で変更可能
• 特殊文字（\/:*?"<>|など）はアンダースコアに自動置換されます
• 対象ディレクトリに同名ファイルが既存の場合、ブラウザが自動的に番号サフィックスを追加します（例：video (1).mp4）

フィルタ設定

自動検出

拡張機能がページ読み込み時にメディアリソースを自動スキャンするかどうかを制御します。

自動検出をオンにするとページ読み込み時のCPU使用率がわずかに増加しますが、通常は無視できる程度です。

最小ファイルサイズ

指定した閾値未満のリソースをフィルタリングし、広告セグメント、サムネイル、プレースホルダー画像をスキップするために使用します。

典型的なシーン：

タイプ別フィルタリング

ポップアップウィンドウでメディアタイプ別に表示結果をフィルタリング：

再生時間別フィルタリング

動画および音声リソースにのみ適用されます。最短再生時間を設定することで極めて短いセグメントを除外できます。

UI設定

テーマモード

デフォルトではシステム設定に従います。設定はchrome.storage.syncに保存され、アカウントと共に同期されます。

通知

ダウンロード完了後のデスクトップ通知動作を制御：

通知はブラウザのNotifications APIを使用し、初回使用時に権限を要求します。通知権限を拒否した場合は、ブラウザ設定で再度有効化できます。

高度な設定

画質選択戦略

アダプティブストリーム（HLS Master Playlist / DASH MPD）の場合、FlowPickは2種類の画質選択方式を提供します：

画質リストはビットレートの高い順にソートされ、表示形式は：1080p · 5.2 Mbps · avc1.640028となります。

リトライ戦略

セグメントダウンロード失敗時の自動リトライメカニズム：

リトライはネットワークレベルの一時的な障害（タイムアウト、接続リセット）に対してのみ実行されます。HTTP 4xxエラー（403、404など）はリトライをトリガーせず、即座にエラーを報告します。

メモリ安全制限

ブラウザのメモリ不足によるクラッシュを防ぐため、FlowPickにはメモリ保護メカニズムが組み込まれています：

推定ファイルサイズがBlob上限を超えた場合、FlowPickはFile System Access APIまたはStreamSaverストリーミング書き込みの使用を強制し、ファイル全体をメモリに読み込むことを回避します。

セグメントサイズ推定

ダウンロード開始前に、FlowPickは総ファイルサイズをサンプリング推定します：

• サンプリング数：min(5, max(1, totalSegments × 0.1))
• 推定式：avgSampleSize × totalSegments
• ストリーミング書き込みモードの有無判定に使用

シーン別設定構成

異なる使用シーンに基づき、以下の設定構成をお勧めします：

日常的な動画ダウンロード

大多数のユーザー向けのデフォルト設定：

大容量ファイル/ライブ配信アーカイブ

5GBを超えるライブ配信アーカイブまたは長尺動画のダウンロード：

画像ギャラリー一括ダウンロード

画像ギャラリーサイトから画像を一括ダウンロード：

ポッドキャスト/音声ダウンロード

ポッドキャスト番組または音声ファイルのダウンロード：

モバイルホットスポット/通信量節約

携帯電話のホットスポットまたは通信量が限られている場合：

設定のリセット

すべての設定をデフォルト値に復元する場合：

1. 拡張機能ポップアップウィンドウを開く
2. 歯車アイコンをクリックして設定に入る
3. 全データを消去をクリックする
4. 操作を確認する

この操作により以下がクリアされます：

• chrome.storage.sync内のすべての拡張機能設定
• localStorageにキャッシュされた保存ディレクトリ名
• フィルタープリセットとテーマ設定

影響を受けないデータ：

• ブラウザのダウンロード履歴
• ローカルにダウンロード済みのファイル
• 拡張機能本体（アンインストールされません）

関連ドキュメント

• インストールガイド — 拡張機能のインストールと初期設定
• 使用方法 — 日常使用の操作ガイド
• フォーマット変換 — 出力形式の詳細技術説明
• 動画スニッフィング — メディア検出原理と暗号化処理
• ダウンロードエンジンアーキテクチャ — 並列制御、リトライ戦略、メモリ管理
• ブラウザ互換性 — 各ブラウザAPIのサポートとフォールバック戦略
• よくある問題のトラブルシューティング — 設定関連問題の診断方法
• 既知の制限事項 — リマックス vs トランスコードの違い
• 使用シーン — シーン別設定構成
• プライバシーとセキュリティ — 自動検出とプライバシー説明