Skip to content
annrie
YTDown
Public

About

Native desktop app for downloading videos and audio from YouTube and 1000+ sites. Built with Tauri v2 + Vue 3 + yt-dlp.

Topics

tailwindcsstauri2vue3yt-dlp-gui

Resources

Readme
MIT license
Activity

Stars

1 star

Watchers

1 watching

Forks

1 fork
Report repository
BranchesTags

Repository files navigation

YTDown icon

YTDown

A native desktop app for downloading videos, audio, and images from the web.
Built with Tauri v2 + Vue 3 + yt-dlp.

Features · Installation · Build · 日本語

YTDown settings screen

Features

🌐 One-Click Browser Capture macOS only

Grab the URL directly from your browser — no copy-paste needed.

Click the globe icon ( ) next to the URL bar to instantly capture the URL from the frontmost tab of your browser.

Supported browsers: Safari, Chrome, Brave, Arc, Edge, Vivaldi, Opera, Firefox, Biscuit

Note

This feature uses macOS-native APIs (AppleScript / CoreGraphics) and is available on macOS only. On Windows and Linux, please enter URLs manually or paste from the clipboard.

Video & Audio

  • Multi-site support — YouTube, Vimeo, Twitter/X, and 1000+ sites via yt-dlp
  • Video & Audio — Download as MP4, MKV, WebM, MP3, FLAC, M4A, WAV, and more
  • Quality selection — Choose from Best, 4K, 1080p, 720p, 480p
  • Playlist support — Download entire playlists with parallel processing
  • Batch download — Paste multiple URLs at once
  • URL drag & drop — Drop URLs from browsers, selected text, .txt, .webloc, or .url files
  • Cookie authentication — Access private/age-restricted content via browser cookies
  • Post-processing — Embed thumbnails, metadata, subtitles, chapters; SponsorBlock integration
  • Library management — Browse, search, filter, and organize downloaded media
  • YouTube channel folders — Automatically organizes downloads into channel-name subfolders
  • Channel monitoring — Watch YouTube channels and automatically check for new uploads on schedule or app startup
  • Download notifications — Show a desktop notification when downloads finish
  • URL history — Recent URLs are saved automatically and accessible via the clock icon
  • Auto yt-dlp install — If yt-dlp is not found, install it directly from the app

🔒 Streaming Sites & Protected Content advanced

Download from sites that stream via HLS (.m3u8) or sit behind anti-bot protection.

  • Auto-detect embedded media — Paste the page URL and YTDown scans the page for embedded HLS/.m3u8/video URLs automatically (toggle in Advanced settings).
  • Manual stream URL — When a site serves a direct .m3u8 that yt-dlp can't analyze, paste it into the collapsible Manual stream URL panel in the download dialog. Pasting a direct media URL opens and fills this panel for you.
  • Referer — Many CDNs require the source page as the Referer. Using the browser-capture button on a video page pre-fills the Referer field automatically.
  • Cloudflare auto-retry — When a download fails with a Cloudflare anti-bot 403, YTDown retries once automatically with --extractor-args generic:impersonate.
  • PNG-disguised HLS recovery — Some players disguise video segments as PNG images, which normally yields an unplayable file. YTDown detects this after download and automatically rebuilds a playable MP4.
  • Manual title — For sites where no title can be fetched, type one in the dialog (it becomes the filename). The browser-capture button also fills this from the page title automatically.

Note

A red "failed to fetch info" error can be normal. Protected sites (e.g. Cloudflare-guarded pages) often block the metadata request. You can still download: paste the direct .m3u8 into the Manual stream URL panel, set the Referer to the source page, and start. The error only means the preview couldn't load — not that the download will fail.

Important

Known limitations for these sites: thumbnails may be unavailable (the page's image can't be fetched through the protection), and resuming an interrupted stream download does not currently re-apply the Referer.

🖼 Image Download

Scrape and download images from any web page.

  • Page scraping — Enter a URL to scan for images with size filtering (min width/height)
  • Browser URL capture — Grab the current page URL from your browser directly in the image download view
  • Preview & select — Browse scraped images in a thumbnail grid, select which ones to download
  • WebP conversion — Optionally convert images to WebP format on download
  • Gallery view — Browse downloaded images organized by session with adjustable thumbnail sizes
  • Slideshow — Fullscreen slideshow with keyboard navigation, auto-play, and speed controls

General

  • Custom background — Set separate wallpapers for light and dark mode
  • Multilingual UI — Interface available in 8 languages: Japanese, English, German, Spanish, French, Korean, Portuguese (Brazil), Traditional Chinese

Platform Support

Feature macOS Windows Linux
Video/audio download ✅ ✅ ✅
Image scraping & download ✅ ✅ ✅
Browser URL capture ✅ — —
Pause / Resume download ✅ — ✅
Move to Trash ✅ ✅ ✅
Reveal in file manager ✅ ✅ ✅

