An open API service indexing awesome lists of open source software.

https://github.com/annrie/ytdown

Native desktop app for downloading videos and audio from YouTube and 1000+ sites. Built with Tauri v2 + Vue 3 + yt-dlp.
https://github.com/annrie/ytdown

tailwindcss tauri2 vue3 yt-dlp-gui

Last synced: 2 months ago
JSON representation

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

Awesome Lists containing this project

README

          


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 · 日本語

---

## 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](https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md) 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

### 🖼 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

### 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](https://github.com/yt-dlp/yt-dlp/releases)

### Download

Download the latest release from the [Releases](../../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

- [Node.js](https://nodejs.org/) 18+
- [pnpm](https://pnpm.io/)
- [Rust](https://rustup.rs/) toolchain
- [Tauri v2 prerequisites](https://v2.tauri.app/start/prerequisites/)

### Steps

```bash
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 |
| 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 以上のサイト](https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md)
- **映像 & 音声** — 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 未検出時、アプリ内からワンクリックでインストール

#### 🖼 画像ダウンロード

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

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

#### 全般

- **背景画像のカスタマイズ** — ライトモード・ダークモードそれぞれに壁紙を設定可能

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

| 機能 | 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 リリースページ](https://github.com/yt-dlp/yt-dlp/releases)からダウンロード

[Releases](../../releases) ページから最新版をダウンロードしてください。

### ソースからビルド

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