Stacherがyt-dlpを使う仕組み
StacherはデスクトップGUIです。URL、プリセット、保存先、認証、後処理をまとめてyt-dlpのジョブを作ります。yt-dlpはサイトを判別し、映像・音声形式を調べ、選択したストリームを取得し、結合や変換が必要ならFFmpegへ渡します。
キューや保存設定はStacher側、extractor・署名・HTTP・形式のメッセージはyt-dlp側、結合やcodecの失敗はFFmpeg側であることが多いです。最後の一般的な失敗表示より、詳細ログの最初の具体的なエラーを読みます。
| 要素 | 主な役割 | 確認できる情報 |
|---|---|---|
| Stacher | 画面、キュー、プリセット、保存先、コンポーネント管理 | 設定、パス、branch、キュー状態 |
| yt-dlp | extractor、形式確認、通信、ダウンロード | バージョン、extractor、HTTP/形式メッセージ |
| FFmpeg | 結合、remux、変換、埋め込み | 後処理、codec、実行ファイルのエラー |
自分が所有する、または保存を許可されたメディアだけを扱ってください。更新しても非公開・有料・削除済み・制限付きコンテンツへの権限は得られません。
管理版yt-dlpとカスタムパスの違い
多くの利用者にはStacher管理版が安全です。Stacherが保存場所を把握し、設定から更新できます。カスタムパスは、特定ビルドを検証する上級者や、実行ファイルの場所を管理する環境向けです。
よくある失敗は別のコピーを更新することです。ターミナルで更新しても、Stacherが古い別ファイルを使う場合があります。ジョブログで実際のバージョンとパスを確認し、意図しない上書き設定を外します。
- 通常は管理版を使う。
- カスタムパスは自分で保守できる場合だけ設定する。
- 似た名前の実行ファイルを複数置かない。
- パス変更後は再起動して新しいログを確認する。
| 選択 | 適した用途 | 主なリスク |
|---|---|---|
| 管理版 | 通常のWindows/macOS/Linux環境 | 中断した更新は再試行が必要 |
| カスタム実行ファイル | 高度な検証や管理環境 | 古いパス、権限、architecture不一致 |
| システムパッケージ | 管理されたLinux | repository版が遅い場合がある |
パスとbranchを同時に変えず、1項目ずつ検証します。
Stacherでyt-dlpを安全に更新する方法
ログが古いバージョンを示す、Stacherが更新を表示する、または以前対応していたサイトで最新yt-dlpが修正済みのextractorエラーが出た場合に更新します。容量不足、保存先、権限、FFmpegの問題には別の対処が必要です。
更新後は、許可された公開URL、既定形式、cookiesや追加引数なし、短いローカル保存先という最小条件でテストします。
- 実行中のダウンロードを終了する。
- 設定でyt-dlp、update、branch、custom pathを検索する。
- 現在のbranchとパスを記録する。
- 更新を実行して結果を待つ。
- Stacherを再起動する。
- 許可された公開URLを1件テストする。
- 詳細ログでバージョンとパスを確認する。
- 成功後にcookiesや追加引数を1つずつ戻す。
更新失敗の正確な文言を保存してください。セキュリティソフト、権限、ネットワーク、使用中ファイルが置換を妨げることがあります。
stable・nightly・masterの選び方
stableは日常利用の既定です。nightlyは更新頻度が高く、次のstableより前にextractor修正を含むことがあります。masterは開発中の状態に近く、プロジェクト側から指定された短い診断以外では常用しません。
branch変更は、特定の修正が同じエラーを直すか確認するために行います。stableのバージョンを記録し、同じURLでnightlyを試し、stableに修正が入った時点またはregressionが出た時点で戻します。
| Branch | 使う場面 | 戻す時期 |
|---|---|---|
| Stable | 通常利用と最初の診断 | 文書化された修正テスト時だけ離れる |
| Nightly | 修正がstable未収録 | stable収録後または不具合発生時 |
| Master | 短時間の高度な診断 | テスト直後 |
「latest」だけでなくbranchとバージョンを一緒に記録します。
詳細ログでStacher yt-dlpの問題を直す
詳細ログは、古いextractor、誤ったパス、後処理失敗を切り分けます。最初の具体的エラー、yt-dlpバージョン、extractor、保存先、カスタムパス、cookies、proxy、追加引数の有無を確認します。共有前に非公開URLやセッション情報を削除してください。
フォーラムの引数を無条件で追加しないでください。古い回避策がプリセットを上書きし、更新後の新しい原因になることがあります。最小構成へ戻してから必要な項目だけ追加します。
| ログ症状 | 考えられる原因 | 最初の対処 |
|---|---|---|
| Unsupported URL/extractor | yt-dlp/サイト | stable更新。文書化された修正時だけnightly |
| 更新後も古い版 | パス/複数コピー | 実行ファイルを確認し不要なoverrideを外す |
| 置換の権限エラー | OS/セキュリティ | プロセス終了、権限と隔離履歴を確認 |
| 形式がない | 形式選択/配信元 | 既定選択へ戻す |
| FFmpegがない | 後処理 | FFmpegを導入またはパス確認 |
| ログインが必要 | 認証 | 許可されたセッションとcookiesガイドを使う |
| Timeout/DNS | ネットワーク | 別の許可URL、firewall、proxyを確認 |
最後の一般的な失敗行より、最初の具体的なエラーが重要です。
Windows・macOS・Linuxの注意点
Windowsではセキュリティソフトが新しい実行ファイルを隔離したり、保護フォルダへの書き込みを止めたりします。Downloads内の複数コピーを避け、保護履歴を確認します。
macOSではApple siliconとIntelを合わせ、権限を確認します。Linuxではpackage、Python環境、Stacher管理版が共存するため、ジョブログで使用中のコピーを判断します。
出力フォルダとyt-dlp実行パスは別です。保存先の最終行はログで確認できます。
- OSとCPU architectureを合わせる。
- 診断中は短いローカルパスを使う。
- networkや同期フォルダは最初のテストで避ける。
- Stacher版、yt-dlp版、branch、パスを記録する。
2026年7月23日時点で確認済みのStacherは7.1.11です。yt-dlpは別の更新周期です。
Stacher yt-dlp よくある質問
Stacherにはyt-dlpが含まれますか？
Stacherは通常利用向けのyt-dlpを管理し、カスタムパスも設定できます。ログで実際のコピーを確認できます。
Stacherでyt-dlpを更新するには？
ジョブを止め、設定から更新し、再起動後に許可されたURLを試し、ログで版とパスを確認します。
nightlyを使うべきですか？
既定はstableです。現在の修正が文書化されている場合だけ一時的にnightlyを使います。
更新後も古い版なのはなぜ？
別コピーやカスタムパスを使っている可能性があります。ログの実行ファイルを確認してください。
Stacherの動画保存先は？
選択した出力フォルダです。yt-dlpの実行パスとは別で、最終保存先はログに表示されます。
更新ですべてのエラーが直りますか？
いいえ。FFmpeg、容量、権限、ネットワーク、形式不足、アカウント制限は別問題です。