Important

Current real-device testing has only been performed on macOS Intel. Windows, Linux, and macOS Apple Silicon (arm64) builds are provided on a best-effort basis and have not been validated on physical machines yet.

Installation

Requirements

  • yt-dlp — If not installed, YTDown will offer to download and install it automatically. Or install manually:
    • macOS: brew install yt-dlp
    • Windows: winget install yt-dlp or scoop install yt-dlp
    • Linux: sudo apt install yt-dlp or download from yt-dlp releases
    • Using yt-dlp from pyenv / pipx / pip instead of Homebrew? Enter its full path in Settings → Advanced → yt-dlp path (~/ is expanded). Leave auto for auto-detection.

Download

Download the latest release from the Releases page.

Platform File
macOS (Universal) YTDown_x.x.x_universal.dmg
Windows (64-bit) YTDown_x.x.x_x64-setup.exe
Linux (Debian/Ubuntu) YTDown_x.x.x_amd64.deb
Linux (AppImage) YTDown_x.x.x_amd64.AppImage

Build from Source

Prerequisites

Steps

git clone https://github.com/annrie/YTDown.git
cd YTDown
pnpm install

# Development
pnpm tauri dev

# Production build
pnpm tauri build

Tech Stack

Layer Technology
Backend Rust, Tauri v2, SQLite (rusqlite)
Frontend Vue 3 (Composition API), TypeScript, Pinia
Styling Tailwind CSS v4
Internationalization vue-i18n v11 (8 locales)
Video engine yt-dlp
Image processing Rust image crate (scraping, WebP conversion)

License

MIT

YTDown アイコン

YTDown — 日本語ドキュメント

動画・音声・画像をウェブからダウンロードするネイティブデスクトップアプリ
Tauri v2 + Vue 3 + yt-dlp で構築

主な機能

🌐 ブラウザから URL をワンクリック取得 macOS 限定

コピー＆ペースト不要。ブラウザの URL をそのまま取得します。

URL 入力欄の横にある 地球アイコン（ ）をクリックすると、最前面のブラウザタブから URL を自動的に取得してセットします。

対応ブラウザ: Safari, Chrome, Brave, Arc, Edge, Vivaldi, Opera, Firefox, Biscuit

Note

この機能は macOS 固有の API（AppleScript / CoreGraphics）を使用しているため、macOS でのみ利用可能です。Windows・Linux では URL を手動で入力するか、クリップボードから貼り付けてください。

動画・音声

  • マルチサイト対応 — YouTube, Vimeo, Twitter/X ほか yt-dlp が対応する 1000 以上のサイト
  • 映像 & 音声 — MP4, MKV, WebM, MP3, FLAC, M4A, WAV など多数のフォーマットに対応
  • 画質選択 — 最高画質, 4K, 1080p, 720p, 480p から選択
  • プレイリスト対応 — プレイリスト全体を並列ダウンロード
  • 一括ダウンロード — 複数の URL をまとめて入力可能
  • URL ドラッグ&ドロップ — ブラウザ、テキスト選択、.txt、.webloc、.url から URL をドロップ可能
  • Cookie 認証 — ブラウザの Cookie を利用して限定公開・年齢制限コンテンツにアクセス
  • ポストプロセス — サムネイル・メタデータ・字幕・チャプターの埋め込み、SponsorBlock 対応
  • ライブラリ管理 — ダウンロード済みメディアの一覧・検索・フィルタリング
  • YouTube チャンネルフォルダ — チャンネル名のサブフォルダに自動整理
  • チャンネル監視 — YouTube チャンネルを登録し、定期実行や起動時チェックで新着を自動確認
  • 完了通知 — ダウンロード完了時にデスクトップ通知を表示
  • URL 履歴 — 直近の URL を自動保存、時計アイコンからすぐに呼び出し可能
  • yt-dlp 自動インストール — yt-dlp 未検出時、アプリ内からワンクリックでインストール

🔒 ストリーミングサイト・保護されたコンテンツ 上級

HLS（.m3u8）配信やアンチボット保護のあるサイトからダウンロードします。

  • 埋め込みメディアの自動検出 — ページの URL を貼り付けると、ページ内の HLS/.m3u8/動画 URL を自動で探します（詳細設定でオン/オフ切替）。
  • 手動ストリーム URL — yt-dlp が解析できない直接 .m3u8 は、ダウンロードダイアログの折りたたみ 手動ストリーム URL 欄に貼り付けます。直接メディア URL を貼ると自動でこの欄が開いて入力されます。
  • Referer — 多くの CDN は元ページを Referer として要求します。動画ページで「ブラウザから取得」ボタンを使うと Referer 欄が自動で埋まります。
  • Cloudflare 自動リトライ — Cloudflare のアンチボット 403 で失敗した場合、--extractor-args generic:impersonate を付けて自動的に一度だけ再試行します。
  • PNG 偽装 HLS の自動復元 — 一部のプレイヤーは動画セグメントを PNG 画像に偽装しており、通常は再生できないファイルになります。YTDown はダウンロード後にこれを検出し、再生可能な MP4 へ自動で再構築します。
  • 手動タイトル — タイトルを取得できないサイト向けに、ダイアログでタイトルを入力できます（ファイル名になります）。「ブラウザから取得」ボタンはページタイトルからこれを自動入力します。

