Remove download started toast notifications (#143 )

* Remove download started toast notifications Remove the "download started" toast notifications from single video and playlist downloads, keeping only the one-click download notification. Also remove the corresponding unused translation strings from all 13 locale files. Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com> * Restore oneClickDownloadStarted translation key in all locales The oneClickDownloadStarted key is still referenced in the code when one-click downloads start, so it must be kept in all locale files. Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com> * Translate feedback.title in all non-English locales The feedback.title field was showing English text in all locale files. Updated to proper translations for each language. Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com> --------- Co-authored-by: Claude Haiku 4.5 <noreply@anthropic.com>
fix(docs): resolve TypeScript build errors (#144 )
2026-01-17 17:27:11 +08:00 · 2026-01-17 16:31:24 +08:00 · 2026-01-17 14:37:43 +08:00 · 2026-01-17 13:58:17 +08:00 · 2026-01-17 13:35:29 +08:00 · 2026-01-17 13:23:45 +08:00
77 changed files with 6119 additions and 451 deletions
--- a/.github/workflows/build.yml
+++ b/.github/workflows/build.yml
@@ -33,16 +33,16 @@ jobs:
            ytdlp_output: yt-dlp.exe
            ffmpeg_url: https://github.com/yt-dlp/FFmpeg-Builds/releases/latest/download/ffmpeg-master-latest-win64-gpl.zip
            ffmpeg_inner_path: ffmpeg-master-latest-win64-gpl\bin\ffmpeg.exe
-            ffmpeg_output: ffmpeg.exe
+            ffprobe_inner_path: ffmpeg-master-latest-win64-gpl\bin\ffprobe.exe
          - platform: macos
            os: macos-latest
            build_script: pnpm run build:mac
            ytdlp_asset: yt-dlp_macos
            ytdlp_output: yt-dlp_macos
-            ffmpeg_arm_url: https://github.com/eko5624/mpv-mac/releases/download/2025-10-25/ffmpeg-arm64-defd5f3f64.zip
-            ffmpeg_x86_url: https://github.com/eko5624/mpv-mac/releases/download/2025-10-25/ffmpeg-x86_64-defd5f3f64.zip
+            ffmpeg_arm_url: https://github.com/eko5624/mpv-mac/releases/download/2026-01-12/ffmpeg-arm64-96e8f3b8cc.zip
+            ffmpeg_x86_url: https://github.com/eko5624/mpv-mac/releases/download/2026-01-12/ffmpeg-x86_64-96e8f3b8cc.zip
            ffmpeg_inner_path: ffmpeg/ffmpeg
-            ffmpeg_output: ffmpeg_macos
+            ffprobe_inner_path: ffmpeg/ffprobe
          - platform: linux
            os: ubuntu-latest
            build_script: pnpm run build:linux
@@ -50,7 +50,7 @@ jobs:
            ytdlp_output: yt-dlp_linux
            ffmpeg_url: https://github.com/yt-dlp/FFmpeg-Builds/releases/latest/download/ffmpeg-master-latest-linux64-gpl.tar.xz
            ffmpeg_inner_path: ffmpeg-master-latest-linux64-gpl/bin/ffmpeg
-            ffmpeg_output: ffmpeg_linux
+            ffprobe_inner_path: ffmpeg-master-latest-linux64-gpl/bin/ffprobe
    steps:
      - name: Check out Git repository
        uses: actions/checkout@v4
@@ -77,8 +77,11 @@ jobs:
          Invoke-WebRequest -Uri $ffmpegUrl -OutFile ffmpeg.zip
          Expand-Archive ffmpeg.zip -DestinationPath ffmpeg -Force
          $source = Join-Path 'ffmpeg' '${{ matrix.ffmpeg_inner_path }}'
-          $destination = Join-Path 'resources' '${{ matrix.ffmpeg_output }}'
-          Copy-Item -Path $source -Destination $destination -Force
+          $ffprobeSource = Join-Path 'ffmpeg' '${{ matrix.ffprobe_inner_path }}'
+          $destinationDir = Join-Path 'resources' 'ffmpeg'
+          New-Item -ItemType Directory -Path $destinationDir -Force | Out-Null
+          Copy-Item -Path $source -Destination (Join-Path $destinationDir 'ffmpeg.exe') -Force
+          Copy-Item -Path $ffprobeSource -Destination (Join-Path $destinationDir 'ffprobe.exe') -Force
          Remove-Item ffmpeg.zip -Force
          Remove-Item ffmpeg -Recurse -Force

@@ -86,7 +89,8 @@ jobs:
        if: matrix.platform == 'macos'
        shell: bash
        env:
-          FFMPEG_OUTPUT: ${{ matrix.ffmpeg_output }}
+          FFMPEG_OUTPUT: ffmpeg
+          FFPROBE_OUTPUT: ffprobe
        run: |
          set -euo pipefail
          curl -fL --retry 3 --retry-delay 2 --retry-connrefused "${{ matrix.ffmpeg_arm_url }}" -o ffmpeg-arm.zip
@@ -97,6 +101,8 @@ jobs:

          arm_bin="ffmpeg-arm/${{ matrix.ffmpeg_inner_path }}"
          x86_bin="ffmpeg-x86/${{ matrix.ffmpeg_inner_path }}"
+          arm_probe="ffmpeg-arm/${{ matrix.ffprobe_inner_path }}"
+          x86_probe="ffmpeg-x86/${{ matrix.ffprobe_inner_path }}"

          if [[ ! -f "$arm_bin" ]]; then
            arm_bin="$(find ffmpeg-arm -type f -name ffmpeg -print -quit)"
@@ -104,6 +110,12 @@ jobs:
          if [[ ! -f "$x86_bin" ]]; then
            x86_bin="$(find ffmpeg-x86 -type f -name ffmpeg -print -quit)"
          fi
+          if [[ ! -f "$arm_probe" ]]; then
+            arm_probe="$(find ffmpeg-arm -type f -name ffprobe -print -quit)"
+          fi
+          if [[ ! -f "$x86_probe" ]]; then
+            x86_probe="$(find ffmpeg-x86 -type f -name ffprobe -print -quit)"
+          fi

          if [[ ! -f "$arm_bin" ]]; then
            echo "::error::Missing arm64 ffmpeg binary at $arm_bin"
@@ -113,9 +125,19 @@ jobs:
            echo "::error::Missing x86_64 ffmpeg binary at $x86_bin"
            exit 1
          fi
+          if [[ ! -f "$arm_probe" ]]; then
+            echo "::error::Missing arm64 ffprobe binary at $arm_probe"
+            exit 1
+          fi
+          if [[ ! -f "$x86_probe" ]]; then
+            echo "::error::Missing x86_64 ffprobe binary at $x86_probe"
+            exit 1
+          fi

-          lipo -create "$arm_bin" "$x86_bin" -output "resources/$FFMPEG_OUTPUT"
-          chmod +x "resources/$FFMPEG_OUTPUT"
+          mkdir -p resources/ffmpeg
+          lipo -create "$arm_bin" "$x86_bin" -output "resources/ffmpeg/$FFMPEG_OUTPUT"
+          lipo -create "$arm_probe" "$x86_probe" -output "resources/ffmpeg/$FFPROBE_OUTPUT"
+          chmod +x "resources/ffmpeg/$FFMPEG_OUTPUT" "resources/ffmpeg/$FFPROBE_OUTPUT"
          rm -rf ffmpeg-arm ffmpeg-x86 ffmpeg-arm.zip ffmpeg-x86.zip

      - name: Download ffmpeg binary (Linux)
@@ -130,8 +152,10 @@ jobs:
          fi
          mkdir ffmpeg
          tar -xf ffmpeg.tar.xz -C ffmpeg
-          cp "ffmpeg/${{ matrix.ffmpeg_inner_path }}" "resources/${{ matrix.ffmpeg_output }}"
-          chmod +x "resources/${{ matrix.ffmpeg_output }}"
+          mkdir -p resources/ffmpeg
+          cp "ffmpeg/${{ matrix.ffmpeg_inner_path }}" "resources/ffmpeg/ffmpeg"
+          cp "ffmpeg/${{ matrix.ffprobe_inner_path }}" "resources/ffmpeg/ffprobe"
+          chmod +x "resources/ffmpeg/ffmpeg" "resources/ffmpeg/ffprobe"
          rm -rf ffmpeg.tar.xz ffmpeg

      - name: Download yt-dlp binary
@@ -230,5 +254,15 @@ jobs:
        uses: actions/upload-artifact@v4
        with:
          name: dist-${{ matrix.os }}
-          path: dist/
+          path: |
+            dist/*.exe
+            dist/*.zip
+            dist/*.dmg
+            dist/*.AppImage
+            dist/*.snap
+            dist/*.deb
+            dist/*.rpm
+            dist/*.tar.gz
+            dist/*.yml
+            dist/*.blockmap
          retention-days: 1
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -7,3 +7,5 @@ on:
 jobs:
  build:
    uses: ./.github/workflows/build.yml
+    with:
+      upload_artifacts: true
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -58,7 +58,7 @@ src/
 - Build production bundles with `pnpm build`.
 - Create platform-specific artifacts with `pnpm build:win`, `pnpm build:mac`, or `pnpm build:linux`.
 - Use `pnpm build:unpack` to generate unpacked directories under `dist/` for manual inspection.
- Bundle platform binaries of `yt-dlp` and `ffmpeg` under `resources/` (or set `YTDLP_PATH`/`FFMPEG_PATH`) before packaging so merges and audio extraction work out of the box.
+- Bundle platform binaries of `yt-dlp` and `ffmpeg/ffprobe` under `resources/ffmpeg/` (or set `YTDLP_PATH`/`FFMPEG_PATH`) before packaging so merges and audio extraction work out of the box.

 ## Working on Changes
 - Keep each pull request focused on a single problem or feature.
--- a/README.md
+++ b/README.md
@@ -26,48 +26,7 @@ VidBee is a modern, open-source video downloader that lets you download videos a

 VidBee is currently under active development, and feedback is welcome for any [issue](https://github.com/nexmoe/VidBee/issues) encountered.

-Feel free to try it using the following methods:
-
-<a href="https://vidbee.org/download/" target="_blank"><img src="https://img.shields.io/badge/Download-VidBee-369eff?style=flat-square&logo=github&logoColor=white&labelColor=black" height="55"/></a>
-
-### 🍎 macOS Installation Notes
-
-After downloading and installing VidBee on macOS, you may encounter a "file is damaged" error when trying to run the application. This is due to macOS security restrictions on applications downloaded from the internet.
-
-```bash
-xattr -rd com.apple.quarantine /Applications/VidBee.app/
-```
-
-This command removes the quarantine attribute that macOS applies to applications downloaded from the internet, allowing VidBee to run properly without the "file is damaged" error.
-
-### 🌐 Browser Script (Quick Download)
-
-For a more convenient downloading experience, you can install the VidBee browser script to add a quick download button directly on supported video websites.
-
-![VidBee Browser Script](screenshots/browser-script.png)
-
-**Installation:**
-
-1. Install a userscript manager extension:
-   - [Tampermonkey](https://www.tampermonkey.net/) (Recommended)
-   - [Violentmonkey](https://violentmonkey.github.io/)
-   - [Greasemonkey](https://www.greasespot.net/)
-
-2. Install the VidBee Quick Download script:
-   - [Install from Greasy Fork](https://greasyfork.org/zh-CN/scripts/559595-vidbee-quick-download)
-
-**Usage:**
-
-After installation, when you visit supported video websites (YouTube, Bilibili, TikTok, Instagram, Twitter, etc.), a download button will appear on the page. Click the button to quickly send the video URL to VidBee desktop app for downloading.
-
-**Supported Sites:**
-
-The script works on popular video platforms including:
-
- YouTube, Bilibili, TikTok, Vimeo, Dailymotion
- Twitch, Twitter/X, Instagram, Facebook
- Reddit, SoundCloud, Niconico, Kick
- Bandcamp, Mixcloud, and more
+[📥 Download VidBee](https://vidbee.org/download/) | [📚 Documentation](https://docs.vidbee.org)

 > [!IMPORTANT]
 >
@@ -102,29 +61,14 @@ Automatically subscribe to RSS feeds and auto-download new videos in the backgro

 ## 🌐 Supported Sites

-VidBee supports hundreds of video and audio platforms through yt-dlp. Here are the most popular platforms:
-
-| Video Platforms | Audio & Other Platforms |
-| :--------------- | :---------------------- |
-| YouTube          | YouTube Music           |
-| TikTok           | SoundCloud              |
-| Facebook         | Mixcloud                |
-| Instagram        | Bandcamp                |
-| X (Twitter)      | Reddit                  |
-| Vimeo            |                         |
-| Dailymotion      |                         |
-| Twitch           |                         |
-| LinkedIn         |                         |
-| Pinterest        |                         |
-| Tumblr           |                         |
-| Niconico         |                         |
-| Kick             |                         |
-
-> **💡 Note:** VidBee uses [yt-dlp](https://github.com/yt-dlp/yt-dlp) under the hood, which supports 1000+ sites. For the complete list, visit the [yt-dlp supported sites documentation](https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md).
+VidBee supports 1000+ video and audio platforms through yt-dlp. For the complete list of supported sites, visit [https://vidbee.org/supported-sites/](https://vidbee.org/supported-sites/)

 ## 🤝 Contributing

-You are welcome to join the open source community to build together. Please check our [Contributing Guide](./CONTRIBUTING.md) for more details.
+You are welcome to join the open source community to build together. For more details, check out:
+
+- [Contributing Guide](./CONTRIBUTING.md)
+- [DeepWiki Documentation](https://deepwiki.com/nexmoe/VidBee)

 ## 📄 License

--- a/biome.json
+++ b/biome.json
@@ -45,12 +45,13 @@
      "**/*.js",
      "**/*.jsx",
      "**/*.json",
+      "!docs",
      "!monkey/dist",
      "!dist",
      "!out",
      "!build"
    ],
-    "experimentalScannerIgnores": ["monkey/dist/**", "dist/**", "out/**", "build/**"]
+    "experimentalScannerIgnores": ["docs/**", "monkey/dist/**", "dist/**", "out/**", "build/**"]
  },
  "vcs": {
    "enabled": true,
--- a/build/after-pack.cjs
+++ b/build/after-pack.cjs
@@ -2,7 +2,12 @@ const { execFileSync } = require('node:child_process')
 const fs = require('node:fs')
 const path = require('node:path')

-const BINARIES = ['yt-dlp_macos', 'ffmpeg_macos', 'deno']
+const BINARIES = [
+  'yt-dlp_macos',
+  path.join('ffmpeg', 'ffmpeg'),
+  path.join('ffmpeg', 'ffprobe'),
+  'deno'
+]

 const findAppBundle = (appOutDir) => {
  const entries = fs.readdirSync(appOutDir)
--- a/docs/.gitignore
+++ b/docs/.gitignore
@@ -0,0 +1,26 @@
+# deps
+/node_modules
+
+# generated content
+.source
+
+# test & build
+/coverage
+/.next/
+/out/
+/build
+*.tsbuildinfo
+
+# misc
+.DS_Store
+*.pem
+/.pnp
+.pnp.js
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# others
+.env*.local
+.vercel
+next-env.d.ts
--- a/docs/README.md
+++ b/docs/README.md
@@ -0,0 +1,45 @@
+# docs
+
+This is a Next.js application generated with
+[Create Fumadocs](https://github.com/fuma-nama/fumadocs).
+
+Run development server:
+
+```bash
+npm run dev
+# or
+pnpm dev
+# or
+yarn dev
+```
+
+Open http://localhost:3000 with your browser to see the result.
+
+## Explore
+
+In the project, you can see:
+
+- `lib/source.ts`: Code for content source adapter, [`loader()`](https://fumadocs.dev/docs/headless/source-api) provides the interface to access your content.
+- `lib/layout.shared.tsx`: Shared options for layouts, optional but preferred to keep.
+
+| Route                     | Description                                            |
+| ------------------------- | ------------------------------------------------------ |
+| `app/(home)`              | The route group for your landing page and other pages. |
+| `app/docs`                | The documentation layout and pages.                    |
+| `app/api/search/route.ts` | The Route Handler for search.                          |
+
+### Fumadocs MDX
+
+A `source.config.ts` config file has been included, you can customise different options like frontmatter schema.
+
+Read the [Introduction](https://fumadocs.dev/docs/mdx) for further details.
+
+## Learn More
+
+To learn more about Next.js and Fumadocs, take a look at the following
+resources:
+
+- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js
+  features and API.
+- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
+- [Fumadocs](https://fumadocs.dev) - learn about Fumadocs
--- a/docs/biome.config.json
+++ b/docs/biome.config.json
@@ -0,0 +1,41 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.2.0/schema.json",
+  "vcs": {
+    "enabled": true,
+    "clientKind": "git",
+    "useIgnoreFile": true
+  },
+  "files": {
+    "ignoreUnknown": true,
+    "includes": [
+      "**",
+      "!node_modules",
+      "!.next",
+      "!dist",
+      "!build",
+      "!.source"
+    ]
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true
+    },
+    "domains": {
+      "next": "recommended",
+      "react": "recommended"
+    }
+  },
+  "assist": {
+    "actions": {
+      "source": {
+        "organizeImports": "on"
+      }
+    }
+  }
+}
--- a/docs/content/cookies.mdx
+++ b/docs/content/cookies.mdx
@@ -0,0 +1,59 @@
+---
+title: Cookies
+description: Signed-in downloads, restricted content, and cookie setup
+---
+
+Cookies reuse your browser's signed-in session so VidBee can download content that requires login or verification, such as subscriber-only items, age-gated pages, or private links.
+
+## When you need cookies
+
+- Content that requires an account to view or download.
+- Age-gated or region-locked pages.
+- Private links or lists visible only to signed-in users.
+
+## Two ways to use cookies in VidBee
+
+### Option 1: Read cookies from your browser
+
+In **Settings**, select your browser. VidBee will try to detect the browser profile path automatically. You can also enter the profile path manually.
+
+**Supported browsers (platform dependent):**
+
+- **Windows: Firefox only. Other browsers cannot be used for cookie reading.**
+- macOS: Safari, Chrome, Edge, Brave, Firefox, and more.
+- Linux: Chrome, Chromium, Brave, Firefox, and more.
+
+**Steps:**
+
+1. Open VidBee → Settings → Cookies.
+2. Select a browser and confirm the profile path.
+3. Go back and start the download again.
+
+If detection fails or the path is invalid, manually choose the actual browser profile directory.
+On Windows, if you are not using Firefox, switch to the cookies file method.
+
+### Option 2: Import a cookies file
+
+You can import a **Netscape-formatted** cookies file. This is useful when reading the browser profile is not possible.
+
+**Steps:**
+
+1. Export a Netscape cookies file using a browser extension.
+2. Open VidBee → Settings → Cookies file, and select the exported file.
+3. Click Clear to disable it.
+
+## Recommendations
+
+- Prefer browser-based cookies when possible, because it's easier to maintain.
+- If browser reading fails, switch to a cookies file.
+- Cookies files expire. Re-export when your account state changes.
+
+## Troubleshooting
+
+- **Profile path is invalid**: Ensure the folder exists and points to the real browser profile directory.
+- **Still asks for login**: Confirm your browser is signed in and re-save the setting.
+- **Browser read failed**: Close the browser and retry, or switch to a cookies file.
+
+## Privacy and security
+
+Cookies are equivalent to your login session. Keep them private and never share or upload them. If you suspect leakage, sign out and change your password.
--- a/docs/content/faq.mdx
+++ b/docs/content/faq.mdx
@@ -0,0 +1,36 @@
+---
+title: FAQ
+description: Common questions and troubleshooting for VidBee
+---
+
+## What if a download fails or shows an error?
+
+- Confirm the link is valid and opens in your browser.
+- Update VidBee to the latest version and retry.
+- If the content requires login or age verification, configure cookies.
+
+## Why does the same link sometimes work and sometimes fail?
+
+Some sites frequently change page structure or limit request rates. Suggested steps:
+
+- Make sure VidBee is up to date.
+- Reduce the number of concurrent downloads.
+- Use cookies to reuse your signed-in session when needed.
+
+## Which sites are supported?
+
+VidBee uses the yt-dlp extractor system and supports many sites. Try the download first; if it fails, submit feedback with the link and error details.
+
+## Why is the download speed slow?
+
+- Check your network and proxy settings.
+- Avoid starting too many tasks at once.
+- Some sites limit bandwidth on their side.
+
+## macOS says “file is damaged”
+
+Remove the quarantine attribute and retry:
+
+```bash
+xattr -rd com.apple.quarantine /Applications/VidBee.app/
+```
--- a/docs/content/index.mdx
+++ b/docs/content/index.mdx
@@ -0,0 +1,19 @@
+---
+title: VidBee Docs
+description: VidBee desktop downloader documentation and FAQ
+---
+
+VidBee is a desktop downloader built with Electron and powered by yt-dlp. It provides a clean interface and queue management for downloading video and audio.
+
+These docs focus on real-world usage and settings, especially signed-in downloads and cookie configuration.
+
+## Start here
+
+- [Cookies](./cookies.mdx): Configure signed-in sessions and restricted content.
+- [FAQ](./faq.mdx): Common questions and troubleshooting.
+
+## Quick links
+
+- [VidBee website](https://vidbee.org/)
+- [Supported sites](https://vidbee.org/supported-sites/)
+- [Features](https://vidbee.org/features/)
--- a/docs/content/meta.json
+++ b/docs/content/meta.json
@@ -0,0 +1,4 @@
+{
+  "title": "VidBee Docs",
+  "pages": ["index", "cookies", "faq"]
+}
--- a/docs/content/zh/cookies.mdx
+++ b/docs/content/zh/cookies.mdx
@@ -0,0 +1,59 @@
+---
+title: Cookie 使用说明
+description: 登录下载、受限内容与 Cookie 配置
+---
+
+Cookie 用于复用浏览器的登录态，帮助 VidBee 下载需要登录或验证的内容，例如订阅内容、年龄限制或私密链接。
+
+## 适用场景
+
+- 需要账号登录才能观看或下载的内容。
+- 年龄限制或地区限制页面。
+- 仅对登录用户可见的私密链接或列表。
+
+## VidBee 支持的两种方式
+
+### 方式一：读取浏览器 Cookie
+
+在 **设置** 中选择你的浏览器，VidBee 会尝试自动识别浏览器配置文件路径。你也可以手动填写配置文件路径。
+
+**支持的浏览器（按平台差异显示）：**
+
+- **Windows：仅支持 Firefox。其他浏览器无法读取 Cookie。**
+- macOS：Safari、Chrome、Edge、Brave、Firefox 等。
+- Linux：Chrome、Chromium、Brave、Firefox 等。
+
+**使用步骤：**
+
+1. 打开 VidBee → 设置 → Cookie。
+2. 选择浏览器并确认配置文件路径。
+3. 返回下载页面，重新开始下载任务。
+
+如果识别失败或路径无效，请手动选择实际的浏览器配置文件目录。
+在 Windows 上，如果不是 Firefox，请改用 cookies 文件方式。
+
+### 方式二：导入 Cookies 文件
+
+你也可以导入 **Netscape 格式** 的 cookies 文件。这个方式适合在不方便读取浏览器配置文件时使用。
+
+**使用步骤：**
+
+1. 使用浏览器扩展导出 Netscape cookies 文件。
+2. 打开 VidBee → 设置 → Cookies 文件，选择导出的文件。
+3. 如需停用，可点击“清除”。
+
+## 使用建议
+
+- 优先使用浏览器读取方式，维护成本更低。
+- 如果浏览器读取失败，再切换到 cookies 文件方式。
+- cookies 文件会过期，账号状态变化时需要重新导出。
+
+## 常见问题
+
+- **提示配置文件路径无效**：请确认路径存在，并指向实际的浏览器配置文件目录。
+- **下载仍提示需要登录**：确认当前浏览器已登录对应账号，并重新保存设置。
+- **浏览器读取失败**：关闭浏览器后重试，或改用 cookies 文件方式。
+
+## 隐私与安全
+
+Cookie 等同于登录态，请妥善保管，不要共享或上传。若怀疑泄露，请及时在网站上退出登录并更新密码。
--- a/docs/content/zh/faq.mdx
+++ b/docs/content/zh/faq.mdx
@@ -0,0 +1,36 @@
+---
+title: 常见问题 (FAQ)
+description: VidBee 使用过程中的常见问题与建议
+---
+
+## 下载失败或报错怎么办？
+
+- 先确认链接是否有效，并尝试在浏览器中打开。
+- 升级 VidBee 到最新版本后重试。
+- 如果是登录或年龄限制内容，请配置 Cookie。
+
+## 为什么同一个链接有时可以、有时不行？
+
+部分站点会频繁更新页面结构或限制请求频率。建议：
+
+- 确保 VidBee 为最新版本。
+- 适当降低同时下载任务数量。
+- 必要时使用 Cookie 复用登录态。
+
+## 支持哪些网站？
+
+VidBee 基于 yt-dlp 解析器体系，覆盖大量站点。可以先尝试下载；若失败，请提交反馈并附上链接与错误提示。
+
+## 下载速度慢怎么办？
+
+- 检查本地网络与代理设置。
+- 避免同时发起过多任务。
+- 某些站点本身带宽较低，速度受限。
+
+## macOS 提示“文件已损坏”
+
+请执行以下命令移除隔离标记后重试：
+
+```bash
+xattr -rd com.apple.quarantine /Applications/VidBee.app/
+```
--- a/docs/content/zh/index.mdx
+++ b/docs/content/zh/index.mdx
@@ -0,0 +1,19 @@
+---
+title: VidBee 文档
+description: VidBee 桌面下载器使用说明与常见问题
+---
+
+VidBee 是一款基于 Electron 的桌面下载器，内置 yt-dlp 引擎，提供清爽的界面与队列管理能力，用于下载视频与音频内容。
+
+这份文档聚焦 VidBee 的实际使用场景与设置说明，尤其是登录下载与 Cookie 相关配置。
+
+## 从这里开始
+
+- [Cookie 使用](./cookies.mdx)：登录态与限制内容的下载配置。
+- [常见问题](./faq.mdx)：常见问题与排查思路。
+
+## 快捷链接
+
+- [VidBee 官网](https://vidbee.org/)
+- [支持站点](https://vidbee.org/supported-sites/)
+- [功能介绍](https://vidbee.org/features/)
--- a/docs/content/zh/meta.json
+++ b/docs/content/zh/meta.json
@@ -0,0 +1,4 @@
+{
+  "title": "VidBee 文档",
+  "pages": ["index", "cookies", "faq"]
+}
--- a/docs/next.config.mjs
+++ b/docs/next.config.mjs
@@ -0,0 +1,15 @@
+import { createMDX } from 'fumadocs-mdx/next';
+
+const withMDX = createMDX();
+
+/** @type {import('next').NextConfig} */
+const config = {
+  output: 'export',
+  reactStrictMode: true,
+  // Use trailing slashes to avoid conflicts with route handlers that have file extensions
+  trailingSlash: true,
+  // Note: rewrites are not supported with static export
+  // The /llms.mdx route will be pre-rendered as static files
+};
+
+export default withMDX(config);
--- a/docs/package.json
+++ b/docs/package.json
@@ -0,0 +1,36 @@
+{
+  "name": "docs",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "build": "next build && node scripts/post-export.js",
+    "dev": "next dev",
+    "start": "next start",
+    "types:check": "fumadocs-mdx && next typegen && tsc --noEmit",
+    "postinstall": "fumadocs-mdx",
+    "lint": "biome check --config-path biome.config.json",
+    "format": "biome format --write --config-path biome.config.json"
+  },
+  "dependencies": {
+    "fumadocs-core": "16.4.7",
+    "fumadocs-mdx": "14.2.5",
+    "fumadocs-ui": "16.4.7",
+    "lucide-react": "^0.562.0",
+    "next": "16.1.1",
+    "react": "^19.2.3",
+    "react-dom": "^19.2.3",
+    "tailwind-merge": "^3.4.0"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "^4.1.18",
+    "@types/mdx": "^2.0.13",
+    "@types/node": "^25.0.5",
+    "@types/react": "^19.2.8",
+    "@types/react-dom": "^19.2.3",
+    "postcss": "^8.5.6",
+    "tailwindcss": "^4.1.18",
+    "typescript": "^5.9.3",
+    "@biomejs/biome": "^2.3.11"
+  }
+}
--- a/docs/pnpm-lock.yaml
+++ b/docs/pnpm-lock.yaml
--- a/docs/postcss.config.mjs
+++ b/docs/postcss.config.mjs
@@ -0,0 +1,5 @@
+export default {
+  plugins: {
+    '@tailwindcss/postcss': {},
+  },
+};
--- a/docs/scripts/post-export.js
+++ b/docs/scripts/post-export.js
@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+
+/**
+ * Post-export script to copy English content to root directory
+ * This allows the default language (en) to be accessible without language prefix
+ */
+
+import { cpSync, existsSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = fileURLToPath(new URL('.', import.meta.url));
+const outDir = join(__dirname, '../out');
+const enDir = join(outDir, 'en');
+
+console.log('Copying English content to root directory...');
+
+if (!existsSync(enDir)) {
+  console.error('Error: /en directory not found in output');
+  process.exit(1);
+}
+
+// Get all items in /en directory
+const fs = await import('node:fs/promises');
+const items = await fs.readdir(enDir);
+
+// Copy each item to root, excluding already existing root items
+for (const item of items) {
+  const source = join(enDir, item);
+  const dest = join(outDir, item);
+
+  // Skip if item already exists at root (like _next, api, etc.)
+  if (existsSync(dest)) {
+    console.log(`Skipping ${item} (already exists at root)`);
+    continue;
+  }
+
+  try {
+    cpSync(source, dest, { recursive: true });
+    console.log(`Copied ${item}`);
+  } catch (error) {
+    console.error(`Error copying ${item}:`, error.message);
+  }
+}
+
+console.log('English content copied to root directory successfully!');
--- a/docs/source.config.ts
+++ b/docs/source.config.ts
@@ -0,0 +1,22 @@
+import { defineConfig, defineDocs, frontmatterSchema, metaSchema } from 'fumadocs-mdx/config';
+
+// You can customise Zod schemas for frontmatter and `meta.json` here
+// see https://fumadocs.dev/docs/mdx/collections
+export const docs = defineDocs({
+  dir: 'content',
+  docs: {
+    schema: frontmatterSchema,
+    postprocess: {
+      includeProcessedMarkdown: true,
+    },
+  },
+  meta: {
+    schema: metaSchema,
+  },
+});
+
+export default defineConfig({
+  mdxOptions: {
+    // MDX options
+  },
+});
--- a/docs/src/app/[lang]/(docs)/[[...slug]]/page.tsx
+++ b/docs/src/app/[lang]/(docs)/[[...slug]]/page.tsx
@@ -0,0 +1,67 @@
+import { getPageImage, source } from '@/lib/source';
+import { DocsBody, DocsDescription, DocsPage, DocsTitle } from 'fumadocs-ui/layouts/docs/page';
+import { notFound } from 'next/navigation';
+import { getMDXComponents } from '@/mdx-components';
+import type { Metadata } from 'next';
+import { createRelativeLink } from 'fumadocs-ui/mdx';
+import { GitHubEditButton, LLMCopyButton, ViewOptions } from '@/components/ai/page-actions';
+
+export default async function Page(props: PageProps<'/[lang]/[[...slug]]'>) {
+  const params = await props.params;
+  const page = source.getPage(params.slug, params.lang);
+  if (!page) notFound();
+
+  const MDX = page.data.body;
+  const gitConfig = {
+    user: 'nexmoe',
+    repo: 'VidBee',
+    branch: 'main',
+  };
+
+  const githubFilePath = `docs/content/${page.path}`;
+  const githubBlobUrl = `https://github.com/${gitConfig.user}/${gitConfig.repo}/blob/${gitConfig.branch}/${githubFilePath}`;
+  const githubEditUrl = `https://github.com/${gitConfig.user}/${gitConfig.repo}/edit/${gitConfig.branch}/${githubFilePath}`;
+
+  return (
+    <DocsPage toc={page.data.toc} full={page.data.full}>
+      <DocsTitle>{page.data.title}</DocsTitle>
+      <DocsDescription className="mb-0">{page.data.description}</DocsDescription>
+      <div className="flex flex-row gap-2 items-center border-b pb-6">
+        <GitHubEditButton href={githubEditUrl} />
+        <LLMCopyButton markdownUrl={`${page.url}.mdx`} />
+        <ViewOptions
+          markdownUrl={`${page.url}.mdx`}
+          githubUrl={githubBlobUrl}
+        />
+      </div>
+      <DocsBody>
+        <MDX
+          components={getMDXComponents({
+            // this allows you to link to other pages with relative file paths
+            a: createRelativeLink(source, page),
+          })}
+        />
+      </DocsBody>
+    </DocsPage>
+  );
+}
+
+export async function generateStaticParams() {
+  return source.generateParams();
+}
+
+export async function generateMetadata(
+  props: PageProps<'/[lang]/[[...slug]]'>,
+): Promise<Metadata> {
+  const params = await props.params;
+  const page = source.getPage(params.slug, params.lang);
+  if (!page) notFound();
+
+  return {
+    title: page.data.title,
+    description: page.data.description,
+    openGraph: {
+      images: getPageImage(page).url,
+    },
+  };
+}
--- a/docs/src/app/[lang]/(docs)/layout.tsx
+++ b/docs/src/app/[lang]/(docs)/layout.tsx
@@ -0,0 +1,20 @@
+import type { ReactNode } from 'react';
+import { source } from '@/lib/source';
+import { DocsLayout } from 'fumadocs-ui/layouts/docs';
+import { baseOptions } from '@/lib/layout.shared';
+
+export default async function Layout({
+  children,
+  params,
+}: {
+  children: ReactNode;
+  params: Promise<{ lang: string; slug?: string[] }>;
+}) {
+  const resolvedParams = await params;
+  const locale = resolvedParams.lang;
+  return (
+    <DocsLayout tree={source.getPageTree(locale)} {...baseOptions(locale)}>
+      {children}
+    </DocsLayout>
+  );
+}
--- a/docs/src/app/[lang]/layout.tsx
+++ b/docs/src/app/[lang]/layout.tsx
@@ -0,0 +1,39 @@
+import type { ReactNode } from 'react';
+import { RootProvider } from 'fumadocs-ui/provider/next';
+import { defineI18nUI } from 'fumadocs-ui/i18n';
+import { i18n, isLocale } from '@/lib/i18n';
+
+const { provider } = defineI18nUI(i18n, {
+  translations: {
+    en: {
+      displayName: 'English',
+    },
+    zh: {
+      displayName: '中文',
+    },
+  },
+});
+
+export default async function Layout({
+  children,
+  params,
+}: {
+  children: ReactNode;
+  params: Promise<{ lang: string }>;
+}) {
+  const { lang } = await params;
+  const locale = isLocale(lang) ? lang : i18n.defaultLanguage;
+
+  return (
+    <RootProvider
+      i18n={provider(locale)}
+      search={{
+        options: {
+          type: 'static',
+        },
+      }}
+    >
+      {children}
+    </RootProvider>
+  );
+}
--- a/docs/src/app/api/search/route.ts
+++ b/docs/src/app/api/search/route.ts
@@ -0,0 +1,14 @@
+import { source } from '@/lib/source';
+import { createFromSource } from 'fumadocs-core/search/server';
+
+// statically cached for static export
+export const revalidate = false;
+
+// Configure language support for both English and Chinese
+export const { staticGET: GET } = createFromSource(source, {
+  localeMap: {
+    en: { language: 'english' },
+    // Chinese is not natively supported by Orama, use English tokenizer for zh
+    zh: { language: 'english' },
+  },
+});
--- a/docs/src/app/global.css
+++ b/docs/src/app/global.css
@@ -0,0 +1,3 @@
+@import 'tailwindcss';
+@import 'fumadocs-ui/css/neutral.css';
+@import 'fumadocs-ui/css/preset.css';
--- a/docs/src/app/layout.tsx
+++ b/docs/src/app/layout.tsx
@@ -0,0 +1,26 @@
+import './global.css';
+import { Inter } from 'next/font/google';
+import type { ReactNode } from 'react';
+import { i18n, isLocale } from '@/lib/i18n';
+
+const inter = Inter({
+  subsets: ['latin'],
+});
+
+export default async function Layout({
+  children,
+  params,
+}: {
+  children: ReactNode;
+  params?: Promise<{ lang?: string }>;
+}) {
+  const resolvedParams = params ? await params : undefined;
+  const lang = isLocale(resolvedParams?.lang) ? resolvedParams.lang : i18n.defaultLanguage;
+  return (
+    <html lang={lang} className={inter.className} suppressHydrationWarning>
+      <body className="flex flex-col min-h-screen">
+        {children}
+      </body>
+    </html>
+  );
+}
--- a/docs/src/components/ai/page-actions.tsx
+++ b/docs/src/components/ai/page-actions.tsx
@@ -0,0 +1,250 @@
+'use client';
+import { useMemo, useState } from 'react';
+import { Check, ChevronDown, Copy, ExternalLinkIcon, MessageCircleIcon } from 'lucide-react';
+import { cn } from '@/lib/cn';
+import { useCopyButton } from 'fumadocs-ui/utils/use-copy-button';
+import { buttonVariants } from 'fumadocs-ui/components/ui/button';
+import { Popover, PopoverContent, PopoverTrigger } from 'fumadocs-ui/components/ui/popover';
+
+const cache = new Map<string, string>();
+
+export function LLMCopyButton({
+  /**
+   * A URL to fetch the raw Markdown/MDX content of page
+   */
+  markdownUrl,
+}: {
+  markdownUrl: string;
+}) {
+  const [isLoading, setLoading] = useState(false);
+  const [checked, onClick] = useCopyButton(async () => {
+    const cached = cache.get(markdownUrl);
+    if (cached) return navigator.clipboard.writeText(cached);
+
+    setLoading(true);
+
+    try {
+      await navigator.clipboard.write([
+        new ClipboardItem({
+          'text/plain': fetch(markdownUrl).then(async (res) => {
+            const content = await res.text();
+            cache.set(markdownUrl, content);
+
+            return content;
+          }),
+        }),
+      ]);
+    } finally {
+      setLoading(false);
+    }
+  });
+
+  return (
+    <button
+      disabled={isLoading}
+      className={cn(
+        buttonVariants({
+          color: 'secondary',
+          size: 'sm',
+          className: 'gap-2 [&_svg]:size-3.5 [&_svg]:text-fd-muted-foreground',
+        }),
+      )}
+      onClick={onClick}
+    >
+      {checked ? <Check /> : <Copy />}
+      Copy Markdown
+    </button>
+  );
+}
+
+export function ViewOptions({
+  markdownUrl,
+  githubUrl,
+}: {
+  /**
+   * A URL to the raw Markdown/MDX content of page
+   */
+  markdownUrl: string;
+
+  /**
+   * Source file URL on GitHub
+   */
+  githubUrl: string;
+}) {
+  const items = useMemo(() => {
+    const fullMarkdownUrl =
+      typeof window !== 'undefined' ? new URL(markdownUrl, window.location.origin) : 'loading';
+    const q = `Read ${fullMarkdownUrl}, I want to ask questions about it.`;
+
+    return [
+      {
+        title: 'Open in GitHub',
+        href: githubUrl,
+        icon: (
+          <svg fill="currentColor" role="img" viewBox="0 0 24 24">
+            <title>GitHub</title>
+            <path d="M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.385.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729 1.205.084 1.838 1.236 1.838 1.236 1.07 1.835 2.809 1.305 3.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.465-2.38 1.235-3.22-.135-.303-.54-1.523.105-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.399 3-.405 1.02.006 2.04.138 3 .405 2.28-1.552 3.285-1.23 3.285-1.23.645 1.653.24 2.873.12 3.176.765.84 1.23 1.91 1.23 3.22 0 4.61-2.805 5.625-5.475 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12" />
+          </svg>
+        ),
+      },
+      {
+        title: 'Open in Scira AI',
+        href: `https://scira.ai/?${new URLSearchParams({
+          q,
+        })}`,
+        icon: (
+          <svg
+            width="910"
+            height="934"
+            viewBox="0 0 910 934"
+            fill="none"
+            xmlns="http://www.w3.org/2000/svg"
+          >
+            <title>Scira AI</title>
+            <path
+              d="M647.664 197.775C569.13 189.049 525.5 145.419 516.774 66.8849C508.048 145.419 464.418 189.049 385.884 197.775C464.418 206.501 508.048 250.131 516.774 328.665C525.5 250.131 569.13 206.501 647.664 197.775Z"
+              fill="currentColor"
+              stroke="currentColor"
+              strokeWidth="8"
+              strokeLinejoin="round"
+            />
+            <path
+              d="M516.774 304.217C510.299 275.491 498.208 252.087 480.335 234.214C462.462 216.341 439.058 204.251 410.333 197.775C439.059 191.3 462.462 179.209 480.335 161.336C498.208 143.463 510.299 120.06 516.774 91.334C523.25 120.059 535.34 143.463 553.213 161.336C571.086 179.209 594.49 191.3 623.216 197.775C594.49 204.251 571.086 216.341 553.213 234.214C535.34 252.087 523.25 275.491 516.774 304.217Z"
+              fill="currentColor"
+              stroke="currentColor"
+              strokeWidth="8"
+              strokeLinejoin="round"
+            />
+            <path
+              d="M857.5 508.116C763.259 497.644 710.903 445.288 700.432 351.047C689.961 445.288 637.605 497.644 543.364 508.116C637.605 518.587 689.961 570.943 700.432 665.184C710.903 570.943 763.259 518.587 857.5 508.116Z"
+              stroke="currentColor"
+              strokeWidth="20"
+              strokeLinejoin="round"
+            />
+            <path
+              d="M700.432 615.957C691.848 589.05 678.575 566.357 660.383 548.165C642.191 529.973 619.499 516.7 592.593 508.116C619.499 499.533 642.191 486.258 660.383 468.066C678.575 449.874 691.848 427.181 700.432 400.274C709.015 427.181 722.289 449.874 740.481 468.066C758.673 486.258 781.365 499.533 808.271 508.116C781.365 516.7 758.673 529.973 740.481 548.165C722.289 566.357 709.015 589.05 700.432 615.957Z"
+              stroke="currentColor"
+              strokeWidth="20"
+              strokeLinejoin="round"
+            />
+            <path
+              d="M889.949 121.237C831.049 114.692 798.326 81.9698 791.782 23.0692C785.237 81.9698 752.515 114.692 693.614 121.237C752.515 127.781 785.237 160.504 791.782 219.404C798.326 160.504 831.049 127.781 889.949 121.237Z"
+              fill="currentColor"
+              stroke="currentColor"
+              strokeWidth="8"
+              strokeLinejoin="round"
+            />
+            <path
+              d="M791.782 196.795C786.697 176.937 777.869 160.567 765.16 147.858C752.452 135.15 736.082 126.322 716.226 121.237C736.082 116.152 752.452 107.324 765.16 94.6152C777.869 81.9065 786.697 65.5368 791.782 45.6797C796.867 65.5367 805.695 81.9066 818.403 94.6152C831.112 107.324 847.481 116.152 867.338 121.237C847.481 126.322 831.112 135.15 818.403 147.858C805.694 160.567 796.867 176.937 791.782 196.795Z"
+              fill="currentColor"
+              stroke="currentColor"
+              strokeWidth="8"
+              strokeLinejoin="round"
+            />
+            <path
+              d="M760.632 764.337C720.719 814.616 669.835 855.1 611.872 882.692C553.91 910.285 490.404 924.255 426.213 923.533C362.022 922.812 298.846 907.419 241.518 878.531C184.19 849.643 134.228 808.026 95.4548 756.863C56.6815 705.7 30.1238 646.346 17.8129 583.343C5.50207 520.339 7.76433 455.354 24.4266 393.359C41.089 331.364 71.7099 274.001 113.947 225.658C156.184 177.315 208.919 139.273 268.117 114.442"
+              stroke="currentColor"
+              strokeWidth="30"
+              strokeLinecap="round"
+              strokeLinejoin="round"
+            />
+          </svg>
+        ),
+      },
+      {
+        title: 'Open in ChatGPT',
+        href: `https://chatgpt.com/?${new URLSearchParams({
+          hints: 'search',
+          q,
+        })}`,
+        icon: (
+          <svg
+            role="img"
+            viewBox="0 0 24 24"
+            fill="currentColor"
+            xmlns="http://www.w3.org/2000/svg"
+          >
+            <title>OpenAI</title>
+            <path d="M22.2819 9.8211a5.9847 5.9847 0 0 0-.5157-4.9108 6.0462 6.0462 0 0 0-6.5098-2.9A6.0651 6.0651 0 0 0 4.9807 4.1818a5.9847 5.9847 0 0 0-3.9977 2.9 6.0462 6.0462 0 0 0 .7427 7.0966 5.98 5.98 0 0 0 .511 4.9107 6.051 6.051 0 0 0 6.5146 2.9001A5.9847 5.9847 0 0 0 13.2599 24a6.0557 6.0557 0 0 0 5.7718-4.2058 5.9894 5.9894 0 0 0 3.9977-2.9001 6.0557 6.0557 0 0 0-.7475-7.0729zm-9.022 12.6081a4.4755 4.4755 0 0 1-2.8764-1.0408l.1419-.0804 4.7783-2.7582a.7948.7948 0 0 0 .3927-.6813v-6.7369l2.02 1.1686a.071.071 0 0 1 .038.052v5.5826a4.504 4.504 0 0 1-4.4945 4.4944zm-9.6607-4.1254a4.4708 4.4708 0 0 1-.5346-3.0137l.142.0852 4.783 2.7582a.7712.7712 0 0 0 .7806 0l5.8428-3.3685v2.3324a.0804.0804 0 0 1-.0332.0615L9.74 19.9502a4.4992 4.4992 0 0 1-6.1408-1.6464zM2.3408 7.8956a4.485 4.485 0 0 1 2.3655-1.9728V11.6a.7664.7664 0 0 0 .3879.6765l5.8144 3.3543-2.0201 1.1685a.0757.0757 0 0 1-.071 0l-4.8303-2.7865A4.504 4.504 0 0 1 2.3408 7.872zm16.5963 3.8558L13.1038 8.364 15.1192 7.2a.0757.0757 0 0 1 .071 0l4.8303 2.7913a4.4944 4.4944 0 0 1-.6765 8.1042v-5.6772a.79.79 0 0 0-.407-.667zm2.0107-3.0231l-.142-.0852-4.7735-2.7818a.7759.7759 0 0 0-.7854 0L9.409 9.2297V6.8974a.0662.0662 0 0 1 .0284-.0615l4.8303-2.7866a4.4992 4.4992 0 0 1 6.6802 4.66zM8.3065 12.863l-2.02-1.1638a.0804.0804 0 0 1-.038-.0567V6.0742a4.4992 4.4992 0 0 1 7.3757-3.4537l-.142.0805L8.704 5.459a.7948.7948 0 0 0-.3927.6813zm1.0976-2.3654l2.602-1.4998 2.6069 1.4998v2.9994l-2.5974 1.4997-2.6067-1.4997Z" />
+          </svg>
+        ),
+      },
+      {
+        title: 'Open in Claude',
+        href: `https://claude.ai/new?${new URLSearchParams({
+          q,
+        })}`,
+        icon: (
+          <svg
+            fill="currentColor"
+            role="img"
+            viewBox="0 0 24 24"
+            xmlns="http://www.w3.org/2000/svg"
+          >
+            <title>Anthropic</title>
+            <path d="M17.3041 3.541h-3.6718l6.696 16.918H24Zm-10.6082 0L0 20.459h3.7442l1.3693-3.5527h7.0052l1.3693 3.5528h3.7442L10.5363 3.5409Zm-.3712 10.2232 2.2914-5.9456 2.2914 5.9456Z" />
+          </svg>
+        ),
+      },
+      {
+        title: 'Open in T3 Chat',
+        href: `https://t3.chat/new?${new URLSearchParams({
+          q,
+        })}`,
+        icon: <MessageCircleIcon />,
+      },
+    ];
+  }, [githubUrl, markdownUrl]);
+
+  return (
+    <Popover>
+      <PopoverTrigger
+        className={cn(
+          buttonVariants({
+            color: 'secondary',
+            size: 'sm',
+            className: 'gap-2',
+          }),
+        )}
+      >
+        Open
+        <ChevronDown className="size-3.5 text-fd-muted-foreground" />
+      </PopoverTrigger>
+      <PopoverContent className="flex flex-col">
+        {items.map((item) => (
+          <a
+            key={item.href}
+            href={item.href}
+            rel="noreferrer noopener"
+            target="_blank"
+            className="text-sm p-2 rounded-lg inline-flex items-center gap-2 hover:text-fd-accent-foreground hover:bg-fd-accent [&_svg]:size-4"
+          >
+            {item.icon}
+            {item.title}
+            <ExternalLinkIcon className="text-fd-muted-foreground size-3.5 ms-auto" />
+          </a>
+        ))}
+      </PopoverContent>
+    </Popover>
+  );
+}
+
+export function GitHubEditButton({ href }: { href: string }) {
+  return (
+    <a
+      href={href}
+      rel="noreferrer noopener"
+      target="_blank"
+      className={cn(
+        buttonVariants({
+          color: 'secondary',
+          size: 'sm',
+          className: 'gap-2',
+        })
+      )}
+    >
+      <ExternalLinkIcon className="size-3.5 text-fd-muted-foreground" />
+      Edit on GitHub
+    </a>
+  )
+}
--- a/docs/src/lib/cn.ts
+++ b/docs/src/lib/cn.ts
@@ -0,0 +1 @@
+export { twMerge as cn } from 'tailwind-merge';
--- a/docs/src/lib/i18n.ts
+++ b/docs/src/lib/i18n.ts
@@ -0,0 +1,34 @@
+import { defineI18n } from 'fumadocs-core/i18n';
+
+export const i18n = defineI18n({
+  languages: ['en', 'zh'],
+  defaultLanguage: 'en',
+  // Hide locale prefix for default language (en) so English content appears at root
+  hideLocale: 'default-locale',
+  parser: 'dir'
+});
+
+export type Locale = (typeof i18n.languages)[number];
+
+const localeSet = new Set(i18n.languages);
+
+export function isLocale(value?: string): value is Locale {
+  return Boolean(value && localeSet.has(value as Locale));
+}
+
+export function resolveLocaleFromSlug(slug?: string[]): Locale {
+  if (slug && slug.length > 0 && isLocale(slug[0])) {
+    return slug[0];
+  }
+  return i18n.defaultLanguage;
+}
+
+export function stripLocaleFromSlug(slug?: string[]): string[] {
+  if (!slug || slug.length === 0) {
+    return [];
+  }
+  if (isLocale(slug[0])) {
+    return slug.slice(1);
+  }
+  return slug;
+}
--- a/docs/src/lib/layout.shared.tsx
+++ b/docs/src/lib/layout.shared.tsx
@@ -0,0 +1,11 @@
+import type { BaseLayoutProps } from 'fumadocs-ui/layouts/shared';
+import { i18n } from '@/lib/i18n';
+
+export function baseOptions(_locale: string): BaseLayoutProps {
+  return {
+    nav: {
+      title: 'VidBee',
+    },
+    i18n,
+  };
+}
--- a/docs/src/lib/source.ts
+++ b/docs/src/lib/source.ts
@@ -0,0 +1,31 @@
+import { docs } from 'fumadocs-mdx:collections/server';
+import { type InferPageType, loader } from 'fumadocs-core/source';
+import { lucideIconsPlugin } from 'fumadocs-core/source/lucide-icons';
+import { i18n } from '@/lib/i18n';
+
+// See https://fumadocs.dev/docs/headless/source-api for more info
+export const source = loader({
+  baseUrl: '/',
+  i18n,
+  source: docs.toFumadocsSource(),
+  plugins: [lucideIconsPlugin()],
+});
+
+export function getPageImage(page: InferPageType<typeof source>) {
+  const localePrefix =
+    page.locale && page.locale !== i18n.defaultLanguage ? [page.locale] : [];
+  const segments = [...localePrefix, ...page.slugs, 'image.png'];
+
+  return {
+    segments,
+    url: `/og/docs/${segments.join('/')}`,
+  };
+}
+
+export async function getLLMText(page: InferPageType<typeof source>) {
+  const processed = await page.data.getText('processed');
+
+  return `# ${page.data.title}
+
+${processed}`;
+}
--- a/docs/src/mdx-components.tsx
+++ b/docs/src/mdx-components.tsx
@@ -0,0 +1,9 @@
+import defaultMdxComponents from 'fumadocs-ui/mdx';
+import type { MDXComponents } from 'mdx/types';
+
+export function getMDXComponents(components?: MDXComponents): MDXComponents {
+  return {
+    ...defaultMdxComponents,
+    ...components,
+  };
+}
--- a/docs/src/middleware.ts
+++ b/docs/src/middleware.ts
@@ -0,0 +1,9 @@
+import { createI18nMiddleware } from 'fumadocs-core/i18n/middleware';
+import { i18n } from '@/lib/i18n';
+
+export default createI18nMiddleware(i18n);
+
+export const config = {
+  // Note: Middleware doesn't run in static export, but kept for development
+  matcher: ['/((?!api|_next/static|_next/image|favicon.ico).*)'],
+};
--- a/docs/tsconfig.json
+++ b/docs/tsconfig.json
@@ -0,0 +1,46 @@
+{
+  "compilerOptions": {
+    "baseUrl": ".",
+    "target": "ESNext",
+    "lib": [
+      "dom",
+      "dom.iterable",
+      "esnext"
+    ],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "forceConsistentCasingInFileNames": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "incremental": true,
+    "paths": {
+      "@/*": [
+        "./src/*"
+      ],
+      "fumadocs-mdx:collections/*": [
+        ".source/*"
+      ]
+    },
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ]
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    ".next/dev/types/**/*.ts"
+  ],
+  "exclude": [
+    "node_modules"
+  ]
+}
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
  "name": "vidbee",
-  "version": "1.1.12",
+  "version": "1.2.0",
  "description": "A modern Electron application for downloading videos and audios",
  "main": "./out/main/index.js",
  "author": "VidBee",
--- a/resources/.gitignore
+++ b/resources/.gitignore
@@ -6,6 +6,9 @@ ffmpeg.exe
 ffmpeg_macos
 ffmpeg_linux
 ffmpeg
+ffmpeg/
+ffprobe
+ffprobe.exe
 deno.exe
 deno

--- a/resources/README.md
+++ b/resources/README.md
@@ -48,27 +48,27 @@ Invoke-WebRequest -Uri "https://github.com/yt-dlp/yt-dlp/releases/latest/downloa
 Invoke-WebRequest -Uri "https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp" -OutFile "resources/yt-dlp_linux"
 ```

-## ffmpeg Binaries
+## ffmpeg/ffprobe Binaries

-ffmpeg is required for merging audio/video streams and audio extraction. Bundle the matching binary for each target platform:
+ffmpeg is required for merging audio/video streams and audio extraction. ffprobe is required for post-processing metadata. Bundle both binaries under `resources/ffmpeg/`.

 ### Required Files

-1. **Windows**: `ffmpeg.exe`
-2. **macOS**: `ffmpeg_macos`
-3. **Linux**: `ffmpeg_linux`
+1. **Windows**: `resources/ffmpeg/ffmpeg.exe` and `resources/ffmpeg/ffprobe.exe`
+2. **macOS**: `resources/ffmpeg/ffmpeg` and `resources/ffmpeg/ffprobe`
+3. **Linux**: `resources/ffmpeg/ffmpeg` and `resources/ffmpeg/ffprobe`

 ### How to Download

- **Windows / Linux**: Grab static builds from <https://ffmpeg.org/download.html> (or <https://github.com/yt-dlp/FFmpeg-Builds/releases>) and rename the binary to match the filenames above.
- **macOS**: Download the `ffmpeg-arm64*.zip` and `ffmpeg-x86_64*.zip` assets from <https://github.com/eko5624/mpv-mac/releases/latest>. Extract them and merge into a universal binary with `lipo -create`, then save the result as `resources/ffmpeg_macos`.
- On macOS/Linux ensure the final binary is executable: `chmod +x resources/ffmpeg_macos` (or `ffmpeg_linux`).
+- **Windows / Linux**: Grab static builds from <https://ffmpeg.org/download.html> (or <https://github.com/yt-dlp/FFmpeg-Builds/releases>) and copy `ffmpeg` and `ffprobe` into `resources/ffmpeg/`.
+- **macOS**: Download the `ffmpeg-*.zip` asset from <https://github.com/eko5624/mpv-mac/releases/latest>, then copy `ffmpeg` and `ffprobe` from the archive into `resources/ffmpeg/`.
+- On macOS/Linux ensure both binaries are executable: `chmod +x resources/ffmpeg/ffmpeg resources/ffmpeg/ffprobe`.

 ### Note

- Bundled binaries are required for Windows builds. On macOS/Linux the app can also use ffmpeg/yt-dlp from the system PATH.
- You can override the lookup paths via the `YTDLP_PATH` or `FFMPEG_PATH` environment variables if you prefer custom locations.
- File sizes: ~10-15 MB per yt-dlp binary, ~40-80 MB per ffmpeg binary
+- Bundled binaries are required for Windows builds. On macOS/Linux the app can also use ffmpeg/ffprobe from the system PATH.
+- You can override the lookup path via `FFMPEG_PATH`. It must point to a directory containing both `ffmpeg` and `ffprobe`.
+- File sizes: ~40-80 MB per ffmpeg build (ffmpeg + ffprobe)

 ## JS Runtime (Deno)

--- a/scripts/check-ytdlp.js
+++ b/scripts/check-ytdlp.js
@@ -23,10 +23,10 @@ if (!supportedPlatforms.includes(platform)) {
 const binaries = [
  {
    label: 'yt-dlp',
-    filenameMap: {
-      win: 'yt-dlp.exe',
-      mac: 'yt-dlp_macos',
-      linux: 'yt-dlp_linux'
+    paths: {
+      win: ['yt-dlp.exe'],
+      mac: ['yt-dlp_macos'],
+      linux: ['yt-dlp_linux']
    },
    help: {
      default: 'https://github.com/yt-dlp/yt-dlp/releases/latest'
@@ -34,10 +34,23 @@ const binaries = [
  },
  {
    label: 'ffmpeg',
-    filenameMap: {
-      win: 'ffmpeg.exe',
-      mac: 'ffmpeg_macos',
-      linux: 'ffmpeg_linux'
+    paths: {
+      win: ['ffmpeg/ffmpeg.exe'],
+      mac: ['ffmpeg/ffmpeg'],
+      linux: ['ffmpeg/ffmpeg']
+    },
+    help: {
+      win: 'https://ffmpeg.org/download.html',
+      linux: 'https://ffmpeg.org/download.html',
+      mac: 'https://github.com/eko5624/mpv-mac/releases/latest'
+    }
+  },
+  {
+    label: 'ffprobe',
+    paths: {
+      win: ['ffmpeg/ffprobe.exe'],
+      mac: ['ffmpeg/ffprobe'],
+      linux: ['ffmpeg/ffprobe']
    },
    help: {
      win: 'https://ffmpeg.org/download.html',
@@ -47,10 +60,10 @@ const binaries = [
  },
  {
    label: 'deno',
-    filenameMap: {
-      win: 'deno.exe',
-      mac: 'deno',
-      linux: 'deno'
+    paths: {
+      win: ['deno.exe'],
+      mac: ['deno'],
+      linux: ['deno']
    },
    help: {
      default: 'https://github.com/denoland/deno/releases/latest'
@@ -61,12 +74,15 @@ const binaries = [
 let hasMissingBinary = false

 for (const binary of binaries) {
-  const filename = binary.filenameMap[platform]
-  const binaryPath = path.join(__dirname, '..', 'resources', filename)
+  const candidates = binary.paths[platform] || []
+  const found = candidates.find((filename) =>
+    fs.existsSync(path.join(__dirname, '..', 'resources', filename))
+  )

-  if (!fs.existsSync(binaryPath)) {
-    console.error(`❌ Error: resources/${filename} not found!`)
-    console.error(`Please download ${filename} to the resources/ directory first.`)
+  if (!found) {
+    const expected = candidates.length ? candidates.join(' or ') : binary.label
+    console.error(`❌ Error: resources/${expected} not found!`)
+    console.error(`Please download ${binary.label} to the resources/ directory first.`)
    const help =
      typeof binary.help === 'string' ? binary.help : binary.help[platform] || binary.help.default
    if (help) {
@@ -74,7 +90,7 @@ for (const binary of binaries) {
    }
    hasMissingBinary = true
  } else {
-    console.log(`✅ ${filename} found in resources/ directory`)
+    console.log(`✅ ${binary.label} found: resources/${found}`)
  }
 }

--- a/scripts/setup-dev-binaries.js
+++ b/scripts/setup-dev-binaries.js
@@ -14,6 +14,7 @@ const http = require('node:http')

 // Configuration
 const RESOURCES_DIR = path.join(__dirname, '..', 'resources')
+const FFMPEG_DIR = path.join(RESOURCES_DIR, 'ffmpeg')
 const YTDLP_BASE_URL = 'https://github.com/yt-dlp/yt-dlp/releases/latest/download'
 const DENO_BASE_URL = 'https://github.com/denoland/deno/releases/latest/download'
 const GITHUB_TOKEN =
@@ -29,7 +30,9 @@ const PLATFORM_CONFIG = {
    ffmpeg: {
      url: 'https://github.com/yt-dlp/FFmpeg-Builds/releases/latest/download/ffmpeg-master-latest-win64-gpl.zip',
      innerPath: 'ffmpeg-master-latest-win64-gpl/bin/ffmpeg.exe',
+      ffprobeInnerPath: 'ffmpeg-master-latest-win64-gpl/bin/ffprobe.exe',
      output: 'ffmpeg.exe',
+      ffprobeOutput: 'ffprobe.exe',
      extract: 'unzip',
      release: {
        repos: ['yt-dlp/FFmpeg-Builds', 'BtbN/FFmpeg-Builds'],
@@ -46,9 +49,11 @@ const PLATFORM_CONFIG = {
    ffmpeg: {
      // For development, download only the architecture matching current system
      arm64: {
-        url: 'https://github.com/eko5624/mpv-mac/releases/download/2025-10-25/ffmpeg-arm64-defd5f3f64.zip',
+        url: 'https://github.com/eko5624/mpv-mac/releases/download/2026-01-12/ffmpeg-arm64-96e8f3b8cc.zip',
        innerPath: 'ffmpeg/ffmpeg',
-        output: 'ffmpeg_macos',
+        ffprobeInnerPath: 'ffmpeg/ffprobe',
+        output: 'ffmpeg',
+        ffprobeOutput: 'ffprobe',
        extract: 'unzip',
        release: {
          repo: 'eko5624/mpv-mac',
@@ -56,9 +61,11 @@ const PLATFORM_CONFIG = {
        }
      },
      x64: {
-        url: 'https://github.com/eko5624/mpv-mac/releases/download/2025-10-25/ffmpeg-x86_64-defd5f3f64.zip',
+        url: 'https://github.com/eko5624/mpv-mac/releases/download/2026-01-12/ffmpeg-x86_64-96e8f3b8cc.zip',
        innerPath: 'ffmpeg/ffmpeg',
-        output: 'ffmpeg_macos',
+        ffprobeInnerPath: 'ffmpeg/ffprobe',
+        output: 'ffmpeg',
+        ffprobeOutput: 'ffprobe',
        extract: 'unzip',
        release: {
          repo: 'eko5624/mpv-mac',
@@ -75,7 +82,9 @@ const PLATFORM_CONFIG = {
    ffmpeg: {
      url: 'https://github.com/yt-dlp/FFmpeg-Builds/releases/latest/download/ffmpeg-master-latest-linux64-gpl.tar.xz',
      innerPath: 'ffmpeg-master-latest-linux64-gpl/bin/ffmpeg',
-      output: 'ffmpeg_linux',
+      ffprobeInnerPath: 'ffmpeg-master-latest-linux64-gpl/bin/ffprobe',
+      output: 'ffmpeg',
+      ffprobeOutput: 'ffprobe',
      extract: 'tar',
      release: {
        repos: ['yt-dlp/FFmpeg-Builds', 'BtbN/FFmpeg-Builds'],
@@ -329,15 +338,21 @@ function formatBytes(bytes) {
  return `${Math.round(bytes / 1024)} KB`
 }

-function checkBinary(filePath, args, label) {
+function checkBinary(filePath, args, label, options = {}) {
+  const timeoutMs =
+    typeof options.timeoutMs === 'number'
+      ? options.timeoutMs
+      : os.platform() === 'win32'
+        ? 20000
+        : 8000
  const result = spawnSync(filePath, args, {
    encoding: 'utf8',
-    timeout: 8000,
+    timeout: timeoutMs,
    windowsHide: true
  })

  if (result.error) {
-    return { ok: false, message: result.error.message }
+    return { ok: false, message: result.error.message, code: result.error.code }
  }

  if (result.status !== 0) {
@@ -413,23 +428,43 @@ async function downloadYtDlp(config) {
 }

 async function downloadFfmpegWindows(config) {
-  const { url: fallbackUrl, innerPath: fallbackInnerPath, output, release } = config.ffmpeg
-  const outputPath = path.join(RESOURCES_DIR, output)
+  const {
+    url: fallbackUrl,
+    innerPath: fallbackInnerPath,
+    ffprobeInnerPath: fallbackFfprobeInnerPath,
+    output,
+    ffprobeOutput,
+    release
+  } = config.ffmpeg
+  const outputPath = path.join(FFMPEG_DIR, output)
+  const ffprobeOutputPath = ffprobeOutput ? path.join(FFMPEG_DIR, ffprobeOutput) : null

-  if (fileExists(outputPath)) {
+  const ffmpegExists = fileExists(outputPath)
+  const ffprobeExists = ffprobeOutputPath ? fileExists(ffprobeOutputPath) : true
+
+  if (ffmpegExists && ffprobeExists) {
    const validation = checkBinary(outputPath, ['-version'], 'ffmpeg')
-    if (!validation.ok) {
-      log(`Existing ${output} failed version check: ${validation.message}`, 'warn')
+    const ffprobeValidation = ffprobeOutputPath
+      ? checkBinary(ffprobeOutputPath, ['-version'], 'ffprobe')
+      : { ok: true }
+    if (!validation.ok || !ffprobeValidation.ok) {
+      log(
+        `Existing ffmpeg/ffprobe failed version check: ${validation.message || ffprobeValidation.message}`,
+        'warn'
+      )
+    } else {
+      log('ffmpeg and ffprobe already exist, skipping download', 'info')
+      return
    }
-    log(`${output} already exists, skipping download`, 'info')
-    return
  }

  log(`Downloading ffmpeg for Windows...`, 'download')
+  ensureDir(FFMPEG_DIR)
  const tempZip = path.join(RESOURCES_DIR, 'ffmpeg-temp.zip')
  const extractDir = path.join(RESOURCES_DIR, 'ffmpeg-temp')
  let downloadUrl = fallbackUrl
  let innerPath = fallbackInnerPath
+  let ffprobeInnerPath = fallbackFfprobeInnerPath

  if (release) {
    try {
@@ -440,6 +475,10 @@ async function downloadFfmpegWindows(config) {
        if (inferred) {
          innerPath = inferred
        }
+        const inferredFfprobe = inferFfmpegInnerPath(resolved.name, 'ffprobe.exe')
+        if (inferredFfprobe) {
+          ffprobeInnerPath = inferredFfprobe
+        }
      }
    } catch (error) {
      log(`Failed to resolve latest ffmpeg asset: ${error.message}`, 'warn')
@@ -457,12 +496,24 @@ async function downloadFfmpegWindows(config) {
    }

    fs.copyFileSync(sourcePath, outputPath)
+    if (ffprobeInnerPath && ffprobeOutputPath) {
+      const ffprobeSourcePath = path.join(extractDir, ffprobeInnerPath.replace(/\\/g, path.sep))
+      if (!fileExists(ffprobeSourcePath)) {
+        throw new Error(`ffprobe binary not found at ${ffprobeSourcePath}`)
+      }
+      fs.copyFileSync(ffprobeSourcePath, ffprobeOutputPath)
+    }
    const validation = checkBinary(outputPath, ['-version'], 'ffmpeg')
    if (!validation.ok) {
-      safeUnlink(outputPath)
-      throw new Error(`Downloaded ${output} failed version check: ${validation.message}`)
+      if (validation.code === 'ETIMEDOUT') {
+        log(`Downloaded ${output} version check timed out; keeping binary`, 'warn')
+      } else {
+        safeUnlink(outputPath)
+        throw new Error(`Downloaded ${output} failed version check: ${validation.message}`)
+      }
+    } else {
+      log(`Downloaded ${output} successfully`, 'success')
    }
-    log(`Downloaded ${output} successfully`, 'success')

    // Cleanup
    fs.unlinkSync(tempZip)
@@ -482,19 +533,38 @@ async function downloadFfmpegMac(config) {
    throw new Error(`Unsupported architecture: ${arch}`)
  }

-  const { url: fallbackUrl, innerPath, output, release } = ffmpegConfig
-  const outputPath = path.join(RESOURCES_DIR, output)
+  const {
+    url: fallbackUrl,
+    innerPath,
+    ffprobeInnerPath,
+    output,
+    ffprobeOutput,
+    release
+  } = ffmpegConfig
+  const outputPath = path.join(FFMPEG_DIR, output)
+  const ffprobeOutputPath = ffprobeOutput ? path.join(FFMPEG_DIR, ffprobeOutput) : null

-  if (fileExists(outputPath)) {
+  const ffmpegExists = fileExists(outputPath)
+  const ffprobeExists = ffprobeOutputPath ? fileExists(ffprobeOutputPath) : true
+
+  if (ffmpegExists && ffprobeExists) {
    const validation = checkBinary(outputPath, ['-version'], 'ffmpeg')
-    if (!validation.ok) {
-      log(`Existing ${output} failed version check: ${validation.message}`, 'warn')
+    const ffprobeValidation = ffprobeOutputPath
+      ? checkBinary(ffprobeOutputPath, ['-version'], 'ffprobe')
+      : { ok: true }
+    if (!validation.ok || !ffprobeValidation.ok) {
+      log(
+        `Existing ffmpeg/ffprobe failed version check: ${validation.message || ffprobeValidation.message}`,
+        'warn'
+      )
+    } else {
+      log('ffmpeg and ffprobe already exist, skipping download', 'info')
+      return
    }
-    log(`${output} already exists, skipping download`, 'info')
-    return
  }

  log(`Downloading ffmpeg for macOS (${arch})...`, 'download')
+  ensureDir(FFMPEG_DIR)
  const tempZip = path.join(RESOURCES_DIR, 'ffmpeg-temp.zip')
  const extractDir = path.join(RESOURCES_DIR, 'ffmpeg-temp')
  let downloadUrl = fallbackUrl
@@ -522,6 +592,14 @@ async function downloadFfmpegMac(config) {

    fs.copyFileSync(sourcePath, outputPath)
    setExecutable(outputPath)
+    if (ffprobeInnerPath && ffprobeOutputPath) {
+      const ffprobeSourcePath = path.join(extractDir, ffprobeInnerPath)
+      if (!fileExists(ffprobeSourcePath)) {
+        throw new Error(`ffprobe binary not found at ${ffprobeSourcePath}`)
+      }
+      fs.copyFileSync(ffprobeSourcePath, ffprobeOutputPath)
+      setExecutable(ffprobeOutputPath)
+    }
    const validation = checkBinary(outputPath, ['-version'], 'ffmpeg')
    if (!validation.ok) {
      safeUnlink(outputPath)
@@ -540,23 +618,43 @@ async function downloadFfmpegMac(config) {
 }

 async function downloadFfmpegLinux(config) {
-  const { url: fallbackUrl, innerPath: fallbackInnerPath, output, release } = config.ffmpeg
-  const outputPath = path.join(RESOURCES_DIR, output)
+  const {
+    url: fallbackUrl,
+    innerPath: fallbackInnerPath,
+    ffprobeInnerPath: fallbackFfprobeInnerPath,
+    output,
+    ffprobeOutput,
+    release
+  } = config.ffmpeg
+  const outputPath = path.join(FFMPEG_DIR, output)
+  const ffprobeOutputPath = ffprobeOutput ? path.join(FFMPEG_DIR, ffprobeOutput) : null

-  if (fileExists(outputPath)) {
+  const ffmpegExists = fileExists(outputPath)
+  const ffprobeExists = ffprobeOutputPath ? fileExists(ffprobeOutputPath) : true
+
+  if (ffmpegExists && ffprobeExists) {
    const validation = checkBinary(outputPath, ['-version'], 'ffmpeg')
-    if (!validation.ok) {
-      log(`Existing ${output} failed version check: ${validation.message}`, 'warn')
+    const ffprobeValidation = ffprobeOutputPath
+      ? checkBinary(ffprobeOutputPath, ['-version'], 'ffprobe')
+      : { ok: true }
+    if (!validation.ok || !ffprobeValidation.ok) {
+      log(
+        `Existing ffmpeg/ffprobe failed version check: ${validation.message || ffprobeValidation.message}`,
+        'warn'
+      )
+    } else {
+      log('ffmpeg and ffprobe already exist, skipping download', 'info')
+      return
    }
-    log(`${output} already exists, skipping download`, 'info')
-    return
  }

  log(`Downloading ffmpeg for Linux...`, 'download')
+  ensureDir(FFMPEG_DIR)
  const tempTar = path.join(RESOURCES_DIR, 'ffmpeg-temp.tar.xz')
  const extractDir = path.join(RESOURCES_DIR, 'ffmpeg-temp')
  let downloadUrl = fallbackUrl
  let innerPath = fallbackInnerPath
+  let ffprobeInnerPath = fallbackFfprobeInnerPath

  if (release) {
    try {
@@ -567,6 +665,10 @@ async function downloadFfmpegLinux(config) {
        if (inferred) {
          innerPath = inferred
        }
+        const inferredFfprobe = inferFfmpegInnerPath(resolved.name, 'ffprobe')
+        if (inferredFfprobe) {
+          ffprobeInnerPath = inferredFfprobe
+        }
      }
    } catch (error) {
      log(`Failed to resolve latest ffmpeg asset: ${error.message}`, 'warn')
@@ -585,6 +687,14 @@ async function downloadFfmpegLinux(config) {

    fs.copyFileSync(sourcePath, outputPath)
    setExecutable(outputPath)
+    if (ffprobeInnerPath && ffprobeOutputPath) {
+      const ffprobeSourcePath = path.join(extractDir, ffprobeInnerPath)
+      if (!fileExists(ffprobeSourcePath)) {
+        throw new Error(`ffprobe binary not found at ${ffprobeSourcePath}`)
+      }
+      fs.copyFileSync(ffprobeSourcePath, ffprobeOutputPath)
+      setExecutable(ffprobeOutputPath)
+    }
    const validation = checkBinary(outputPath, ['-version'], 'ffmpeg')
    if (!validation.ok) {
      safeUnlink(outputPath)
--- a/src/main/download-engine/args-builder.ts
+++ b/src/main/download-engine/args-builder.ts
@@ -137,9 +137,7 @@ export const buildDownloadArgs = (
  } else {
    args.push('--no-embed-subs')
  }
-  if (process.platform !== 'darwin') {
-    args.push(settings.embedThumbnail ? '--embed-thumbnail' : '--no-embed-thumbnail')
-  }
+  args.push(settings.embedThumbnail ? '--embed-thumbnail' : '--no-embed-thumbnail')
  args.push(embedMetadata ? '--embed-metadata' : '--no-embed-metadata')
  args.push(embedChapters ? '--embed-chapters' : '--no-embed-chapters')

@@ -152,8 +150,8 @@ export const buildDownloadArgs = (
  const outputTemplate = path.join(baseDownloadPath, safeTemplate)
  args.push('-o', outputTemplate)

-  // Add options for better filename handling
-  args.push('--no-part')
+  // Allow resume support across restarts
+  args.push('--continue')
  args.push('--no-playlist-reverse')

  if (process.platform === 'win32') {
--- a/src/main/index.ts
+++ b/src/main/index.ts
@@ -449,14 +449,20 @@ app.whenReady().then(async () => {
  }

  // Initialize yt-dlp
+  let ytdlpReady = false
  try {
    log.info('Initializing yt-dlp...')
    await ytdlpManager.initialize()
+    ytdlpReady = true
    log.info('yt-dlp initialized successfully')
  } catch (error) {
    log.error('Failed to initialize yt-dlp:', error)
  }

+  if (ytdlpReady) {
+    downloadEngine.restoreActiveDownloads()
+  }
+
  await startExtensionApiServer()

  applyDockVisibility(settingsManager.get('hideDockIcon'))
@@ -474,14 +480,27 @@ app.whenReady().then(async () => {
  handleDeepLinkArgv(process.argv)

  app.on('activate', () => {
+    const existingWindow = BrowserWindow.getAllWindows().find((window) => !window.isDestroyed())
+    if (existingWindow) {
+      if (existingWindow.isMinimized()) {
+        existingWindow.restore()
+      }
+      if (!existingWindow.isVisible()) {
+        existingWindow.show()
+      }
+      existingWindow.focus()
+      return
+    }
+
    // On macOS it's common to re-create a window in the app when the
    // dock icon is clicked and there are no other windows open.
-    if (BrowserWindow.getAllWindows().length === 0) createWindow()
+    createWindow()
  })
 })

 app.on('before-quit', () => {
  isQuitting = true
+  downloadEngine.flushDownloadSession()
 })

 // Quit when all windows are closed, except on macOS. There, it's common
--- a/src/main/ipc/services/download-service.ts
+++ b/src/main/ipc/services/download-service.ts
@@ -46,6 +46,11 @@ class DownloadService extends IpcService {
    return downloadEngine.getQueueStatus()
  }

+  @IpcMethod()
+  getActiveDownloads(_context: IpcContext): DownloadItem[] {
+    return downloadEngine.getActiveDownloads()
+  }
+
  @IpcMethod()
  updateDownloadInfo(_context: IpcContext, id: string, updates: Partial<DownloadItem>): void {
    downloadEngine.updateDownloadInfo(id, updates)
--- a/src/main/ipc/services/subscription-service.ts
+++ b/src/main/ipc/services/subscription-service.ts
@@ -6,7 +6,10 @@ import type {
  SubscriptionRule,
  SubscriptionUpdatePayload
 } from '../../../shared/types'
-import { DEFAULT_SUBSCRIPTION_FILENAME_TEMPLATE } from '../../../shared/types'
+import {
+  DEFAULT_SUBSCRIPTION_FILENAME_TEMPLATE,
+  SUBSCRIPTION_DUPLICATE_FEED_ERROR
+} from '../../../shared/types'
 import { sanitizeFilenameTemplate } from '../../download-engine/args-builder'
 import { subscriptionManager } from '../../lib/subscription-manager'
 import { subscriptionScheduler } from '../../lib/subscription-scheduler'
@@ -113,6 +116,10 @@ class SubscriptionService extends IpcService {
    options: CreateSubscriptionOptions
  ): Promise<SubscriptionRule> {
    const resolved = resolveFeedFromInput(options.url)
+    const duplicate = subscriptionManager.findDuplicateFeed(resolved.feedUrl)
+    if (duplicate) {
+      throw new Error(SUBSCRIPTION_DUPLICATE_FEED_ERROR)
+    }
    const settings = settingsManager.getAll()
    const defaultDownloadDirectory = path.join(settings.downloadPath, 'Subscriptions')
    const payload: SubscriptionCreatePayload = {
@@ -141,6 +148,12 @@ class SubscriptionService extends IpcService {
    id: string,
    updates: SubscriptionUpdatePayload
  ): SubscriptionRule | undefined {
+    if (updates.feedUrl) {
+      const duplicate = subscriptionManager.findDuplicateFeed(updates.feedUrl, id)
+      if (duplicate) {
+        throw new Error(SUBSCRIPTION_DUPLICATE_FEED_ERROR)
+      }
+    }
    const normalized: SubscriptionUpdatePayload = { ...updates }
    if (typeof normalized.namingTemplate === 'string') {
      normalized.namingTemplate = sanitizeFilenameTemplate(normalized.namingTemplate)
--- a/src/main/lib/download-engine.ts
+++ b/src/main/lib/download-engine.ts
@@ -28,6 +28,11 @@ import { settingsManager } from '../settings'
 import { scopedLoggers } from '../utils/logger'
 import { resolvePathWithHome } from '../utils/path-helpers'
 import { DownloadQueue } from './download-queue'
+import {
+  type DownloadSessionItem,
+  loadDownloadSession,
+  saveDownloadSession
+} from './download-session-store'
 import { ffmpegManager } from './ffmpeg-manager'
 import { historyManager } from './history-manager'
 import { ytdlpManager } from './ytdlp-manager'
@@ -50,6 +55,8 @@ const formatYtDlpCommand = (args: string[]): string => {
  return `yt-dlp ${quoted.join(' ')}`
 }

+const resolveFfmpegLocation = (ffmpegPath: string): string => path.dirname(ffmpegPath)
+
 const ensureDirectoryExists = (dir?: string): void => {
  if (!dir) {
    return
@@ -260,6 +267,8 @@ const buildVideoInfoArgs = (url: string, settings: ReturnType<typeof settingsMan
 class DownloadEngine extends EventEmitter {
  private activeDownloads: Map<string, DownloadProcess> = new Map()
  private queue: DownloadQueue
+  private sessionPersistTimer: NodeJS.Timeout | null = null
+  private sessionRestored = false

  constructor() {
    super()
@@ -269,6 +278,10 @@ class DownloadEngine extends EventEmitter {
    this.queue.on('start-download', async (item) => {
      await this.executeDownload(item.id, item.options)
    })
+
+    this.queue.on('queue-updated', () => {
+      this.scheduleSessionPersist()
+    })
  }

  async getVideoInfo(url: string): Promise<VideoInfo> {
@@ -897,7 +910,8 @@ class DownloadEngine extends EventEmitter {
      return
    }

-    args.push('--ffmpeg-location', ffmpegPath)
+    const ffmpegLocation = resolveFfmpegLocation(ffmpegPath)
+    args.push('--ffmpeg-location', ffmpegLocation)
    args.push(urlArg)

    const ytDlpCommand = formatYtDlpCommand(args)
@@ -911,6 +925,8 @@ class DownloadEngine extends EventEmitter {

    this.activeDownloads.set(id, { controller, process: ytdlpProcess })

+    this.queue.updateItemInfo(id, { status: 'downloading', startedAt: Date.now() })
+    this.scheduleSessionPersist()
    this.emit('download-started', id)

    this.upsertHistoryEntry(id, options, {
@@ -964,6 +980,11 @@ class DownloadEngine extends EventEmitter {
          downloaded: progress.downloaded || '',
          total: progress.total || ''
        }
+        this.queue.updateItemInfo(id, {
+          progress: downloadProgress,
+          speed: downloadProgress.currentSpeed || ''
+        })
+        this.scheduleSessionPersist()
        this.emit('download-progress', id, downloadProgress)
      }
    )
@@ -1178,6 +1199,72 @@ class DownloadEngine extends EventEmitter {
    return this.queue.getQueueStatus()
  }

+  getActiveDownloads(): DownloadItem[] {
+    const items = new Map<string, DownloadItem>()
+    for (const item of this.queue.getActiveItems()) {
+      items.set(item.id, item)
+    }
+    for (const item of this.queue.getQueuedItems()) {
+      items.set(item.id, item)
+    }
+    return Array.from(items.values()).sort((a, b) => b.createdAt - a.createdAt)
+  }
+
+  restoreActiveDownloads(): void {
+    if (this.sessionRestored) {
+      return
+    }
+    this.sessionRestored = true
+
+    const sessionItems = loadDownloadSession()
+    if (sessionItems.length === 0) {
+      return
+    }
+
+    for (const entry of sessionItems) {
+      if (!entry?.id || !entry.options?.url || !entry.options.type) {
+        continue
+      }
+      if (this.queue.getItemDetails(entry.id)) {
+        continue
+      }
+
+      const historyItem = historyManager.getHistoryById(entry.id)
+      if (historyItem && ['completed', 'error', 'cancelled'].includes(historyItem.status)) {
+        continue
+      }
+
+      const createdAt = entry.item?.createdAt ?? Date.now()
+      const restoredItem: DownloadItem = {
+        ...entry.item,
+        id: entry.id,
+        url: entry.options.url,
+        type: entry.options.type,
+        status: 'pending',
+        createdAt,
+        completedAt: undefined
+      }
+
+      this.queue.add(entry.id, entry.options, restoredItem)
+
+      this.upsertHistoryEntry(entry.id, entry.options, {
+        title: restoredItem.title || historyItem?.title || `Download ${entry.id}`,
+        status: 'pending',
+        downloadedAt: historyItem?.downloadedAt ?? createdAt
+      })
+    }
+
+    this.scheduleSessionPersist()
+  }
+
+  flushDownloadSession(): void {
+    if (this.sessionPersistTimer) {
+      clearTimeout(this.sessionPersistTimer)
+      this.sessionPersistTimer = null
+    }
+    this.persistSession()
+  }
+
  updateDownloadInfo(id: string, updates: Partial<DownloadItem>): void {
    this.queue.updateItemInfo(id, updates)

@@ -1249,6 +1336,37 @@ class DownloadEngine extends EventEmitter {
    if (Object.keys(historyUpdates).length > 0) {
      this.upsertHistoryEntry(id, snapshot.options, historyUpdates)
    }
+
+    this.scheduleSessionPersist()
+  }
+
+  private scheduleSessionPersist(): void {
+    if (this.sessionPersistTimer) {
+      return
+    }
+    this.sessionPersistTimer = setTimeout(() => {
+      this.sessionPersistTimer = null
+      this.persistSession()
+    }, 1000)
+  }
+
+  private persistSession(): void {
+    const entries: DownloadSessionItem[] = []
+    const activeEntries = this.queue.getActiveEntries()
+    const queuedEntries = this.queue.getQueuedEntries()
+
+    for (const entry of [...activeEntries, ...queuedEntries]) {
+      if (!entry?.item?.id) {
+        continue
+      }
+      entries.push({
+        id: entry.item.id,
+        options: entry.options,
+        item: entry.item
+      })
+    }
+
+    saveDownloadSession(entries)
  }

  private addToHistory(
--- a/src/main/lib/download-queue.ts
+++ b/src/main/lib/download-queue.ts
@@ -82,6 +82,28 @@ export class DownloadQueue extends EventEmitter {
    }
  }

+  getActiveItems(): DownloadItem[] {
+    return Array.from(this.activeDownloads.values()).map((item) => ({ ...item.item }))
+  }
+
+  getQueuedItems(): DownloadItem[] {
+    return this.queue.map((item) => ({ ...item.item }))
+  }
+
+  getActiveEntries(): Array<{ options: DownloadOptions; item: DownloadItem }> {
+    return Array.from(this.activeDownloads.values()).map((entry) => ({
+      options: { ...entry.options },
+      item: { ...entry.item }
+    }))
+  }
+
+  getQueuedEntries(): Array<{ options: DownloadOptions; item: DownloadItem }> {
+    return this.queue.map((entry) => ({
+      options: { ...entry.options },
+      item: { ...entry.item }
+    }))
+  }
+
  isDownloading(id: string): boolean {
    return this.activeDownloads.has(id)
  }
--- a/src/main/lib/download-session-store.ts
+++ b/src/main/lib/download-session-store.ts
@@ -0,0 +1,67 @@
+import fs from 'node:fs'
+import path from 'node:path'
+import { app } from 'electron'
+import type { DownloadItem, DownloadOptions } from '../../shared/types'
+import { scopedLoggers } from '../utils/logger'
+
+export interface DownloadSessionItem {
+  id: string
+  options: DownloadOptions
+  item: DownloadItem
+}
+
+interface DownloadSessionPayload {
+  version: 1
+  updatedAt: number
+  items: DownloadSessionItem[]
+}
+
+const SESSION_FILE_NAME = 'download-session.json'
+
+const getSessionFilePath = (): string => path.join(app.getPath('userData'), SESSION_FILE_NAME)
+
+const isValidItem = (item: DownloadSessionItem): boolean =>
+  Boolean(item?.id && item.options && item.item)
+
+export const loadDownloadSession = (): DownloadSessionItem[] => {
+  const filePath = getSessionFilePath()
+  if (!fs.existsSync(filePath)) {
+    return []
+  }
+
+  try {
+    const raw = fs.readFileSync(filePath, 'utf-8')
+    const payload = JSON.parse(raw) as DownloadSessionPayload
+    if (!payload || payload.version !== 1 || !Array.isArray(payload.items)) {
+      return []
+    }
+    return payload.items.filter(isValidItem)
+  } catch (error) {
+    scopedLoggers.download.warn('Failed to load download session:', error)
+    return []
+  }
+}
+
+export const saveDownloadSession = (items: DownloadSessionItem[]): void => {
+  const filePath = getSessionFilePath()
+  if (items.length === 0) {
+    try {
+      fs.rmSync(filePath, { force: true })
+    } catch (error) {
+      scopedLoggers.download.warn('Failed to clear download session:', error)
+    }
+    return
+  }
+
+  const payload: DownloadSessionPayload = {
+    version: 1,
+    updatedAt: Date.now(),
+    items
+  }
+
+  try {
+    fs.writeFileSync(filePath, JSON.stringify(payload), 'utf-8')
+  } catch (error) {
+    scopedLoggers.download.warn('Failed to save download session:', error)
+  }
+}
--- a/src/main/lib/ffmpeg-manager.ts
+++ b/src/main/lib/ffmpeg-manager.ts
@@ -28,46 +28,58 @@ class FfmpegManager {

  private async findFfmpegBinary(): Promise<string> {
    const platform = os.platform()
-    const resourceCandidates: string[] = []
+    const ffmpegFileName = platform === 'win32' ? 'ffmpeg.exe' : 'ffmpeg'
+    const ffprobeFileName = platform === 'win32' ? 'ffprobe.exe' : 'ffprobe'

-    if (process.env.FFMPEG_PATH && fs.existsSync(process.env.FFMPEG_PATH)) {
-      scopedLoggers.engine.info('Using ffmpeg from FFMPEG_PATH:', process.env.FFMPEG_PATH)
-      return process.env.FFMPEG_PATH
+    const resolveBundledFfmpeg = (dirPath: string, label: string): string | null => {
+      const ffmpegPath = path.join(dirPath, ffmpegFileName)
+      const ffprobePath = path.join(dirPath, ffprobeFileName)
+      if (!fs.existsSync(ffmpegPath) || !fs.existsSync(ffprobePath)) {
+        return null
+      }
+      if (platform !== 'win32') {
+        try {
+          fs.chmodSync(ffmpegPath, 0o755)
+          fs.chmodSync(ffprobePath, 0o755)
+        } catch (error) {
+          scopedLoggers.engine.warn(`Failed to set executable permission on ${label}:`, error)
+        }
+      }
+      scopedLoggers.engine.info(`Using ${label}:`, ffmpegPath)
+      return ffmpegPath
    }

-    if (platform === 'win32') {
-      resourceCandidates.push('ffmpeg.exe')
-    } else if (platform === 'darwin') {
-      resourceCandidates.push('ffmpeg_macos', 'ffmpeg')
-    } else {
-      resourceCandidates.push('ffmpeg_linux', 'ffmpeg')
+    const envPath = process.env.FFMPEG_PATH
+    if (envPath) {
+      if (!fs.existsSync(envPath)) {
+        throw new Error(
+          'FFMPEG_PATH does not exist. Provide a directory containing ffmpeg and ffprobe.'
+        )
+      }
+      const stats = fs.statSync(envPath)
+      if (!stats.isDirectory()) {
+        throw new Error('FFMPEG_PATH must be a directory containing ffmpeg and ffprobe.')
+      }
+      const resolved = resolveBundledFfmpeg(envPath, 'ffmpeg from FFMPEG_PATH directory')
+      if (resolved) {
+        return resolved
+      }
+      throw new Error('FFMPEG_PATH must contain both ffmpeg and ffprobe.')
    }

    const resourcesPath = this.getResourcesPath()
-    for (const candidate of resourceCandidates) {
-      const fullPath = path.join(resourcesPath, candidate)
-      if (fs.existsSync(fullPath)) {
-        if (platform !== 'win32') {
-          try {
-            fs.chmodSync(fullPath, 0o755)
-          } catch (error) {
-            scopedLoggers.engine.warn(
-              'Failed to set executable permission on ffmpeg binary:',
-              error
-            )
-          }
-        }
-        scopedLoggers.engine.info('Using bundled ffmpeg:', fullPath)
-        return fullPath
-      }
+    const bundledDir = path.join(resourcesPath, 'ffmpeg')
+    const bundledResolved = resolveBundledFfmpeg(bundledDir, 'bundled ffmpeg')
+    if (bundledResolved) {
+      return bundledResolved
    }

    if (platform === 'darwin') {
-      const commonPaths = ['/opt/homebrew/bin/ffmpeg', '/usr/local/bin/ffmpeg']
-      for (const candidate of commonPaths) {
-        if (fs.existsSync(candidate)) {
-          scopedLoggers.engine.info('Using system ffmpeg:', candidate)
-          return candidate
+      const commonDirs = ['/opt/homebrew/bin', '/usr/local/bin']
+      for (const candidate of commonDirs) {
+        const resolved = resolveBundledFfmpeg(candidate, 'system ffmpeg')
+        if (resolved) {
+          return resolved
        }
      }
    }
@@ -76,8 +88,10 @@ class FfmpegManager {
      try {
        const systemPath = execSync('which ffmpeg').toString().trim()
        if (systemPath && fs.existsSync(systemPath)) {
-          scopedLoggers.engine.info('Using system ffmpeg:', systemPath)
-          return systemPath
+          const resolved = resolveBundledFfmpeg(path.dirname(systemPath), 'system ffmpeg')
+          if (resolved) {
+            return resolved
+          }
        }
      } catch (_error) {
        // Ignore error and continue
@@ -88,8 +102,10 @@ class FfmpegManager {
      try {
        const output = execSync('where ffmpeg').toString().split(/\r?\n/)[0]
        if (output && fs.existsSync(output)) {
-          scopedLoggers.engine.info('Using system ffmpeg:', output)
-          return output
+          const resolved = resolveBundledFfmpeg(path.dirname(output), 'system ffmpeg')
+          if (resolved) {
+            return resolved
+          }
        }
      } catch (_error) {
        // Ignore error and continue
@@ -97,7 +113,7 @@ class FfmpegManager {
    }

    throw new Error(
-      'ffmpeg not found. Bundle it under resources/ (asarUnpack) or set the FFMPEG_PATH environment variable.'
+      'ffmpeg/ffprobe not found. Bundle them under resources/ffmpeg/ (asarUnpack) or set FFMPEG_PATH to a directory containing both.'
    )
  }
 }
--- a/src/main/lib/subscription-manager.ts
+++ b/src/main/lib/subscription-manager.ts
@@ -99,6 +99,22 @@ export class SubscriptionManager extends EventEmitter {
    return this.attachFeedItems([this.mapRowToRecord(row)])[0]
  }

+  findDuplicateFeed(
+    feedUrl: string,
+    ignoreId?: string
+  ): { id: string; feedUrl: string } | undefined {
+    const database = this.getDatabase()
+    const rows = database
+      .select({ id: subscriptionsTable.id, feedUrl: subscriptionsTable.feedUrl })
+      .from(subscriptionsTable)
+      .all()
+    const targetKey = this.buildFeedKey(feedUrl)
+    if (!targetKey) {
+      return undefined
+    }
+    return rows.find((row) => row.id !== ignoreId && this.buildFeedKey(row.feedUrl) === targetKey)
+  }
+
  add(payload: SubscriptionCreatePayload): SubscriptionRule {
    const timestamp = Date.now()
    const keywords = sanitizeList(payload.keywords)
@@ -301,6 +317,25 @@ export class SubscriptionManager extends EventEmitter {
    return this.db
  }

+  private buildFeedKey(feedUrl: string): string {
+    const trimmed = feedUrl.trim()
+    if (!trimmed) {
+      return ''
+    }
+    const normalized = /^https?:\/\//i.test(trimmed) ? trimmed : `https://${trimmed}`
+    try {
+      const url = new URL(normalized)
+      let pathname = url.pathname || '/'
+      pathname = pathname.replace(/\/+$/, '')
+      if (!pathname) {
+        pathname = '/'
+      }
+      return `${url.host.toLowerCase()}${pathname}${url.search}`
+    } catch {
+      return trimmed.toLowerCase()
+    }
+  }
+
  private ensureItemsSchema(): void {
    if (!this.sqlite) {
      return
--- a/src/preload/index.d.ts
+++ b/src/preload/index.d.ts
@@ -5,7 +5,7 @@ declare global {
  interface Window {
    electron: ElectronAPI
    api: IpcServices & {
-      on: (channel: string, callback: (...args: unknown[]) => void) => void
+      on: (channel: string, callback: (...args: unknown[]) => void) => (...args: unknown[]) => void
      removeListener: (channel: string, callback: (...args: unknown[]) => void) => void
      send: (channel: string, ...args: unknown[]) => void
    }
--- a/src/renderer/src/App.tsx
+++ b/src/renderer/src/App.tsx
@@ -9,6 +9,7 @@ import { useTranslation } from 'react-i18next'
 import { HashRouter, Navigate, Route, Routes, useLocation, useNavigate } from 'react-router'
 import { toast } from 'sonner'
 import { ErrorBoundary } from './components/error/ErrorBoundary'
+import { useDownloadEvents } from './hooks/use-download-events'
 import { ipcEvents, ipcServices } from './lib/ipc'
 import { About } from './pages/About'
 import { Home } from './pages/Home'
@@ -62,6 +63,8 @@ function AppContent() {
  const currentPage = pathToPage(location.pathname)
  const supportedSitesUrl = 'https://vidbee.org/supported-sites/'

+  useDownloadEvents()
+
  const handlePageChange = useCallback(
    (page: Page) => {
      const targetPath = pageToPath[page] ?? '/'
--- a/src/renderer/src/components/download/DownloadDialog.tsx
+++ b/src/renderer/src/components/download/DownloadDialog.tsx
@@ -16,12 +16,7 @@ import { useCallback, useEffect, useId, useMemo, useState } from 'react'
 import { useTranslation } from 'react-i18next'
 import { toast } from 'sonner'
 import { ipcEvents, ipcServices } from '../../lib/ipc'
-import {
-  addDownloadAtom,
-  addHistoryRecordAtom,
-  removeDownloadAtom,
-  updateDownloadAtom
-} from '../../store/downloads'
+import { addDownloadAtom, updateDownloadAtom } from '../../store/downloads'
 import { loadSettingsAtom, settingsAtom } from '../../store/settings'
 import {
  currentVideoInfoAtom,
@@ -116,8 +111,6 @@ export function DownloadDialog({
  const loadSettings = useSetAtom(loadSettingsAtom)
  const updateDownload = useSetAtom(updateDownloadAtom)
  const addDownload = useSetAtom(addDownloadAtom)
-  const addHistoryRecord = useSetAtom(addHistoryRecordAtom)
-  const removeDownload = useSetAtom(removeDownloadAtom)

  const [url, setUrl] = useState('')
  const [activeTab, setActiveTab] = useState<'single' | 'playlist'>('single')
@@ -182,21 +175,6 @@ export function DownloadDialog({
    )
  }, [playlistInfo, computePlaylistRange, selectedEntryIds])

-  const syncHistoryItem = useCallback(
-    async (id: string) => {
-      try {
-        const historyItem = await ipcServices.history.getHistoryById(id)
-        if (historyItem) {
-          addHistoryRecord(historyItem)
-          removeDownload(id)
-        }
-      } catch (error) {
-        console.error('Failed to sync history item:', error)
-      }
-    },
-    [addHistoryRecord, removeDownload]
-  )
-
  // Listen for deep link events
  useEffect(() => {
    const handleDeepLink = async (data: unknown) => {
@@ -283,69 +261,8 @@ export function DownloadDialog({

  useEffect(() => {
    if (!open) return
-
-    // Load settings when dialog opens
    loadSettings()
-
-    // Listen for download events from main process
-    ipcEvents.on('download:started', (...args: unknown[]) => {
-      const id = args[0] as string
-      console.log('Download started:', id)
-      updateDownload({ id, changes: { status: 'downloading' } })
-    })
-
-    ipcEvents.on('download:progress', (...args: unknown[]) => {
-      const data = args[0] as { id: string; progress: unknown }
-      console.log('Download progress:', data)
-      const progress = data.progress as {
-        percent: number
-        currentSpeed?: string
-        eta?: string
-        downloaded?: string
-        total?: string
-      }
-      updateDownload({
-        id: data.id,
-        changes: {
-          progress: {
-            percent: progress.percent || 0,
-            currentSpeed: progress.currentSpeed || '',
-            eta: progress.eta || '',
-            downloaded: progress.downloaded || '',
-            total: progress.total || ''
-          },
-          speed: progress.currentSpeed || ''
-        }
-      })
-    })
-
-    ipcEvents.on('download:completed', (...args: unknown[]) => {
-      const id = args[0] as string
-      console.log('Download completed:', id)
-      updateDownload({ id, changes: { status: 'completed' } })
-      toast.success(t('notifications.downloadCompleted'))
-      void syncHistoryItem(id)
-    })
-
-    ipcEvents.on('download:error', (...args: unknown[]) => {
-      const data = args[0] as { id: string; error: string }
-      console.error('Download error:', data)
-      updateDownload({ id: data.id, changes: { status: 'error', error: data.error } })
-      toast.error(t('notifications.downloadFailed'))
-      void syncHistoryItem(data.id)
-    })
-
-    ipcEvents.on('download:cancelled', (...args: unknown[]) => {
-      const id = args[0] as string
-      console.log('Download cancelled:', id)
-      updateDownload({ id, changes: { status: 'cancelled' } })
-      void syncHistoryItem(id)
-    })
-
-    return () => {
-      // Event listeners are automatically cleaned up when the component unmounts
-    }
-  }, [open, loadSettings, syncHistoryItem, t, updateDownload])
+  }, [open, loadSettings])

  const startOneClickDownload = useCallback(
    async (targetUrl: string, options?: { clearInput?: boolean; setInputValue?: boolean }) => {
@@ -748,7 +665,6 @@ export function DownloadDialog({
        addDownload(downloadItem)
      })

-      toast.success(t('playlist.downloadStarted', { count: result.totalCount }))
      setOpen(false) // Close dialog after download starts
    } catch (error) {
      console.error('Failed to start playlist download:', error)
@@ -831,7 +747,6 @@ export function DownloadDialog({
        createdAt: Date.now()
      })

-      toast.success(t('notifications.downloadStarted'))
      setOpen(false) // Close dialog after download starts
    } catch (error) {
      console.error('Failed to start download:', error)
--- a/src/renderer/src/components/download/PlaylistDownload.tsx
+++ b/src/renderer/src/components/download/PlaylistDownload.tsx
@@ -91,7 +91,7 @@ export function PlaylistDownload({
            </div>
          </div>

-          <ScrollArea className="flex-1 w-full rounded-md border">
+          <ScrollArea className="flex-1 w-full rounded-md border max-h-[45vh]">
            <div className="p-1">
              {playlistInfo.entries.map((entry) => {
                const isSelected = selectedEntryIds.has(entry.id)
--- a/src/renderer/src/components/download/PlaylistDownloadGroup.tsx
+++ b/src/renderer/src/components/download/PlaylistDownloadGroup.tsx
@@ -78,11 +78,11 @@ export function PlaylistDownloadGroup({
  const aggregatePercent = totalCount > 0 ? Math.min((totalProgress / totalCount) * 100, 100) : 0

  return (
-    <div className="space-y-2 rounded-md bg-muted/30 px-2.5 py-2 mx-6">
+    <div className="rounded-md bg-muted/30 mx-6">
      <div className="flex items-center justify-between gap-2">
        <button
          type="button"
-          className="flex min-w-0 flex-1 items-center gap-2 rounded-md p-1.5 transition-colors hover:bg-muted/40 active:bg-muted/60 -ml-1.5 -mr-1.5"
+          className="px-3 flex min-w-0 flex-1 items-center gap-2 rounded-md p-1.5 transition-colors hover:bg-muted/40 active:bg-muted/60"
          onClick={() => setIsExpanded((prev) => !prev)}
          aria-expanded={isExpanded}
          aria-label={toggleLabel}
@@ -118,7 +118,7 @@ export function PlaylistDownloadGroup({
            </div>
          </div>
        </button>
-        <div className="flex shrink-0 items-center gap-1">
+        <div className="flex shrink-0 items-center gap-1 pr-3">
          {canDeletePlaylist && (
            <Button
              type="button"
@@ -153,17 +153,15 @@ export function PlaylistDownloadGroup({
        }}
      >
        <div className="min-h-0">
-          <div className="space-y-3 pt-1">
-            {records.map((record) => (
-              <div key={`${groupId}:${record.entryType}:${record.id}`}>
-                <DownloadItem
-                  download={record}
-                  isSelected={selectedIds?.has(record.id) ?? false}
-                  onToggleSelect={onToggleSelect}
-                />
-              </div>
-            ))}
-          </div>
+          {records.map((record) => (
+            <div key={`${groupId}:${record.entryType}:${record.id}`}>
+              <DownloadItem
+                download={record}
+                isSelected={selectedIds?.has(record.id) ?? false}
+                onToggleSelect={onToggleSelect}
+              />
+            </div>
+          ))}
        </div>
      </div>
    </div>
--- a/src/renderer/src/components/download/UnifiedDownloadHistory.tsx
+++ b/src/renderer/src/components/download/UnifiedDownloadHistory.tsx
@@ -113,6 +113,17 @@ const resolveDownloadExtension = (download: DownloadRecord): string => {
  return download.type === 'audio' ? 'mp3' : 'mp4'
 }

+const isEditableTarget = (target: EventTarget | null): boolean => {
+  if (!target || !(target instanceof HTMLElement)) {
+    return false
+  }
+  if (target.isContentEditable) {
+    return true
+  }
+  const tagName = target.tagName
+  return tagName === 'INPUT' || tagName === 'TEXTAREA' || tagName === 'SELECT'
+}
+
 interface UnifiedDownloadHistoryProps {
  onOpenSupportedSites?: () => void
  onOpenSettings?: () => void
@@ -163,6 +174,12 @@ export function UnifiedDownloadHistory({
    })
  }, [allRecords, statusFilter])

+  const visibleHistoryIds = useMemo(
+    () =>
+      filteredRecords.filter((record) => record.entryType === 'history').map((record) => record.id),
+    [filteredRecords]
+  )
+
  const filters: Array<{ key: StatusFilter; label: string; count: number }> = [
    { key: 'all', label: t('download.all'), count: downloadStats.total },
    { key: 'active', label: t('download.active'), count: downloadStats.active },
@@ -170,16 +187,34 @@ export function UnifiedDownloadHistory({
    { key: 'error', label: t('download.error'), count: downloadStats.error }
  ]

-  const selectableIds = useMemo(
-    () =>
-      filteredRecords.filter((record) => record.entryType === 'history').map((record) => record.id),
-    [filteredRecords]
-  )
+  const selectableIds = useMemo(() => {
+    if (visibleHistoryIds.length === 0) {
+      return []
+    }
+    const ids = new Set(visibleHistoryIds)
+    const playlistIds = new Set(
+      filteredRecords
+        .filter((record) => record.entryType === 'history' && record.playlistId)
+        .map((record) => record.playlistId as string)
+    )
+    if (playlistIds.size === 0) {
+      return Array.from(ids)
+    }
+    for (const record of historyRecords) {
+      if (record.playlistId && playlistIds.has(record.playlistId)) {
+        ids.add(record.id)
+      }
+    }
+    return Array.from(ids)
+  }, [filteredRecords, historyRecords, visibleHistoryIds])
  const selectableCount = selectableIds.length
+  const visibleSelectableCount = visibleHistoryIds.length
  const selectionSummary =
    selectableCount === 0
      ? t('history.selectedCount', { count: selectedCount })
-      : t('history.selectionSummary', { selected: selectedCount, total: selectableCount })
+      : selectableCount > visibleSelectableCount
+        ? t('history.selectedCount', { count: selectedCount })
+        : t('history.selectionSummary', { selected: selectedCount, total: selectableCount })

  useEffect(() => {
    if (selectedIds.size === 0) {
@@ -216,6 +251,13 @@ export function UnifiedDownloadHistory({
    setSelectedIds(new Set())
  }

+  const handleSelectAll = () => {
+    if (selectableIds.length === 0) {
+      return
+    }
+    setSelectedIds(new Set(selectableIds))
+  }
+
  const handleRequestDeleteSelected = () => {
    if (selectedIds.size === 0) {
      return
@@ -398,6 +440,41 @@ export function UnifiedDownloadHistory({
    return { order, groups }
  }, [filteredRecords])

+  useEffect(() => {
+    const handleKeyDown = (event: KeyboardEvent) => {
+      if (event.defaultPrevented) {
+        return
+      }
+      if (isEditableTarget(event.target)) {
+        return
+      }
+      if (event.key === 'Escape') {
+        if (confirmAction) {
+          return
+        }
+        if (selectedIds.size === 0) {
+          return
+        }
+        setSelectedIds(new Set())
+        return
+      }
+      if (!(event.metaKey || event.ctrlKey)) {
+        return
+      }
+      if (event.key.toLowerCase() !== 'a') {
+        return
+      }
+      if (selectableIds.length === 0) {
+        return
+      }
+      event.preventDefault()
+      setSelectedIds(new Set(selectableIds))
+    }
+
+    window.addEventListener('keydown', handleKeyDown)
+    return () => window.removeEventListener('keydown', handleKeyDown)
+  }, [confirmAction, selectableIds, selectedIds])
+
  return (
    <div className={cn('flex flex-col h-full')}>
      <CardHeader className="gap-4 p-0 px-6 py-4 z-50 bg-background backdrop-blur">
@@ -431,6 +508,15 @@ export function UnifiedDownloadHistory({
            })}
          </div>
          <div className="flex items-center gap-2">
+            <Button
+              variant="ghost"
+              size="sm"
+              className="h-8 rounded-full px-3"
+              onClick={handleSelectAll}
+              disabled={selectableIds.length === 0}
+            >
+              {t('history.selectAll')}
+            </Button>
            <DownloadDialog
              onOpenSupportedSites={onOpenSupportedSites}
              onOpenSettings={onOpenSettings}
--- a/src/renderer/src/components/feedback/FeedbackLinks.tsx
+++ b/src/renderer/src/components/feedback/FeedbackLinks.tsx
@@ -3,6 +3,7 @@ import { ipcServices } from '@renderer/lib/ipc'
 import { Github, MessageCircle, Twitter } from 'lucide-react'
 import { type MouseEvent, useEffect, useMemo, useState } from 'react'
 import { useTranslation } from 'react-i18next'
+import { toast } from 'sonner'

 type AppInfo = {
  appVersion: string
@@ -11,12 +12,13 @@ type AppInfo = {

 const DEFAULT_APP_INFO: AppInfo = { appVersion: '', osVersion: '' }
 const FEEDBACK_TWEET_PREFIX = '@nexmoex VidBee'
-export const DOWNLOAD_FEEDBACK_ISSUE_TITLE = '[bug]: Download error report'
+export const DOWNLOAD_FEEDBACK_ISSUE_TITLE = '[Bug]: Download error report'
 const FEEDBACK_UNKNOWN_ERROR = 'Unknown error'
 const FEEDBACK_UNKNOWN_VALUE = 'Unknown'
 const FEEDBACK_SOURCE_LABEL = 'Source URL'
 const FEEDBACK_ERROR_LABEL = 'Error'
 const FEEDBACK_COMMAND_LABEL = 'yt-dlp command'
+const FEEDBACK_MAX_GITHUB_URL_LENGTH = 7000

 let cachedAppInfo: AppInfo | null = null
 let appInfoPromise: Promise<AppInfo> | null = null
@@ -37,12 +39,12 @@ const buildIssueLogs = (
 ): string => {
  const lines: string[] = []
  if (sourceUrl) {
-    lines.push(`${urlLabel}: ${sourceUrl}`)
+    lines.push(`**${urlLabel}:**\n${sourceUrl}\n`)
  }
  if (ytDlpCommand) {
-    lines.push(`${commandLabel}: ${ytDlpCommand}`)
+    lines.push(`**${commandLabel}:**\n\`\`\`bash\n${ytDlpCommand}\n\`\`\`\n`)
  }
-  lines.push(`${errorLabel}: ${errorText}`)
+  lines.push(`**${errorLabel}:**\n${errorText}`)
  return lines.join('\n')
 }

@@ -106,12 +108,13 @@ type FeedbackLinkButtonsProps = {
  iconClassName?: string
  onLinkClick?: (event: MouseEvent<HTMLAnchorElement>) => void
  ytDlpCommand?: string
+  useSimpleGithubUrl?: boolean
 }

 export const FeedbackLinkButtons = ({
  error,
  sourceUrl,
-  issueTitle = '[bug]: ',
+  issueTitle = '[Bug]: ',
  includeAppInfo = false,
  appInfo,
  buttonVariant = 'outline',
@@ -119,7 +122,8 @@ export const FeedbackLinkButtons = ({
  buttonClassName,
  iconClassName,
  onLinkClick,
-  ytDlpCommand
+  ytDlpCommand,
+  useSimpleGithubUrl = false
 }: FeedbackLinkButtonsProps) => {
  const { t } = useTranslation()
  const fallbackAppInfo = useAppInfo()
@@ -138,43 +142,48 @@ export const FeedbackLinkButtons = ({
    const tweetText = encodeURIComponent(
      tweetError ? `${tweetPrefix} - ${tweetError}` : tweetPrefix
    )
-    const issueError = compactError ? clampText(compactError, 800) : FEEDBACK_UNKNOWN_ERROR
+    const issueError = compactError || FEEDBACK_UNKNOWN_ERROR
    const resolvedSourceUrl = sourceUrl?.trim() || undefined
    const normalizedCommand = ytDlpCommand?.trim() || undefined
    const shouldIncludeLogs = Boolean(compactError || resolvedSourceUrl || normalizedCommand)
    const issueLogs = shouldIncludeLogs
-      ? clampText(
-          buildIssueLogs(
-            issueError,
-            resolvedSourceUrl,
-            normalizedCommand,
-            FEEDBACK_SOURCE_LABEL,
-            FEEDBACK_ERROR_LABEL,
-            FEEDBACK_COMMAND_LABEL
-          ),
-          800
+      ? buildIssueLogs(
+          issueError,
+          resolvedSourceUrl,
+          normalizedCommand,
+          FEEDBACK_SOURCE_LABEL,
+          FEEDBACK_ERROR_LABEL,
+          FEEDBACK_COMMAND_LABEL
        )
      : null
    const appVersionValue = appVersion ? `VidBee v${appVersion}` : FEEDBACK_UNKNOWN_VALUE
    const osVersionValue = osVersion || FEEDBACK_UNKNOWN_VALUE
-    const issueParams = new URLSearchParams({
-      template: 'bug_report.yml',
-      title: issueTitle
-    })

-    if (issueLogs) {
-      issueParams.set('logs', issueLogs)
-    }
-    if (includeAppInfo) {
-      issueParams.set('app_version', appVersionValue)
-      issueParams.set('os_version', osVersionValue)
+    let githubUrl: string
+    if (useSimpleGithubUrl) {
+      githubUrl = 'https://github.com/nexmoe/VidBee/issues/new/choose'
+    } else {
+      const issueParams = new URLSearchParams({
+        template: 'bug_report.yml',
+        title: issueTitle
+      })
+
+      if (issueLogs) {
+        issueParams.set('logs', issueLogs)
+      }
+      if (includeAppInfo) {
+        issueParams.set('app_version', appVersionValue)
+        issueParams.set('os_version', osVersionValue)
+      }
+
+      githubUrl = `https://github.com/nexmoe/VidBee/issues/new?${issueParams.toString()}`
    }

    return [
      {
        icon: Github,
        label: t('about.resources.githubIssues'),
-        href: `https://github.com/nexmoe/VidBee/issues/new?${issueParams.toString()}`
+        href: githubUrl
      },
      {
        icon: Twitter,
@@ -187,7 +196,24 @@ export const FeedbackLinkButtons = ({
        href: 'https://discord.gg/uBqXV6QPdm'
      }
    ]
-  }, [appVersion, error, includeAppInfo, issueTitle, osVersion, sourceUrl, t, ytDlpCommand])
+  }, [
+    appVersion,
+    error,
+    includeAppInfo,
+    issueTitle,
+    osVersion,
+    sourceUrl,
+    t,
+    ytDlpCommand,
+    useSimpleGithubUrl
+  ])
+
+  const handleLinkClick = (event: MouseEvent<HTMLAnchorElement>, href: string) => {
+    if (href.startsWith('https://github.com') && href.length >= FEEDBACK_MAX_GITHUB_URL_LENGTH) {
+      toast.info(t('download.feedback.githubUrlTooLong'))
+    }
+    onLinkClick?.(event)
+  }

  return (
    <>
@@ -201,7 +227,12 @@ export const FeedbackLinkButtons = ({
            className={buttonClassName}
            asChild
          >
-            <a href={resource.href} target="_blank" rel="noreferrer" onClick={onLinkClick}>
+            <a
+              href={resource.href}
+              target="_blank"
+              rel="noreferrer"
+              onClick={(event) => handleLinkClick(event, resource.href)}
+            >
              <Icon className={iconClassName} />
              {resource.label}
            </a>
--- a/src/renderer/src/hooks/use-download-events.ts
+++ b/src/renderer/src/hooks/use-download-events.ts
@@ -0,0 +1,144 @@
+import { useSetAtom } from 'jotai'
+import { useCallback, useEffect } from 'react'
+import { useTranslation } from 'react-i18next'
+import { toast } from 'sonner'
+import { ipcEvents, ipcServices } from '../lib/ipc'
+import {
+  addDownloadAtom,
+  addHistoryRecordAtom,
+  removeDownloadAtom,
+  updateDownloadAtom
+} from '../store/downloads'
+
+const isFinalStatus = (status?: string): boolean =>
+  status === 'completed' || status === 'error' || status === 'cancelled'
+
+export function useDownloadEvents() {
+  const updateDownload = useSetAtom(updateDownloadAtom)
+  const addDownload = useSetAtom(addDownloadAtom)
+  const addHistoryRecord = useSetAtom(addHistoryRecordAtom)
+  const removeDownload = useSetAtom(removeDownloadAtom)
+  const { t } = useTranslation()
+
+  const syncHistoryItem = useCallback(
+    async (id: string) => {
+      try {
+        const historyItem = await ipcServices.history.getHistoryById(id)
+        if (!historyItem) {
+          return
+        }
+        addHistoryRecord(historyItem)
+        if (isFinalStatus(historyItem.status)) {
+          removeDownload(id)
+        }
+      } catch (error) {
+        console.error('Failed to sync history item:', error)
+      }
+    },
+    [addHistoryRecord, removeDownload]
+  )
+
+  useEffect(() => {
+    const syncActiveDownloads = async () => {
+      try {
+        const activeDownloads = await ipcServices.download.getActiveDownloads()
+        activeDownloads.forEach((item) => {
+          addDownload(item)
+        })
+      } catch (error) {
+        console.error('Failed to load active downloads:', error)
+      }
+    }
+
+    void syncActiveDownloads()
+  }, [addDownload])
+
+  useEffect(() => {
+    const handleStarted = (rawId: unknown) => {
+      const id = typeof rawId === 'string' ? rawId : ''
+      if (!id) {
+        return
+      }
+      updateDownload({
+        id,
+        changes: {
+          status: 'downloading',
+          startedAt: Date.now()
+        }
+      })
+    }
+
+    const handleProgress = (rawData: unknown) => {
+      const data = rawData as { id?: string; progress?: unknown }
+      const id = typeof data?.id === 'string' ? data.id : ''
+      if (!id) {
+        return
+      }
+      const progress = (data.progress ?? {}) as {
+        percent?: number
+        currentSpeed?: string
+        eta?: string
+        downloaded?: string
+        total?: string
+      }
+      updateDownload({
+        id,
+        changes: {
+          progress: {
+            percent: typeof progress.percent === 'number' ? progress.percent : 0,
+            currentSpeed: progress.currentSpeed || '',
+            eta: progress.eta || '',
+            downloaded: progress.downloaded || '',
+            total: progress.total || ''
+          },
+          speed: progress.currentSpeed || ''
+        }
+      })
+    }
+
+    const handleCompleted = (rawId: unknown) => {
+      const id = typeof rawId === 'string' ? rawId : ''
+      if (!id) {
+        return
+      }
+      updateDownload({ id, changes: { status: 'completed', completedAt: Date.now() } })
+      toast.success(t('notifications.downloadCompleted'))
+      void syncHistoryItem(id)
+    }
+
+    const handleError = (rawData: unknown) => {
+      const data = rawData as { id?: string; error?: string }
+      const id = typeof data?.id === 'string' ? data.id : ''
+      if (!id) {
+        return
+      }
+      const errorMessage = typeof data?.error === 'string' ? data.error : ''
+      updateDownload({ id, changes: { status: 'error', error: errorMessage } })
+      toast.error(t('notifications.downloadFailed'))
+      void syncHistoryItem(id)
+    }
+
+    const handleCancelled = (rawId: unknown) => {
+      const id = typeof rawId === 'string' ? rawId : ''
+      if (!id) {
+        return
+      }
+      updateDownload({ id, changes: { status: 'cancelled', completedAt: Date.now() } })
+      void syncHistoryItem(id)
+    }
+
+    const startedSubscription = ipcEvents.on('download:started', handleStarted)
+    const progressSubscription = ipcEvents.on('download:progress', handleProgress)
+    const completedSubscription = ipcEvents.on('download:completed', handleCompleted)
+    const errorSubscription = ipcEvents.on('download:error', handleError)
+    const cancelledSubscription = ipcEvents.on('download:cancelled', handleCancelled)
+
+    return () => {
+      ipcEvents.removeListener('download:started', startedSubscription)
+      ipcEvents.removeListener('download:progress', progressSubscription)
+      ipcEvents.removeListener('download:completed', completedSubscription)
+      ipcEvents.removeListener('download:error', errorSubscription)
+      ipcEvents.removeListener('download:cancelled', cancelledSubscription)
+    }
+  }, [syncHistoryItem, t, updateDownload])
+}
--- a/src/renderer/src/locales/ar.json
+++ b/src/renderer/src/locales/ar.json
@@ -27,7 +27,6 @@
    "notifications": {
      "checkingUpdates": "البحث عن التحديثات...",
      "downloadError": "فشل في تنزيل التحديث",
-      "downloadStarted": "بدأ التحميل...",
      "downloadUpdate": "تنزيل وتثبيت التحديث {{version}}؟",
      "manualDownloadAction": "تنزيل الآن",
      "noUpdatesAvailable": "أنت تستخدم أحدث إصدار",
@@ -130,6 +129,10 @@
    "error": "خطأ",
    "fetch": "جلب",
    "fetchingVideoInfo": "جلب معلومات الفيديو...",
+    "feedback": {
+      "title": "أبلغ عن هذا الخطأ:",
+      "githubUrlTooLong": "رابط GitHub هذا طويل جدًا. إذا لم يفتح، فالرجاء فتح صفحة المشكلة ولصق السجلات يدويًا."
+    },
    "history": "السجل",
    "imageLoadError": "فشل تحميل الصورة",
    "imagePlaceholder": "لا توجد صورة متاحة",
@@ -195,9 +198,6 @@
      "formatNote": "ملاحظة التنسيق",
      "protocol": "البروتوكول",
      "subscription": "الاشتراك"
-    },
-    "feedback": {
-      "title": "Report this error:"
    }
  },
  "error": {
@@ -302,7 +302,6 @@
    "copyFailed": "فشل في النسخ إلى الحافظة",
    "downloadCompleted": "اكتمل التحميل",
    "downloadFailed": "فشل التحميل",
-    "downloadStarted": "بدأ التحميل",
    "historyCleared": "تم مسح السجل",
    "historyClearFailed": "فشل مسح السجل",
    "itemRemoved": "تم إزالة العنصر",
@@ -326,7 +325,6 @@
    "description": "تحميل جميع الفيديوهات من قائمة تشغيل أو قناة YouTube",
    "downloadFailed": "فشل في بدء تحميل قائمة التشغيل",
    "downloadPlaylist": "تحميل قائمة التشغيل",
-    "downloadStarted": "بدأ تحميل {{count}} فيديو من قائمة التشغيل",
    "downloadType": "نوع التحميل",
    "downloading": "جاري تحميل قائمة التشغيل:",
    "endIndex": "النهاية",
@@ -370,6 +368,7 @@
    "audio": "تفضيلات الصوت",
    "browserForCookies": "اختر المتصفح لاستخدام ملفات تعريف الارتباط منه",
    "browserForCookiesDescription": "المتصفح لاستخراج ملفات تعريف الارتباط منه للمصادقة",
+    "browserForCookiesWindowsNote": "في Windows، يتم دعم ملفات تعريف الارتباط من Firefox فقط. للمتصفحات الأخرى، يرجى إعداد ملف ملفات تعريف الارتباط يدويًا.",
    "browserForCookiesProfile": "اسم الملف الشخصي أو المسار",
    "browserForCookiesProfileDescription": "مسار الملف الشخصي للمتصفح المحدد أعلاه. يُملأ تلقائيًا عند الإمكان.",
    "browserForCookiesProfilePlaceholder": "اسم الملف الشخصي أو المسار الكامل (اختياري)",
@@ -545,7 +544,8 @@
      "itemAlreadyQueued": "هذا الفيديو موجود بالفعل في قائمة الانتظار",
      "queueError": "فشل في الإضافة إلى قائمة انتظار التحميل.",
      "openLinkError": "فشل في فتح رابط الفيديو.",
-      "resolveError": "فشل في حل رابط تغذية RSS."
+      "resolveError": "فشل في حل رابط تغذية RSS.",
+      "duplicateUrl": "تم الاشتراك في موجز RSS هذا بالفعل."
    },
    "detectedFeed": "تم اكتشاف تغذية {{platform}} -> {{feed}}",
    "detecting": "جاري اكتشاف التغذية...",
@@ -660,4 +660,4 @@
    "popularSection": "المنصات الرئيسية",
    "viewAll": "عرض جميع المواقع المدعومة"
  }
-}
+}
--- a/src/renderer/src/locales/de.json
+++ b/src/renderer/src/locales/de.json
@@ -27,7 +27,6 @@
    "notifications": {
      "checkingUpdates": "Suche nach Updates...",
      "downloadError": "Update konnte nicht heruntergeladen werden",
-      "downloadStarted": "Download gestartet...",
      "downloadUpdate": "Update {{version}} herunterladen und installieren?",
      "manualDownloadAction": "Jetzt herunterladen",
      "noUpdatesAvailable": "Sie verwenden die neueste Version",
@@ -130,6 +129,10 @@
    "error": "Fehler",
    "fetch": "Abrufen",
    "fetchingVideoInfo": "Video-Informationen werden abgerufen...",
+    "feedback": {
+      "title": "Fehler melden:",
+      "githubUrlTooLong": "Dieser GitHub-Link ist sehr lang. Wenn er sich nicht öffnet, öffnen Sie bitte die Issue-Seite und fügen Sie die Logs manuell ein."
+    },
    "history": "Verlauf",
    "imageLoadError": "Bild konnte nicht geladen werden",
    "imagePlaceholder": "Kein Bild verfügbar",
@@ -195,9 +198,6 @@
      "formatNote": "Format-Hinweis",
      "protocol": "Protokoll",
      "subscription": "Abonnement"
-    },
-    "feedback": {
-      "title": "Report this error:"
    }
  },
  "error": {
@@ -302,7 +302,6 @@
    "copyFailed": "Kopieren in Zwischenablage fehlgeschlagen",
    "downloadCompleted": "Download abgeschlossen",
    "downloadFailed": "Download fehlgeschlagen",
-    "downloadStarted": "Download gestartet",
    "historyCleared": "Verlauf gelöscht",
    "historyClearFailed": "Verlauf konnte nicht gelöscht werden",
    "itemRemoved": "Element entfernt",
@@ -326,7 +325,6 @@
    "description": "Alle Videos aus einer YouTube-Playlist oder einem Kanal herunterladen",
    "downloadFailed": "Playlist-Download konnte nicht gestartet werden",
    "downloadPlaylist": "Playlist herunterladen",
-    "downloadStarted": "Download von {{count}} Videos aus Playlist gestartet",
    "downloadType": "Download-Typ",
    "downloading": "Playlist wird heruntergeladen:",
    "endIndex": "Ende",
@@ -370,6 +368,7 @@
    "audio": "Audio-Einstellungen",
    "browserForCookies": "Browser für Cookies auswählen",
    "browserForCookiesDescription": "Browser zum Extrahieren von Cookies für die Authentifizierung",
+    "browserForCookiesWindowsNote": "Unter Windows werden nur Firefox-Cookies unterstützt. Für andere Browser richten Sie bitte manuell eine Cookie-Datei ein.",
    "browserForCookiesProfile": "Profilname oder Pfad",
    "browserForCookiesProfileDescription": "Profilpfad für den oben ausgewählten Browser. Wird wenn möglich automatisch ausgefüllt.",
    "browserForCookiesProfilePlaceholder": "Profilname oder vollständiger Pfad (optional)",
@@ -545,7 +544,8 @@
      "itemAlreadyQueued": "Dieses Video ist bereits in der Warteschlange",
      "queueError": "Hinzufügen zur Download-Warteschlange fehlgeschlagen.",
      "openLinkError": "Video-Link konnte nicht geöffnet werden.",
-      "resolveError": "RSS-Feed-URL konnte nicht aufgelöst werden."
+      "resolveError": "RSS-Feed-URL konnte nicht aufgelöst werden.",
+      "duplicateUrl": "Dieser RSS-Feed ist bereits abonniert."
    },
    "detectedFeed": "{{platform}} Feed erkannt -> {{feed}}",
    "detecting": "Feed wird erkannt...",
@@ -660,4 +660,4 @@
    "popularSection": "Hauptplattformen",
    "viewAll": "Alle unterstützten Websites anzeigen"
  }
-}
+}
--- a/src/renderer/src/locales/en.json
+++ b/src/renderer/src/locales/en.json
@@ -27,7 +27,6 @@
    "notifications": {
      "checkingUpdates": "Looking for updates...",
      "downloadError": "Failed to download update",
-      "downloadStarted": "Download started...",
      "downloadUpdate": "Download and install update {{version}}?",
      "manualDownloadAction": "Download now",
      "noUpdatesAvailable": "You're using the latest version",
@@ -131,7 +130,8 @@
    "fetch": "Fetch",
    "fetchingVideoInfo": "Fetching video info...",
    "feedback": {
-      "title": "Report this error:"
+      "title": "Report this error:",
+      "githubUrlTooLong": "This GitHub link is very long. If it fails to open, please open the issue page and paste the logs manually."
    },
    "history": "History",
    "imageLoadError": "Image failed to load",
@@ -302,7 +302,6 @@
    "copyFailed": "Failed to copy to clipboard",
    "downloadCompleted": "Download completed",
    "downloadFailed": "Download failed",
-    "downloadStarted": "Download started",
    "historyCleared": "History cleared",
    "historyClearFailed": "Failed to clear history",
    "itemRemoved": "Item removed",
@@ -326,7 +325,6 @@
    "description": "Download all videos from a YouTube playlist or channel",
    "downloadFailed": "Failed to start playlist download",
    "downloadPlaylist": "Download Playlist",
-    "downloadStarted": "Started downloading {{count}} videos from playlist",
    "downloadType": "Download Type",
    "downloading": "Downloading playlist:",
    "endIndex": "End",
@@ -370,6 +368,7 @@
    "audio": "Audio Preferences",
    "browserForCookies": "Select browser to use cookies from",
    "browserForCookiesDescription": "Browser to extract cookies from for authentication. We'll try to detect a profile automatically.",
+    "browserForCookiesWindowsNote": "Windows only supports Firefox cookies. For other browsers, please configure a cookies file manually.",
    "browserForCookiesProfile": "Profile name or path",
    "browserForCookiesProfileDescription": "Profile path for the browser selected above. Auto-filled when possible.",
    "browserForCookiesProfilePlaceholder": "Profile name or full path (optional)",
@@ -538,6 +537,7 @@
      "missingUrl": "Please paste a channel link first.",
      "created": "Subscription added",
      "createError": "Failed to add subscription.",
+      "duplicateUrl": "This RSS feed is already subscribed.",
      "refreshStarted": "Refresh started",
      "removed": "Subscription removed",
      "updated": "Subscription updated",
--- a/src/renderer/src/locales/es.json
+++ b/src/renderer/src/locales/es.json
@@ -27,7 +27,6 @@
    "notifications": {
      "checkingUpdates": "Buscando actualizaciones...",
      "downloadError": "Error al descargar la actualización",
-      "downloadStarted": "Descarga iniciada...",
      "downloadUpdate": "¿Descargar e instalar la actualización {{version}}?",
      "manualDownloadAction": "Descargar ahora",
      "noUpdatesAvailable": "Estás usando la última versión",
@@ -130,6 +129,10 @@
    "error": "Error",
    "fetch": "Obtener",
    "fetchingVideoInfo": "Obteniendo información del video...",
+    "feedback": {
+      "title": "Informe este error:",
+      "githubUrlTooLong": "Este enlace de GitHub es muy largo. Si no se abre, abre la página de la incidencia y pega los registros manualmente."
+    },
    "history": "Historial",
    "imageLoadError": "Error al cargar la imagen",
    "imagePlaceholder": "No hay imagen disponible",
@@ -195,9 +198,6 @@
      "formatNote": "Nota de formato",
      "protocol": "Protocolo",
      "subscription": "Suscripción"
-    },
-    "feedback": {
-      "title": "Report this error:"
    }
  },
  "error": {
@@ -302,7 +302,6 @@
    "copyFailed": "Error al copiar al portapapeles",
    "downloadCompleted": "Descarga completada",
    "downloadFailed": "Error en la descarga",
-    "downloadStarted": "Descarga iniciada",
    "historyCleared": "Historial borrado",
    "historyClearFailed": "No se pudo borrar el historial",
    "itemRemoved": "Elemento eliminado",
@@ -326,7 +325,6 @@
    "description": "Descarga todos los videos de una lista de reproducción o canal de YouTube",
    "downloadFailed": "Error al iniciar la descarga de la lista de reproducción",
    "downloadPlaylist": "Descargar Lista de Reproducción",
-    "downloadStarted": "Comenzó la descarga de {{count}} videos de la lista de reproducción",
    "downloadType": "Tipo de Descarga",
    "downloading": "Descargando lista de reproducción:",
    "endIndex": "Fin",
@@ -370,6 +368,7 @@
    "audio": "Preferencias de Audio",
    "browserForCookies": "Seleccionar navegador para usar cookies",
    "browserForCookiesDescription": "Navegador del que extraer cookies para autenticación",
+    "browserForCookiesWindowsNote": "Windows solo admite cookies de Firefox. Para otros navegadores, configura manualmente un archivo de cookies.",
    "browserForCookiesProfile": "Nombre de perfil o ruta",
    "browserForCookiesProfileDescription": "Ruta del perfil para el navegador seleccionado arriba. Se completa automáticamente cuando es posible.",
    "browserForCookiesProfilePlaceholder": "Nombre de perfil o ruta completa (opcional)",
@@ -545,7 +544,8 @@
      "itemAlreadyQueued": "Este video ya está en cola",
      "queueError": "Error al agregar a la cola de descarga.",
      "openLinkError": "Error al abrir el enlace del video.",
-      "resolveError": "Error al resolver la URL del feed RSS."
+      "resolveError": "Error al resolver la URL del feed RSS.",
+      "duplicateUrl": "Este feed RSS ya está suscrito."
    },
    "detectedFeed": "Feed {{platform}} detectado -> {{feed}}",
    "detecting": "Detectando feed...",
@@ -660,4 +660,4 @@
    "popularSection": "Plataformas principales",
    "viewAll": "Ver todos los sitios soportados"
  }
-}
+}
--- a/src/renderer/src/locales/fr.json
+++ b/src/renderer/src/locales/fr.json
@@ -27,7 +27,6 @@
    "notifications": {
      "checkingUpdates": "Recherche de mises à jour...",
      "downloadError": "Échec du téléchargement de la mise à jour",
-      "downloadStarted": "Téléchargement démarré...",
      "downloadUpdate": "Télécharger et installer la mise à jour {{version}} ?",
      "manualDownloadAction": "Téléchargez maintenant",
      "noUpdatesAvailable": "Vous utilisez la dernière version",
@@ -130,6 +129,10 @@
    "error": "Erreur",
    "fetch": "Récupérer",
    "fetchingVideoInfo": "Récupération des informations vidéo...",
+    "feedback": {
+      "title": "Signalez cette erreur :",
+      "githubUrlTooLong": "Ce lien GitHub est très long. S'il ne s'ouvre pas, ouvrez la page de l'issue et collez les logs manuellement."
+    },
    "history": "Historique",
    "imageLoadError": "Échec du chargement de l'image",
    "imagePlaceholder": "Aucune image disponible",
@@ -195,9 +198,6 @@
      "formatNote": "Remarque sur le format",
      "protocol": "Protocole",
      "subscription": "Abonnement"
-    },
-    "feedback": {
-      "title": "Report this error:"
    }
  },
  "error": {
@@ -302,7 +302,6 @@
    "copyFailed": "Échec de la copie dans le presse-papiers",
    "downloadCompleted": "Téléchargement terminé",
    "downloadFailed": "Échec du téléchargement",
-    "downloadStarted": "Téléchargement démarré",
    "historyCleared": "Historique effacé",
    "historyClearFailed": "Échec de l'effacement de l'historique",
    "itemRemoved": "Élément supprimé",
@@ -326,7 +325,6 @@
    "description": "Télécharger toutes les vidéos d'une playlist ou chaîne YouTube",
    "downloadFailed": "Échec du démarrage du téléchargement de playlist",
    "downloadPlaylist": "Télécharger la Playlist",
-    "downloadStarted": "Démarré le téléchargement de {{count}} vidéos de la playlist",
    "downloadType": "Type de Téléchargement",
    "downloading": "Téléchargement de la playlist :",
    "endIndex": "Fin",
@@ -370,6 +368,7 @@
    "audio": "Préférences Audio",
    "browserForCookies": "Sélectionner le navigateur pour utiliser les cookies",
    "browserForCookiesDescription": "Navigateur pour extraire les cookies pour l'authentification",
+    "browserForCookiesWindowsNote": "Sous Windows, seuls les cookies de Firefox sont pris en charge. Pour les autres navigateurs, configurez un fichier de cookies manuellement.",
    "browserForCookiesProfile": "Nom du profil ou chemin",
    "browserForCookiesProfileDescription": "Chemin du profil pour le navigateur sélectionné ci-dessus. Rempli automatiquement si possible.",
    "browserForCookiesProfilePlaceholder": "Nom du profil ou chemin complet (facultatif)",
@@ -545,7 +544,8 @@
      "itemAlreadyQueued": "Cette vidéo est déjà en file d'attente",
      "queueError": "Échec de l'ajout à la file d'attente de téléchargement.",
      "openLinkError": "Échec de l'ouverture du lien vidéo.",
-      "resolveError": "Échec de la résolution de l'URL du flux RSS."
+      "resolveError": "Échec de la résolution de l'URL du flux RSS.",
+      "duplicateUrl": "Ce flux RSS est déjà abonné."
    },
    "detectedFeed": "Flux {{platform}} détecté -> {{feed}}",
    "detecting": "Détection du flux...",
@@ -660,4 +660,4 @@
    "popularSection": "Plateformes principales",
    "viewAll": "Voir tous les sites supportés"
  }
-}
+}
--- a/src/renderer/src/locales/id.json
+++ b/src/renderer/src/locales/id.json
@@ -27,7 +27,6 @@
    "notifications": {
      "checkingUpdates": "Mencari pembaruan...",
      "downloadError": "Gagal mengunduh pembaruan",
-      "downloadStarted": "Unduhan dimulai...",
      "downloadUpdate": "Unduh dan instal pembaruan {{version}}?",
      "manualDownloadAction": "Unduh sekarang",
      "noUpdatesAvailable": "Anda menggunakan versi terbaru",
@@ -130,6 +129,10 @@
    "error": "Kesalahan",
    "fetch": "Ambil",
    "fetchingVideoInfo": "Mengambil info video...",
+    "feedback": {
+      "title": "Laporkan kesalahan ini:",
+      "githubUrlTooLong": "Tautan GitHub ini sangat panjang. Jika tidak terbuka, buka halaman issue dan tempel log secara manual."
+    },
    "history": "Riwayat",
    "imageLoadError": "Gagal memuat gambar",
    "imagePlaceholder": "Tidak ada gambar tersedia",
@@ -195,9 +198,6 @@
      "formatNote": "Catatan format",
      "protocol": "Protokol",
      "subscription": "Berlangganan"
-    },
-    "feedback": {
-      "title": "Report this error:"
    }
  },
  "error": {
@@ -302,7 +302,6 @@
    "copyFailed": "Gagal menyalin ke clipboard",
    "downloadCompleted": "Unduhan selesai",
    "downloadFailed": "Unduhan gagal",
-    "downloadStarted": "Unduhan dimulai",
    "historyCleared": "Riwayat dihapus",
    "historyClearFailed": "Gagal menghapus riwayat",
    "itemRemoved": "Item dihapus",
@@ -326,7 +325,6 @@
    "description": "Unduh semua video dari playlist atau saluran YouTube",
    "downloadFailed": "Gagal memulai unduhan playlist",
    "downloadPlaylist": "Unduh Playlist",
-    "downloadStarted": "Mulai mengunduh {{count}} video dari playlist",
    "downloadType": "Jenis Unduhan",
    "downloading": "Mengunduh playlist:",
    "endIndex": "Akhir",
@@ -370,6 +368,7 @@
    "audio": "Preferensi Audio",
    "browserForCookies": "Pilih browser untuk menggunakan cookie",
    "browserForCookiesDescription": "Browser untuk mengekstrak cookie untuk autentikasi",
+    "browserForCookiesWindowsNote": "Di Windows, hanya cookie Firefox yang didukung. Untuk browser lain, silakan konfigurasi file cookie secara manual.",
    "browserForCookiesProfile": "Nama profil atau path",
    "browserForCookiesProfileDescription": "Path profil untuk browser yang dipilih di atas. Diisi otomatis bila memungkinkan.",
    "browserForCookiesProfilePlaceholder": "Nama profil atau path lengkap (opsional)",
@@ -545,7 +544,8 @@
      "itemAlreadyQueued": "Video ini sudah diantre",
      "queueError": "Gagal menambahkan ke antrian unduhan.",
      "openLinkError": "Gagal membuka tautan video.",
-      "resolveError": "Gagal menyelesaikan URL feed RSS."
+      "resolveError": "Gagal menyelesaikan URL feed RSS.",
+      "duplicateUrl": "Feed RSS ini sudah berlangganan."
    },
    "detectedFeed": "Feed {{platform}} terdeteksi -> {{feed}}",
    "detecting": "Mendeteksi feed...",
@@ -660,4 +660,4 @@
    "popularSection": "Platform utama",
    "viewAll": "Lihat semua situs yang didukung"
  }
-}
+}
--- a/src/renderer/src/locales/it.json
+++ b/src/renderer/src/locales/it.json
@@ -27,7 +27,6 @@
    "notifications": {
      "checkingUpdates": "Ricerca aggiornamenti...",
      "downloadError": "Errore nel download dell'aggiornamento",
-      "downloadStarted": "Download iniziato...",
      "downloadUpdate": "Scarica e installa l'aggiornamento {{version}}?",
      "manualDownloadAction": "Scarica ora",
      "noUpdatesAvailable": "Stai usando l'ultima versione",
@@ -130,6 +129,10 @@
    "error": "Errore",
    "fetch": "Recupera",
    "fetchingVideoInfo": "Recupero informazioni video...",
+    "feedback": {
+      "title": "Segnala questo errore:",
+      "githubUrlTooLong": "Questo link GitHub è molto lungo. Se non si apre, apri la pagina dell'issue e incolla i log manualmente."
+    },
    "history": "Cronologia",
    "imageLoadError": "Errore nel caricamento dell'immagine",
    "imagePlaceholder": "Nessuna immagine disponibile",
@@ -195,9 +198,6 @@
      "formatNote": "Nota sul formato",
      "protocol": "Protocollo",
      "subscription": "Sottoscrizione"
-    },
-    "feedback": {
-      "title": "Report this error:"
    }
  },
  "error": {
@@ -302,7 +302,6 @@
    "copyFailed": "Errore nella copia negli appunti",
    "downloadCompleted": "Download completato",
    "downloadFailed": "Download fallito",
-    "downloadStarted": "Download iniziato",
    "historyCleared": "Cronologia cancellata",
    "historyClearFailed": "Impossibile cancellare la cronologia",
    "itemRemoved": "Elemento rimosso",
@@ -326,7 +325,6 @@
    "description": "Scarica tutti i video da una playlist o canale YouTube",
    "downloadFailed": "Errore nell'avvio del download playlist",
    "downloadPlaylist": "Scarica Playlist",
-    "downloadStarted": "Iniziato download di {{count}} video dalla playlist",
    "downloadType": "Tipo Download",
    "downloading": "Scaricando playlist:",
    "endIndex": "Fine",
@@ -370,6 +368,7 @@
    "audio": "Preferenze Audio",
    "browserForCookies": "Seleziona browser per usare i cookie",
    "browserForCookiesDescription": "Browser per estrarre i cookie per l'autenticazione",
+    "browserForCookiesWindowsNote": "Su Windows sono supportati solo i cookie di Firefox. Per altri browser, configura manualmente un file di cookie.",
    "browserForCookiesProfile": "Nome profilo o percorso",
    "browserForCookiesProfileDescription": "Percorso del profilo per il browser selezionato sopra. Compilato automaticamente quando possibile.",
    "browserForCookiesProfilePlaceholder": "Nome profilo o percorso completo (opzionale)",
@@ -545,7 +544,8 @@
      "itemAlreadyQueued": "Questo video è già in coda",
      "queueError": "Impossibile aggiungere alla coda di download.",
      "openLinkError": "Impossibile aprire il collegamento video.",
-      "resolveError": "Impossibile risolvere l'URL del feed RSS."
+      "resolveError": "Impossibile risolvere l'URL del feed RSS.",
+      "duplicateUrl": "Questo feed RSS è già sottoscritto."
    },
    "detectedFeed": "Feed {{platform}} rilevato -> {{feed}}",
    "detecting": "Rilevamento alimentazione...",
@@ -660,4 +660,4 @@
    "popularSection": "Piattaforme principali",
    "viewAll": "Visualizza tutti i siti supportati"
  }
-}
+}
--- a/src/renderer/src/locales/ja.json
+++ b/src/renderer/src/locales/ja.json
@@ -27,7 +27,6 @@
    "notifications": {
      "checkingUpdates": "アップデートを検索中...",
      "downloadError": "アップデートのダウンロードに失敗",
-      "downloadStarted": "ダウンロード開始...",
      "downloadUpdate": "アップデート{{version}}をダウンロードしてインストールしますか？",
      "manualDownloadAction": "今すぐダウンロード",
      "noUpdatesAvailable": "最新バージョンを使用しています",
@@ -130,6 +129,10 @@
    "error": "エラー",
    "fetch": "取得",
    "fetchingVideoInfo": "ビデオ情報を取得中...",
+    "feedback": {
+      "title": "このエラーを報告:",
+      "githubUrlTooLong": "このGitHubリンクは非常に長いです。開けない場合は、issueページを開いてログを手動で貼り付けてください。"
+    },
    "history": "履歴",
    "imageLoadError": "画像の読み込みに失敗",
    "imagePlaceholder": "利用可能な画像なし",
@@ -195,9 +198,6 @@
      "formatNote": "メモのフォーマット",
      "protocol": "プロトコル",
      "subscription": "サブスクリプション"
-    },
-    "feedback": {
-      "title": "Report this error:"
    }
  },
  "error": {
@@ -302,7 +302,6 @@
    "copyFailed": "クリップボードへのコピーに失敗",
    "downloadCompleted": "ダウンロード完了",
    "downloadFailed": "ダウンロードに失敗",
-    "downloadStarted": "ダウンロード開始",
    "historyCleared": "履歴をクリアしました",
    "historyClearFailed": "履歴のクリアに失敗しました",
    "itemRemoved": "アイテムが削除されました",
@@ -326,7 +325,6 @@
    "description": "YouTubeプレイリストまたはチャンネルからすべてのビデオをダウンロード",
    "downloadFailed": "プレイリストダウンロードの開始に失敗",
    "downloadPlaylist": "プレイリストをダウンロード",
-    "downloadStarted": "プレイリストから{{count}}個のビデオのダウンロードを開始",
    "downloadType": "ダウンロードタイプ",
    "downloading": "プレイリストをダウンロード中：",
    "endIndex": "終了",
@@ -370,6 +368,7 @@
    "audio": "オーディオ設定",
    "browserForCookies": "Cookieに使用するブラウザを選択",
    "browserForCookiesDescription": "認証用のCookieを抽出するブラウザ",
+    "browserForCookiesWindowsNote": "Windows では Firefox の Cookie のみ対応しています。他のブラウザは Cookie ファイルを手動で設定してください。",
    "browserForCookiesProfile": "プロファイル名またはパス",
    "browserForCookiesProfileDescription": "上で選択したブラウザのプロファイルパス。可能な場合は自動入力されます。",
    "browserForCookiesProfilePlaceholder": "プロファイル名または完全なパス（任意）",
@@ -545,7 +544,8 @@
      "itemAlreadyQueued": "このビデオはすでにキューに登録されています",
      "queueError": "ダウンロードキューへの追加に失敗しました。",
      "openLinkError": "ビデオリンクを開けませんでした。",
-      "resolveError": "RSS フィード URL を解決できませんでした。"
+      "resolveError": "RSS フィード URL を解決できませんでした。",
+      "duplicateUrl": "このRSSフィードはすでに登録されています。"
    },
    "detectedFeed": "{{platform}} フィードが検出されました -> {{feed}}",
    "detecting": "フィードを検出中...",
@@ -660,4 +660,4 @@
    "popularSection": "主要プラットフォーム",
    "viewAll": "サポートされているすべてのサイトを表示"
  }
-}
+}
--- a/src/renderer/src/locales/ko.json
+++ b/src/renderer/src/locales/ko.json
@@ -27,7 +27,6 @@
    "notifications": {
      "checkingUpdates": "업데이트 검색 중...",
      "downloadError": "업데이트 다운로드 실패",
-      "downloadStarted": "다운로드 시작...",
      "downloadUpdate": "업데이트 {{version}}을(를) 다운로드하고 설치하시겠습니까?",
      "manualDownloadAction": "지금 다운로드",
      "noUpdatesAvailable": "최신 버전을 사용 중입니다",
@@ -130,6 +129,10 @@
    "error": "오류",
    "fetch": "가져오기",
    "fetchingVideoInfo": "비디오 정보 가져오는 중...",
+    "feedback": {
+      "title": "이 오류를 보고:",
+      "githubUrlTooLong": "이 GitHub 링크가 매우 깁니다. 열리지 않으면 이슈 페이지를 열고 로그를 수동으로 붙여 넣어 주세요."
+    },
    "history": "기록",
    "imageLoadError": "이미지 로드 실패",
    "imagePlaceholder": "사용 가능한 이미지 없음",
@@ -195,9 +198,6 @@
      "formatNote": "메모 형식",
      "protocol": "규약",
      "subscription": "신청"
-    },
-    "feedback": {
-      "title": "Report this error:"
    }
  },
  "error": {
@@ -302,7 +302,6 @@
    "copyFailed": "클립보드에 복사 실패",
    "downloadCompleted": "다운로드 완료",
    "downloadFailed": "다운로드 실패",
-    "downloadStarted": "다운로드 시작됨",
    "historyCleared": "기록이 지워졌습니다",
    "historyClearFailed": "기록을 지우지 못했습니다",
    "itemRemoved": "항목 제거됨",
@@ -326,7 +325,6 @@
    "description": "YouTube 재생목록 또는 채널의 모든 비디오 다운로드",
    "downloadFailed": "재생목록 다운로드 시작 실패",
    "downloadPlaylist": "재생목록 다운로드",
-    "downloadStarted": "재생목록에서 {{count}}개 비디오 다운로드 시작됨",
    "downloadType": "다운로드 유형",
    "downloading": "재생목록 다운로드 중:",
    "endIndex": "끝",
@@ -370,6 +368,7 @@
    "audio": "오디오 환경설정",
    "browserForCookies": "쿠키를 사용할 브라우저 선택",
    "browserForCookiesDescription": "인증을 위한 쿠키 추출 브라우저",
+    "browserForCookiesWindowsNote": "Windows에서는 Firefox 쿠키만 지원됩니다. 다른 브라우저는 쿠키 파일을 수동으로 설정하세요.",
    "browserForCookiesProfile": "프로필 이름 또는 경로",
    "browserForCookiesProfileDescription": "위에서 선택한 브라우저의 프로필 경로입니다. 가능하면 자동으로 채워집니다.",
    "browserForCookiesProfilePlaceholder": "프로필 이름 또는 전체 경로(선택 사항)",
@@ -545,7 +544,8 @@
      "itemAlreadyQueued": "이 동영상은 이미 대기열에 있습니다.",
      "queueError": "다운로드 대기열에 추가하지 못했습니다.",
      "openLinkError": "동영상 링크를 열지 못했습니다.",
-      "resolveError": "RSS 피드 URL을 확인하지 못했습니다."
+      "resolveError": "RSS 피드 URL을 확인하지 못했습니다.",
+      "duplicateUrl": "이 RSS 피드는 이미 구독되어 있습니다."
    },
    "detectedFeed": "{{platform}} 피드 감지됨 -> {{feed}}",
    "detecting": "피드 감지 중...",
@@ -660,4 +660,4 @@
    "popularSection": "주요 플랫폼",
    "viewAll": "지원되는 모든 사이트 보기"
  }
-}
+}
--- a/src/renderer/src/locales/pt.json
+++ b/src/renderer/src/locales/pt.json
@@ -27,7 +27,6 @@
    "notifications": {
      "checkingUpdates": "Procurando atualizações...",
      "downloadError": "Falha ao baixar atualização",
-      "downloadStarted": "Download iniciado...",
      "downloadUpdate": "Baixar e instalar atualização {{version}}?",
      "manualDownloadAction": "Baixe agora",
      "noUpdatesAvailable": "Você está usando a versão mais recente",
@@ -130,6 +129,10 @@
    "error": "Erro",
    "fetch": "Buscar",
    "fetchingVideoInfo": "Buscando informações do vídeo...",
+    "feedback": {
+      "title": "Relatar este erro:",
+      "githubUrlTooLong": "Este link do GitHub é muito longo. Se não abrir, abra a página da issue e cole os logs manualmente."
+    },
    "history": "Histórico",
    "imageLoadError": "Falha ao carregar imagem",
    "imagePlaceholder": "Nenhuma imagem disponível",
@@ -195,9 +198,6 @@
      "formatNote": "Formatar nota",
      "protocol": "Protocolo",
      "subscription": "Subscrição"
-    },
-    "feedback": {
-      "title": "Report this error:"
    }
  },
  "error": {
@@ -302,7 +302,6 @@
    "copyFailed": "Falha ao copiar para área de transferência",
    "downloadCompleted": "Download concluído",
    "downloadFailed": "Download falhou",
-    "downloadStarted": "Download iniciado",
    "historyCleared": "Histórico limpo",
    "historyClearFailed": "Falha ao limpar histórico",
    "itemRemoved": "Item removido",
@@ -326,7 +325,6 @@
    "description": "Baixar todos os vídeos de uma playlist ou canal do YouTube",
    "downloadFailed": "Falha ao iniciar download da playlist",
    "downloadPlaylist": "Baixar Playlist",
-    "downloadStarted": "Iniciado download de {{count}} vídeos da playlist",
    "downloadType": "Tipo de Download",
    "downloading": "Baixando playlist:",
    "endIndex": "Fim",
@@ -370,6 +368,7 @@
    "audio": "Preferências de Áudio",
    "browserForCookies": "Selecionar navegador para usar cookies",
    "browserForCookiesDescription": "Navegador para extrair cookies para autenticação",
+    "browserForCookiesWindowsNote": "No Windows, apenas cookies do Firefox são suportados. Para outros navegadores, configure um arquivo de cookies manualmente.",
    "browserForCookiesProfile": "Nome do perfil ou caminho",
    "browserForCookiesProfileDescription": "Caminho do perfil para o navegador selecionado acima. Preenchido automaticamente quando possível.",
    "browserForCookiesProfilePlaceholder": "Nome do perfil ou caminho completo (opcional)",
@@ -545,7 +544,8 @@
      "itemAlreadyQueued": "Este vídeo já está na fila",
      "queueError": "Falha ao adicionar à fila de download.",
      "openLinkError": "Falha ao abrir o link do vídeo.",
-      "resolveError": "Falha ao resolver o URL do feed RSS."
+      "resolveError": "Falha ao resolver o URL do feed RSS.",
+      "duplicateUrl": "Este feed RSS já está inscrito."
    },
    "detectedFeed": "Feed de {{platform}} detectado -> {{feed}}",
    "detecting": "Detectando feed...",
@@ -660,4 +660,4 @@
    "popularSection": "Plataformas principais",
    "viewAll": "Ver todos os sites suportados"
  }
-}
+}
--- a/src/renderer/src/locales/ru.json
+++ b/src/renderer/src/locales/ru.json
@@ -27,7 +27,6 @@
    "notifications": {
      "checkingUpdates": "Поиск обновлений...",
      "downloadError": "Не удалось загрузить обновление",
-      "downloadStarted": "Загрузка началась...",
      "downloadUpdate": "Загрузить и установить обновление {{version}}?",
      "manualDownloadAction": "Скачать сейчас",
      "noUpdatesAvailable": "Вы используете последнюю версию",
@@ -130,6 +129,10 @@
    "error": "Ошибка",
    "fetch": "Получить",
    "fetchingVideoInfo": "Получение информации о видео...",
+    "feedback": {
+      "title": "Сообщить об этой ошибке:",
+      "githubUrlTooLong": "Эта ссылка GitHub очень длинная. Если она не открывается, откройте страницу issue и вставьте логи вручную."
+    },
    "history": "История",
    "imageLoadError": "Не удалось загрузить изображение",
    "imagePlaceholder": "Изображение недоступно",
@@ -195,9 +198,6 @@
      "formatNote": "Примечание формата",
      "protocol": "Протокол",
      "subscription": "Подписка"
-    },
-    "feedback": {
-      "title": "Report this error:"
    }
  },
  "error": {
@@ -302,7 +302,6 @@
    "copyFailed": "Не удалось скопировать в буфер обмена",
    "downloadCompleted": "Загрузка завершена",
    "downloadFailed": "Загрузка не удалась",
-    "downloadStarted": "Загрузка началась",
    "historyCleared": "История очищена",
    "historyClearFailed": "Не удалось очистить историю",
    "itemRemoved": "Элемент удалён",
@@ -326,7 +325,6 @@
    "description": "Загрузить все видео из плейлиста или канала YouTube",
    "downloadFailed": "Не удалось начать загрузку плейлиста",
    "downloadPlaylist": "Загрузить плейлист",
-    "downloadStarted": "Начата загрузка {{count}} видео из плейлиста",
    "downloadType": "Тип загрузки",
    "downloading": "Загрузка плейлиста:",
    "endIndex": "Конец",
@@ -370,6 +368,7 @@
    "audio": "Настройки аудио",
    "browserForCookies": "Выбрать браузер для использования cookie",
    "browserForCookiesDescription": "Браузер для извлечения cookie для аутентификации",
+    "browserForCookiesWindowsNote": "В Windows поддерживаются только cookie Firefox. Для других браузеров вручную укажите файл cookie.",
    "browserForCookiesProfile": "Имя профиля или путь",
    "browserForCookiesProfileDescription": "Путь профиля для выбранного выше браузера. Заполняется автоматически, если возможно.",
    "browserForCookiesProfilePlaceholder": "Имя профиля или полный путь (необязательно)",
@@ -545,7 +544,8 @@
      "itemAlreadyQueued": "Это видео уже в очереди",
      "queueError": "Не удалось добавить в очередь загрузки.",
      "openLinkError": "Не удалось открыть ссылку на видео.",
-      "resolveError": "Не удалось разрешить URL RSS-канала."
+      "resolveError": "Не удалось разрешить URL RSS-канала.",
+      "duplicateUrl": "Этот RSS-канал уже добавлен."
    },
    "detectedFeed": "Обнаружен канал {{platform}} -> {{feed}}",
    "detecting": "Определение канала...",
@@ -660,4 +660,4 @@
    "popularSection": "Основные платформы",
    "viewAll": "Просмотреть все поддерживаемые сайты"
  }
-}
+}
--- a/src/renderer/src/locales/zh-TW.json
+++ b/src/renderer/src/locales/zh-TW.json
@@ -27,7 +27,6 @@
    "notifications": {
      "checkingUpdates": "正在搜尋更新...",
      "downloadError": "下載更新失敗",
-      "downloadStarted": "開始下載...",
      "downloadUpdate": "下載並安裝更新 {{version}}？",
      "manualDownloadAction": "立即下載",
      "noUpdatesAvailable": "您正在使用最新版本",
@@ -130,6 +129,10 @@
    "error": "錯誤",
    "fetch": "取得",
    "fetchingVideoInfo": "正在取得影片資訊...",
+    "feedback": {
+      "title": "報告此錯誤:",
+      "githubUrlTooLong": "這個 GitHub 連結很長。如果無法開啟，請開啟 issue 頁面並手動貼上日誌。"
+    },
    "history": "歷史",
    "imageLoadError": "圖片載入失敗",
    "imagePlaceholder": "暫無圖片",
@@ -195,9 +198,6 @@
      "formatNote": "格式註釋",
      "protocol": "協定",
      "subscription": "訂閱"
-    },
-    "feedback": {
-      "title": "Report this error:"
    }
  },
  "error": {
@@ -302,7 +302,6 @@
    "copyFailed": "複製到剪貼簿失敗",
    "downloadCompleted": "下載完成",
    "downloadFailed": "下載失敗",
-    "downloadStarted": "下載已開始",
    "historyCleared": "歷史紀錄已清除",
    "historyClearFailed": "清除歷史紀錄失敗",
    "itemRemoved": "項目已移除",
@@ -326,7 +325,6 @@
    "description": "下載 YouTube 播放清單或頻道中的全部影片",
    "downloadFailed": "啟動播放清單下載失敗",
    "downloadPlaylist": "下載播放清單",
-    "downloadStarted": "已開始下載播放清單中的 {{count}} 個影片",
    "downloadType": "下載類型",
    "downloading": "正在下載播放清單：",
    "endIndex": "結束",
@@ -370,6 +368,7 @@
    "audio": "音訊偏好",
    "browserForCookies": "選擇用於讀取 Cookie 的瀏覽器",
    "browserForCookiesDescription": "用於身份驗證的瀏覽器 Cookie 提取",
+    "browserForCookiesWindowsNote": "Windows 僅支援 Firefox 的 cookie，其他瀏覽器請手動設定 cookie 檔案。",
    "browserForCookiesProfile": "設定檔名稱或路徑",
    "browserForCookiesProfileDescription": "上方選取之瀏覽器的設定檔路徑。如可用將自動填入。",
    "browserForCookiesProfilePlaceholder": "設定檔名稱或完整路徑（選填）",
@@ -545,7 +544,8 @@
      "itemAlreadyQueued": "該視頻已排隊",
      "queueError": "無法添加到下載隊列。",
      "openLinkError": "無法打開視頻鏈接。",
-      "resolveError": "無法解析 RSS 源 URL。"
+      "resolveError": "無法解析 RSS 源 URL。",
+      "duplicateUrl": "此 RSS 訂閱已存在。"
    },
    "detectedFeed": "檢測到 {{platform}} feed -> {{feed}}",
    "detecting": "檢測飼料...",
@@ -660,4 +660,4 @@
    "popularSection": "主流平台",
    "viewAll": "檢視全部支援的網站"
  }
-}
+}
--- a/src/renderer/src/locales/zh.json
+++ b/src/renderer/src/locales/zh.json
@@ -27,7 +27,6 @@
    "notifications": {
      "checkingUpdates": "正在查找更新...",
      "downloadError": "下载更新失败",
-      "downloadStarted": "开始下载...",
      "downloadUpdate": "下载并安装更新 {{version}}？",
      "manualDownloadAction": "立即下载",
      "noUpdatesAvailable": "您正在使用最新版本",
@@ -130,6 +129,10 @@
    "error": "错误",
    "fetch": "获取",
    "fetchingVideoInfo": "正在获取视频信息...",
+    "feedback": {
+      "title": "报告此错误:",
+      "githubUrlTooLong": "这个 GitHub 链接很长。如果无法打开，请打开 issue 页面并手动粘贴日志。"
+    },
    "history": "历史",
    "imageLoadError": "图像加载失败",
    "imagePlaceholder": "暂无图像",
@@ -195,9 +198,6 @@
      "formatNote": "格式注释",
      "protocol": "协议",
      "subscription": "订阅"
-    },
-    "feedback": {
-      "title": "Report this error:"
    }
  },
  "error": {
@@ -302,7 +302,6 @@
    "copyFailed": "复制到剪贴板失败",
    "downloadCompleted": "下载完成",
    "downloadFailed": "下载失败",
-    "downloadStarted": "下载已开始",
    "historyCleared": "历史记录已清除",
    "historyClearFailed": "清除历史记录失败",
    "itemRemoved": "项目已移除",
@@ -326,7 +325,6 @@
    "description": "下载 YouTube 播放列表或频道中的全部视频",
    "downloadFailed": "启动播放列表下载失败",
    "downloadPlaylist": "下载播放列表",
-    "downloadStarted": "已开始下载播放列表中的 {{count}} 个视频",
    "downloadType": "下载类型",
    "downloading": "正在下载播放列表：",
    "endIndex": "结束",
@@ -370,6 +368,7 @@
    "audio": "音频偏好",
    "browserForCookies": "选择用于读取 Cookie 的浏览器",
    "browserForCookiesDescription": "用于身份验证的浏览器 Cookie 提取",
+    "browserForCookiesWindowsNote": "Windows 仅支持 Firefox 的 cookie，其他浏览器请手动配置 cookie 文件。",
    "browserForCookiesProfile": "配置文件名称或路径",
    "browserForCookiesProfileDescription": "上方所选浏览器的配置文件路径。如可用会自动填写。",
    "browserForCookiesProfilePlaceholder": "配置文件名称或完整路径（可选）",
@@ -545,7 +544,8 @@
      "itemAlreadyQueued": "该视频已排队",
      "queueError": "无法添加到下载队列。",
      "openLinkError": "无法打开视频链接。",
-      "resolveError": "无法解析 RSS 源 URL。"
+      "resolveError": "无法解析 RSS 源 URL。",
+      "duplicateUrl": "该 RSS 订阅已存在。"
    },
    "detectedFeed": "检测到 {{platform}} feed -> {{feed}}",
    "detecting": "检测饲料...",
@@ -660,4 +660,4 @@
    "popularSection": "主流平台",
    "viewAll": "查看全部支持的网站"
  }
-}
+}
--- a/src/renderer/src/pages/About.tsx
+++ b/src/renderer/src/pages/About.tsx
@@ -445,7 +445,7 @@ export function About() {
                <div className="flex flex-wrap gap-2">
                  <FeedbackLinkButtons
                    appInfo={{ appVersion, osVersion }}
-                    issueTitle="[bug]: "
+                    useSimpleGithubUrl={true}
                    buttonClassName="gap-2"
                    iconClassName="h-4 w-4"
                  />
--- a/src/renderer/src/pages/Settings.tsx
+++ b/src/renderer/src/pages/Settings.tsx
@@ -520,30 +520,26 @@ export function Settings() {

              <ItemSeparator />

-              {platform !== 'darwin' && (
-                <>
-                  <Item variant="muted">
-                    <ItemContent>
-                      <ItemTitle>{t('settings.embedThumbnail')}</ItemTitle>
-                      <ItemDescription>{t('settings.embedThumbnailDescription')}</ItemDescription>
-                    </ItemContent>
-                    <ItemActions>
-                      <Switch
-                        checked={settings.embedThumbnail ?? false}
-                        onCheckedChange={(value) => {
-                          try {
-                            handleSettingChange('embedThumbnail', value)
-                          } catch (error) {
-                            logger.error('[Settings] Error toggling embedThumbnail:', error)
-                          }
-                        }}
-                      />
-                    </ItemActions>
-                  </Item>
+              <Item variant="muted">
+                <ItemContent>
+                  <ItemTitle>{t('settings.embedThumbnail')}</ItemTitle>
+                  <ItemDescription>{t('settings.embedThumbnailDescription')}</ItemDescription>
+                </ItemContent>
+                <ItemActions>
+                  <Switch
+                    checked={settings.embedThumbnail ?? false}
+                    onCheckedChange={(value) => {
+                      try {
+                        handleSettingChange('embedThumbnail', value)
+                      } catch (error) {
+                        logger.error('[Settings] Error toggling embedThumbnail:', error)
+                      }
+                    }}
+                  />
+                </ItemActions>
+              </Item>

-                  <ItemSeparator />
-                </>
-              )}
+              <ItemSeparator />

              <Item variant="muted">
                <ItemContent>
@@ -676,6 +672,9 @@ export function Settings() {
                <ItemContent>
                  <ItemTitle>{t('settings.browserForCookies')}</ItemTitle>
                  <ItemDescription>{t('settings.browserForCookiesDescription')}</ItemDescription>
+                  {platform === 'win32' && (
+                    <ItemDescription>{t('settings.browserForCookiesWindowsNote')}</ItemDescription>
+                  )}
                </ItemContent>
                <ItemActions>
                  {(() => {
--- a/src/renderer/src/pages/Subscriptions.tsx
+++ b/src/renderer/src/pages/Subscriptions.tsx
@@ -35,6 +35,7 @@ import {
  updateSubscriptionAtom
 } from '@renderer/store/subscriptions'
 import type { DownloadStatus, SubscriptionFeedItem, SubscriptionRule } from '@shared/types'
+import { SUBSCRIPTION_DUPLICATE_FEED_ERROR } from '@shared/types'
 import dayjs from 'dayjs'
 import { useAtom, useAtomValue, useSetAtom } from 'jotai'
 import { Download, Edit, ExternalLink, Plus, Power, RefreshCw, Trash2 } from 'lucide-react'
@@ -87,6 +88,41 @@ const subscriptionItemStatusLabels: Record<SubscriptionItemStatus, string> = {
  cancelled: 'subscriptions.items.status.cancelled'
 }

+const getErrorMessage = (error: unknown): string | undefined => {
+  if (!error) {
+    return undefined
+  }
+  if (typeof error === 'string') {
+    return error
+  }
+  if (typeof error === 'object') {
+    if ('message' in error && typeof error.message === 'string') {
+      return error.message
+    }
+    if ('code' in error && typeof error.code === 'string') {
+      return error.code
+    }
+    if ('error' in error) {
+      const nested = (error as { error?: unknown }).error
+      if (typeof nested === 'string') {
+        return nested
+      }
+      if (nested && typeof nested === 'object' && 'message' in nested) {
+        const nestedMessage = (nested as { message?: unknown }).message
+        if (typeof nestedMessage === 'string') {
+          return nestedMessage
+        }
+      }
+    }
+  }
+  return undefined
+}
+
+const isDuplicateFeedError = (error: unknown) => {
+  const message = getErrorMessage(error)
+  return Boolean(message?.includes(SUBSCRIPTION_DUPLICATE_FEED_ERROR))
+}
+
 function SubscriptionTab({
  subscription,
  onRefresh,
@@ -252,8 +288,17 @@ export function Subscriptions() {
        }
      }

-      await updateSubscription({ id, data: updatePayload })
-      await refreshSubscription(id)
+      try {
+        await updateSubscription({ id, data: updatePayload })
+        await refreshSubscription(id)
+      } catch (error) {
+        console.error('Failed to update subscription:', error)
+        toast.error(
+          isDuplicateFeedError(error)
+            ? t('subscriptions.notifications.duplicateUrl')
+            : t('subscriptions.notifications.createError')
+        )
+      }
    },
    [refreshSubscription, updateSubscription, resolveFeed, t]
  )
@@ -281,7 +326,11 @@ export function Subscriptions() {
        setAddDialogOpen(false)
      } catch (error) {
        console.error('Failed to create subscription:', error)
-        toast.error(t('subscriptions.notifications.createError'))
+        toast.error(
+          isDuplicateFeedError(error)
+            ? t('subscriptions.notifications.duplicateUrl')
+            : t('subscriptions.notifications.createError')
+        )
      }
    },
    [createSubscription, t]
--- a/src/renderer/src/store/downloads.ts
+++ b/src/renderer/src/store/downloads.ts
@@ -8,6 +8,9 @@ export type DownloadRecord = DownloadItem & {
  savedFileName?: string
 }

+const isFinalStatus = (status: DownloadHistoryItem['status']): boolean =>
+  status === 'completed' || status === 'error' || status === 'cancelled'
+
 const recordKey = (entryType: DownloadRecord['entryType'], id: string) => `${entryType}:${id}`

 const toActiveRecord = (item: DownloadItem): DownloadRecord => ({
@@ -51,6 +54,7 @@ export const downloadRecordsAtom = atom<Map<string, DownloadRecord>>(new Map())

 export const addDownloadAtom = atom(null, (get, set, item: DownloadItem) => {
  const downloads = new Map(get(downloadRecordsAtom))
+  downloads.delete(recordKey('history', item.id))
  downloads.set(recordKey('active', item.id), toActiveRecord(item))
  set(downloadRecordsAtom, downloads)
 })
@@ -87,6 +91,14 @@ export const clearCompletedAtom = atom(null, (get, set) => {

 export const addHistoryRecordAtom = atom(null, (get, set, item: DownloadHistoryItem) => {
  const downloads = new Map(get(downloadRecordsAtom))
+  const activeKey = recordKey('active', item.id)
+  if (downloads.has(activeKey)) {
+    if (!isFinalStatus(item.status)) {
+      set(downloadRecordsAtom, downloads)
+      return
+    }
+    downloads.delete(activeKey)
+  }
  downloads.set(recordKey('history', item.id), toHistoryRecord(item))
  set(downloadRecordsAtom, downloads)
 })
--- a/src/shared/types/index.ts
+++ b/src/shared/types/index.ts
@@ -200,6 +200,8 @@ export type SubscriptionPlatform = 'youtube' | 'bilibili' | 'custom'

 export type SubscriptionStatus = 'idle' | 'checking' | 'up-to-date' | 'failed'

+export const SUBSCRIPTION_DUPLICATE_FEED_ERROR = 'SUBSCRIPTION_DUPLICATE_FEED_URL'
+
 export interface SubscriptionRule {
  id: string
  title: string
@@ -299,7 +301,7 @@ export const defaultSettings: AppSettings = {
  oneClickDownload: false,
  oneClickDownloadType: 'video',
  oneClickQuality: 'best',
-  closeToTray: false,
+  closeToTray: true,
  hideDockIcon: false,
  launchAtLogin: false,
  autoUpdate: true,
Author	SHA1	Message	Date
Nexmoe	cab86fe71c	Remove download started toast notifications (#143 ) * Remove download started toast notifications Remove the "download started" toast notifications from single video and playlist downloads, keeping only the one-click download notification. Also remove the corresponding unused translation strings from all 13 locale files. Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com> * Restore oneClickDownloadStarted translation key in all locales The oneClickDownloadStarted key is still referenced in the code when one-click downloads start, so it must be kept in all locale files. Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com> * Translate feedback.title in all non-English locales The feedback.title field was showing English text in all locale files. Updated to proper translations for each language. Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com> --------- Co-authored-by: Claude Haiku 4.5 <noreply@anthropic.com>	2026-01-17 17:27:11 +08:00
Nexmoe	129899ed61	fix(docs): resolve TypeScript build errors (#144 ) * fix(docs): resolve TypeScript build errors and search configuration Fix invalid LayoutProps type in [lang]/(docs)/layout.tsx to use proper Next.js 16 async layout component signature. Add type assertion in i18n.ts isLocale function to satisfy strict type checking. Configure search to use English indexing since Orama doesn't support Chinese. Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com> * feat(docs): configure static export following Fumadocs guidelines - Enable Next.js static export with output: 'export' - Configure static search using staticGET and revalidate: false - Update search UI to use type: 'static' for client-side search - Add localeMap to support both English and Chinese locales - Remove rewrites (incompatible with static export) - Remove route handlers that conflict with static export: - /llms.mdx route (file extension conflicts) - /llms-full.txt route - /og/docs OG image generation - Add trailingSlash: true for better route handling Build successfully generates 9 static pages (2.7MB total). Search indexes are exported as static files for client-side use. Reference: https://www.fumadocs.dev/docs/deploying/static Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com> * fix(docs): resolve 404 issues in static export - Change hideLocale from 'default-locale' to 'never' for static export compatibility (middleware doesn't work in static builds) - Add public/index.html to redirect root path to /en/ - Update middleware matcher to remove deleted route exclusions - All pages now accessible with language prefix (/en/, /zh/) This fixes the 404 issue where middleware-based rewrites don't work in static exports. Now all URLs explicitly include the language code. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com> * feat(docs): serve English content at root path without redirect - Restore hideLocale to 'default-locale' for cleaner URLs - Add post-export script to copy /en/ content to root directory - English pages now accessible at both / and /en/ - Chinese pages remain at /zh/ - Remove redirect page in favor of direct content serving - Add "type": "module" to package.json for ES modules This provides a better user experience by serving English content directly at the root path (/, /cookies/, /faq/) without requiring a redirect, while maintaining /en/ for explicit access. Output size: 3.2MB (includes both root and /en/ copies) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com> --------- Co-authored-by: Claude Haiku 4.5 <noreply@anthropic.com>	2026-01-17 16:31:24 +08:00
Nexmoe	1f821b67dd	docs: add fumadocs documentation site (#142 )	2026-01-17 14:37:43 +08:00
Nexmoe	6f1c6ce59e	chore: release v1.2.0	2026-01-17 13:58:17 +08:00
Nexmoe	e5d36da904	fix(ffmpeg): require ffmpeg/ffprobe bundle directory, closes #94 #106 #105 #69 #133 (#139 ) * fix(ffmpeg): require bundled ffprobe directory * ci(build): upload artifacts on PR * fix(download): allow embed thumbnail on macos	2026-01-17 13:35:29 +08:00
Nexmoe	9c3fd2c26f	fix(settings): show windows-only cookies note (#141 )	2026-01-17 13:23:45 +08:00
Nexmoe	894eb9774b	fix(download): persist resume sessions (#137 ) * fix(download): persist resume sessions * fix(ipc): cleanup download listeners	2026-01-17 13:00:36 +08:00
Nexmoe	73af211bef	feat(feedback): warn on long github issue urls (#140 )	2026-01-17 12:52:30 +08:00
Nexmoe	4b561cef38	feat(download): add select all and clear history (#136 ) * feat(download): add select all and clear history * fix(download): remove clear all history action * feat(download): clear selection on escape * feat(download): select full playlist groups * style(download): adjust playlist group spacing	2026-01-17 12:47:54 +08:00
Nexmoe	761adf2476	feat(tray): minimize to tray by default (#138 )	2026-01-17 12:17:34 +08:00
Nexmoe	182a1b9c1e	fix(subscriptions): detect duplicate RSS feeds (#134 )	2026-01-17 11:50:08 +08:00
Nexmoe	59aee07913	fix(download): constrain playlist list height (#130 ) * fix(download): constrain playlist list height * fix(ci): handle ffmpeg timeout on windows	2026-01-16 21:58:33 +08:00
Nexmoe	3d39c9751f	fix(feedback): simplify github issue link (#131 )	2026-01-16 21:27:29 +08:00
				`@@ -0,0 +1 @@`
				`export { twMerge as cn } from 'tailwind-merge';`