Skip to content

Installation Guide

Jump to bottom
SpaceSquare640 edited this page Jul 23, 2026 · 8 revisions

Installation Guide

Language / 語言 / 语言: English · 繁體中文 · 简体中文

English

1. Download

Go to the Releases page and download one of:

  • *-setup.exe — NSIS installer (smaller download, recommended)
  • *.msi — MSI installer (useful for managed/enterprise deployment)

Both install the exact same app; ffmpeg and the Python engine are bundled inside — you don't need to install anything else.

2. Install & launch

Run the installer and follow the prompts. Launch Multimedia Downloader from the Start Menu when done.

On first launch you'll see four tabs: Video Download, Music Download, Format Conversion, Run Log. The header also has a book icon that opens an in-app User Manual with a quick reference for every feature, in all three languages.

3. Download a video or audio file

  1. Open the Video Download (or Music Download) tab.
  2. Paste one or more URLs, one per line.
  3. Pick a format/quality and a save folder.
  4. Click Start Download — progress and logs appear live.

4. Convert a file

  1. Open the Format Conversion tab.
  2. Add file(s) via drag-and-drop or the file picker.
  3. Pick the target format and output folder.
  4. Click Start Convert.

5. Set up the AI Assistant (optional)

ℹ️ The v4.0.0 AI Assistant runtime error is fixed in v4.1 (the delisted OpenRouter planner/summarizer models were swapped for current ones). Use v4.1 or newer.

  1. Click the ✨ AI Assistant button (or Ctrl/Cmd+K).
  2. Open Settings and paste your own OpenRouter API key — it's stored only on your device, never sent anywhere but OpenRouter.
  3. Describe a task in plain language, e.g. "Convert every .mov in this folder to mp4".
  4. Review the generated plan — nothing runs until you click Confirm.

Cookie-gated platforms

Some sites (Douyin, private TikTok/Instagram) need a login cookie:

  • Easiest: pick the browser you're logged into from the dropdown — the app reads its cookies automatically.
  • Manual: export cookies.txt with a browser extension and point the app at it.

Building from source

See the README for developer build instructions (Rust, Node, Python required).

Terminal UI (TUI)

Prefer the keyboard, or working over SSH? V4.3 adds a full interactive terminal interface (built with Textual) with the same Download / Convert / Log tabs as the desktop app, driving the same engine:

pip install -r requirements-tui.txt   # yt-dlp + textual (ffmpeg on PATH)
python -m tui                         # or: python -m tui --lang zh_tw

Press d to toggle light/dark, q to quit. Language is fixed at launch via --lang (like cli.py) rather than switchable mid-session.

Android (Termux)

No desktop app on Android, but you can run the engine from a terminal via Termux — as a CLI or the web UI in your browser:

pkg install -y git && git clone https://github.com/SpaceSquare640/Multimedia_Downloader.git
cd Multimedia_Downloader
bash termux/run-cli.sh download "https://youtu.be/XXXX" -o ~/storage/downloads -f mp4   # CLI
bash termux/run-web.sh                                                                  # web UI

Full guide: termux/README.md.

繁體中文

1. 下載

到 Releases 頁面 下載其中一個：

  • *-setup.exe — NSIS 安裝檔（較小，推薦）
  • *.msi — MSI 安裝檔（適合企業/受管理部署）

兩者裝出來的 app 完全相同；ffmpeg 與 Python 引擎皆已內建，不需要另外安裝任何東西。

2. 安裝與啟動

執行安裝檔並依提示完成。完成後從開始選單啟動 Multimedia Downloader。

首次啟動會看到四個分頁：影片格式下載、音樂格式下載、格式轉換、程式運行日誌。頁首還有一個書本圖示，可開啟 App 內建的使用手冊，提供各功能的快速說明，支援三語。

3. 下載影片或音訊

  1. 開啟「影片格式下載」（或「音樂格式下載」）分頁。
  2. 貼上一個或多個網址，每行一個。
  3. 選擇格式/畫質與存放資料夾。
  4. 點擊「開始下載」——進度與日誌即時顯示。

4. 轉換格式

  1. 開啟「格式轉換」分頁。
  2. 拖放或點選加入檔案。
  3. 選擇目標格式與輸出資料夾。
  4. 點擊「開始轉換」。

5. 設定 AI 助手（選用）

ℹ️ v4.0.0 的 AI 助手運行時錯誤已在 v4.1 修復（被下架的 OpenRouter planner/summarizer 模型已換成現行版本）。請使用 v4.1 或更新版本。

  1. 點擊 ✨ AI 助手 按鈕（或按 Ctrl/Cmd+K）。
  2. 到「設定」貼上你自己的 OpenRouter API Key——僅存於本機裝置，除了 OpenRouter 外不傳送給任何人。
  3. 用自然語言描述任務，例如「把這個資料夾內所有 .mov 轉成 mp4」。
  4. 檢查產生的計畫——按下「確認」前不會執行任何動作。