Note

赤い「情報取得に失敗」エラーは正常なことがあります。 保護されたサイト（Cloudflare 配下のページ等）はメタデータ取得をブロックすることがよくあります。それでもダウンロードは可能です。直接 .m3u8 を 手動ストリーム URL 欄に貼り、Referer に元ページを設定して開始してください。このエラーは プレビュー が読めなかっただけで、ダウンロードが失敗するという意味ではありません。

Important

これらのサイトの既知の制限: サムネイルは取得できないことがあります（保護を越えてページの画像を取得できないため）。また、中断したストリームダウンロードの再開時に Referer が再適用されません。

🖼 画像ダウンロード

ウェブページから画像をスクレイピングしてダウンロード

  • ページスクレイピング — URL を入力してページ内の画像を取得（最小幅・最小高さでフィルタリング可能）
  • ブラウザ URL 取得 — 画像ダウンロード画面からもブラウザの URL をワンクリックで取得可能
  • プレビュー & 選択 — サムネイルグリッドで画像を確認し、ダウンロードする画像を選択
  • WebP 変換 — ダウンロード時に WebP 形式への変換が可能
  • ギャラリー表示 — セッション別にダウンロード済み画像を一覧表示（サムネイルサイズ調整可能）
  • スライドショー — フルスクリーン表示、キーボード操作、自動再生（速度調整付き）

全般

  • 背景画像のカスタマイズ — ライトモード・ダークモードそれぞれに壁紙を設定可能
  • 多言語対応 — 日本語・英語・ドイツ語・スペイン語・フランス語・韓国語・ポルトガル語（ブラジル）・繁体字中国語の 8 言語に対応

プラットフォーム対応状況

機能 macOS Windows Linux
動画・音声ダウンロード ✅ ✅ ✅
画像スクレイピング & ダウンロード ✅ ✅ ✅
ブラウザ URL 取得 ✅ — —
一時停止 / 再開 ✅ — ✅
ゴミ箱へ移動 ✅ ✅ ✅
ファイルマネージャで表示 ✅ ✅ ✅

Important

現時点で実機確認を行っているのは macOS Intel 版のみです。Windows、Linux、macOS Apple Silicon（arm64）向けビルドは提供できますが、まだ実機での検証はしていません。

インストール

必要なもの

  • yt-dlp — 未インストールの場合、アプリ内から自動でダウンロード・インストールできます。手動の場合:
    • macOS: brew install yt-dlp
    • Windows: winget install yt-dlp または scoop install yt-dlp
    • Linux: sudo apt install yt-dlp または yt-dlp リリースページからダウンロード
    • Homebrew 以外（pyenv / pipx / pip）の yt-dlp を使う場合は、設定 → 詳細設定 → yt-dlp パス にフルパスを入力してください（~/ 展開可）。auto のままなら自動検出です。

Releases ページから最新版をダウンロードしてください。

ソースからビルド

git clone https://github.com/annrie/YTDown.git
cd YTDown
pnpm install
pnpm tauri dev      # 開発モード
pnpm tauri build    # プロダクションビルド

Responsible Use / 責任ある利用のお願い

Important

YTDown is a general-purpose downloader intended for content you have the right to save — your own uploads, works you are licensed to download, public-domain or Creative Commons media, and offline viewing where it is permitted. Please respect copyright and each site's Terms of Service, and use YTDown only for content you are entitled to download. You are responsible for how you use this tool.

YTDown は、あなたが保存する権利を持つコンテンツのためのダウンローダーです（自分がアップロードした動画、ダウンロードが許諾された作品、パブリックドメインや Creative Commons のメディア、許可されたオフライン視聴など）。著作権および各サイトの利用規約を尊重し、ダウンロードする権利を持つコンテンツにのみご利用ください。 本ツールの使い方についての責任は利用者にあります。

About

Native desktop app for downloading videos and audio from YouTube and 1000+ sites. Built with Tauri v2 + Vue 3 + yt-dlp.

Topics

tailwindcsstauri2vue3yt-dlp-gui

Resources

Readme
MIT license
Activity

Stars

1 star

Watchers

1 watching

Forks

1 fork
Report repository

Releases

Packages

Contributors

Languages