Skip to content

動画ダウンロード

ローカルの動画ツールを使って、YouTubeとTikTokの動画を直接Vaultにダウンロードできます。

概要

YouTubeまたはTikTokの投稿をアーカイブしたあと、必要な動画処理ツールがコンピューターにインストールされていれば、Social Archiverは実際の動画ファイルをVaultへダウンロードできます。

なぜこの方式なのか

この機能は、次の2つの点を考慮して設計されています。

  1. Vaultサイズの管理: 大きな動画ファイルをObsidian Vaultに保存したくないユーザーもいます。特に、ファイルサイズ制限があるObsidian Syncを使っている場合は重要です。

    • Sync Standard: ファイルあたり5MB
    • Sync Plus: ファイルあたり200MB

    動画ダウンロードを任意機能にし、ローカルツールを必須にすることで、Vaultに保存する内容とデバイス間で同期する内容を完全に自分で制御できます。

  2. 技術的な制約: YouTubeとTikTokは、自動化された動画ダウンロードに対して強い保護を実装しています。Webベースのスクレイピング手法では、これらのプラットフォームから動画を安定してダウンロードできません。その代わりに、これらのプラットフォームのダウンロード仕組みに対応するために設計された実績のあるオープンソースツール(yt-dlp、ffmpeg)を活用します。

この方式により、メタデータとサムネイルをすばやくアーカイブし、必要なときだけフル動画を任意でダウンロードできます。

Obsidian Shell Execution警告

Obsidianのセキュリティスキャンで、Social ArchiverにShell Execution警告が表示されることがあります。動画ダウンロードでは、デスクトップObsidianがyt-dlpffmpegなどのローカルツールを起動してメディアをダウンロードまたは処理するため、これは想定される警告です。これらのコマンドは、動画メディアのダウンロードを明示的に実行した場合、または別のローカル処理の前にメディアダウンロードが必要なワークフローを使う場合にのみ実行されます。

要件

次のいずれかのオープンソースツールをインストールしている必要があります。

yt-dlp(推奨)

複数のプラットフォームに対応した、現代的で活発にメンテナンスされているYouTubeダウンローダーです。

インストール:

bash
# macOS(Homebrewを使用)
brew install yt-dlp

# Windows(Scoopを使用)
scoop install yt-dlp

# Linux(pipを使用)
pip install yt-dlp

インストール確認:

bash
yt-dlp --version

ffmpeg

動画処理のためのマルチメディアフレームワークです。形式変換のため、yt-dlpと一緒に使われることがよくあります。

インストール:

bash
# macOS(Homebrewを使用)
brew install ffmpeg

# Windows(Scoopを使用)
scoop install ffmpeg

# Linux(Debian/Ubuntu)
sudo apt install ffmpeg

インストール確認:

bash
ffmpeg -version

仕組み

  1. 投稿をアーカイブ: まずYouTubeまたはTikTokの投稿を通常どおりアーカイブします
  2. 完了を待つ: アーカイブ処理がメタデータとサムネイル付きで完了します
  3. 動画ダウンロードバナー: yt-dlpまたはffmpegが検出されると、投稿カードにバナーが表示されます
  4. クリックしてダウンロード: バナーをクリックして動画ファイルをダウンロードします
  5. 動画を保存: 動画はVaultの添付ファイルフォルダーに保存されます

動画の保存場所

動画は次の場所に保存されます。

attachments/social-archives/{platform}/{date}_{postId}.mp4

例:

attachments/social-archives/youtube/2024-11-14_abc123xyz.mp4

対応プラットフォーム

  • YouTube: 複数の画質オプションを含むフルHDダウンロード
  • TikTok: プラットフォーム制約により、ウォーターマーク付きの元動画

トラブルシューティング

バナーが表示されない

原因: yt-dlpまたはffmpegがシステムPATHで見つかりません

解決策:

  1. yt-dlp --versionまたはffmpeg -versionでインストールを確認します
  2. ツールをインストールしたあとObsidianを再起動します
  3. ツールがシステムPATHに含まれていることを確認します

ダウンロードに失敗する

よくある原因:

  • 動画が非公開または削除されている
  • ネットワーク接続の問題
  • ディスク空き容量不足
  • プラットフォーム側のレート制限

解決策:

  • ブラウザで動画にまだアクセスできるか確認します
  • インターネット接続を確認します
  • 十分なディスク空き容量があることを確認します
  • 数分待ってから再試行します

ダウンロードが遅い

大きな動画ファイル(特に4K)はダウンロードに時間がかかることがあります。バナーには進行状況の更新が表示されます。

ディスク容量

動画ファイルは大きくなることがあります(100MB - 1GB以上)。複数の動画をダウンロードする前に、十分なディスク空き容量があることを確認してください。

画質設定

動画の画質は次の要素に基づいて自動的に選択されます。

  • プラットフォームから利用可能な形式
  • ディスク容量
  • ネットワーク速度

YouTubeでは、yt-dlpは通常、1080pまでの利用可能な最高画質をダウンロードします。

プライバシーと著作権

重要

保存する許可がある動画だけをダウンロードしてください。著作権法とプラットフォームの利用規約を尊重してください。この機能は個人アーカイブ専用です。

MITライセンスで公開されています。