需要登入的平台

部分平台（抖音、私人 TikTok/Instagram）需要登入 Cookie：

  • 最簡單：從下拉選單選擇你已登入的瀏覽器，app 會自動讀取其 Cookie。
  • 手動：用瀏覽器擴充功能匯出 cookies.txt，再指定給 app。

從原始碼建置

開發者建置說明見 README（需 Rust、Node、Python）。

終端機介面（TUI）

想用鍵盤操作，或是透過 SSH 遠端使用？V4.3 新增了完整的互動式終端介面（用 Textual 建置），跟桌面版一樣有下載/轉換/日誌 分頁，驅動同一套引擎：

pip install -r requirements-tui.txt   # yt-dlp + textual（ffmpeg 需在 PATH 上）
python -m tui                         # 或：python -m tui --lang zh_tw

按 d 切換亮/暗主題，q 離開。語言在啟動時透過 --lang 決定（跟 cli.py 一樣），啟動後無法即時切換。

Android（Termux）

Android 沒有桌面版，但可透過 Termux 在終端機執行引擎——用 CLI 或手機瀏覽器的 Web 版：

pkg install -y git && git clone https://github.com/SpaceSquare640/Multimedia_Downloader.git
cd Multimedia_Downloader
bash termux/run-cli.sh download "https://youtu.be/XXXX" -o ~/storage/downloads -f mp4   # CLI
bash termux/run-web.sh                                                                  # Web 版

完整說明：termux/README.md。

简体中文

1. 下载

到 Releases 页面 下载其中一个：

  • *-setup.exe — NSIS 安装包（较小，推荐）
  • *.msi — MSI 安装包（适合企业/受管理部署）

两者安装出来的 app 完全相同；ffmpeg 与 Python 引擎均已内置，不需要另外安装任何东西。

2. 安装与启动

运行安装包并按提示完成。完成后从开始菜单启动 Multimedia Downloader。

首次启动会看到四个标签页：视频格式下载、音乐格式下载、格式转换、程序运行日志。页首还有一个书本图标，可打开 App 内置的使用手册，提供各功能的快速说明，支持三语。

3. 下载视频或音频

  1. 打开「视频格式下载」（或「音乐格式下载」）标签页。
  2. 粘贴一个或多个网址，每行一个。
  3. 选择格式/画质与存放文件夹。
  4. 点击「开始下载」——进度与日志实时显示。

4. 转换格式

  1. 打开「格式转换」标签页。
  2. 拖放或点选添加文件。
  3. 选择目标格式与输出文件夹。
  4. 点击「开始转换」。

5. 设置 AI 助手（可选）

ℹ️ v4.0.0 的 AI 助手运行时错误已在 v4.1 修复（被下架的 OpenRouter planner/summarizer 模型已换成现行版本）。请使用 v4.1 或更新版本。

  1. 点击 ✨ AI 助手 按钮（或按 Ctrl/Cmd+K）。
  2. 到「设置」粘贴你自己的 OpenRouter API Key——仅保存于本机设备，除 OpenRouter 外不发送给任何人。
  3. 用自然语言描述任务，例如「把这个文件夹内所有 .mov 转成 mp4」。
  4. 检查生成的计划——按下「确认」前不会执行任何动作。

需要登录的平台

部分平台（抖音、私人 TikTok/Instagram）需要登录 Cookie：

  • 最简单：从下拉菜单选择你已登录的浏览器，app 会自动读取其 Cookie。
  • 手动：用浏览器扩展导出 cookies.txt，再指定给 app。

从源代码构建

开发者构建说明见 README（需 Rust、Node、Python）。

终端界面（TUI）

想用键盘操作，或是通过 SSH 远程使用？V4.3 新增了完整的交互式终端界面（用 Textual 构建），跟桌面版一样有下载/转换/日志 标签页，驱动同一套引擎：

pip install -r requirements-tui.txt   # yt-dlp + textual（ffmpeg 需在 PATH 上）
python -m tui                         # 或：python -m tui --lang zh_cn

按 d 切换浅/深色主题，q 退出。语言在启动时通过 --lang 决定（跟 cli.py 一样），启动后无法即时切换。

Android（Termux）

Android 没有桌面版，但可通过 Termux 在终端运行引擎——用 CLI 或手机浏览器的 Web 版：

pkg install -y git && git clone https://github.com/SpaceSquare640/Multimedia_Downloader.git
cd Multimedia_Downloader
bash termux/run-cli.sh download "https://youtu.be/XXXX" -o ~/storage/downloads -f mp4   # CLI
bash termux/run-web.sh                                                                  # Web 版

完整说明：termux/README.md。

Clone this wiki locally