Movera

Movera 是一個輕量級的媒體檔案自動化管理工具，支援多種 BT 下載器整合。當下載完成時，Movera 會根據預設的任務規則自動移動和重命名檔案。

功能特色

• 多種 BT 下載器整合 - 支援 qBittorrent、Transmission、Deluge、rTorrent、Aria2
• 靈活的重命名規則 - 支援 Regex 和 Parse 兩種模式
• 任務管理系統 - 建立、編輯、啟用/停用任務
• 即時日誌 - 透過 WebSocket 即時查看處理狀態
• 現代化 Web UI - Vue 3 + Tailwind CSS 響應式界面
• PWA 支援 - 可安裝為桌面/行動應用程式
• Docker 部署 - 支援 amd64 和 arm64 架構

快速開始

Docker 部署

docker run -d \
  --name movera \
  -p 8000:8000 \
  -e PUID=1000 \
  -e PGID=1000 \
  -v /path/to/downloads:/downloads \
  -v /path/to/media:/media \
  -v /path/to/database:/movera/database \
  -v /path/to/storages:/movera/storages \
  thanatosdi/movera:latest

Docker Compose（推薦）

services:
  movera:
    image: thanatosdi/movera:latest
    container_name: movera
    ports:
      - "8000:8000"
    environment:
      - PUID=1000
      - PGID=1000
    volumes:
      - /path/to/downloads:/downloads
      - /path/to/media:/media
      - ./database:/movera/database
      - ./storages:/movera/storages
    restart: unless-stopped

環境變數

變數	預設值	說明
PUID	1000	執行程式的使用者 ID
PGID	1000	執行程式的群組 ID

BT 下載器整合

將 scripts/ 目錄下的腳本複製到下載器可存取的位置，並設定下載完成時執行。

下載器	是否經過測試
Aria2	⚠️
Deluge	⚠️
qBittorrent	✅
rTorrent	⚠️
Transmission	⚠️

qBittorrent

設定 → 下載 → 種子完成時執行外部程式：

/path/to/scripts/qBittorrent http://movera:8000/webhook/qbittorrent "%F" "%L" "%G"

Transmission

編輯 settings.json：

{
  "script-torrent-done-enabled": true,
  "script-torrent-done-filename": "/path/to/scripts/Transmission http://movera:8000/webhook/qbittorrent"
}

Deluge

1. 啟用 Execute 插件：Preferences → Plugins → Execute
2. 新增事件：Torrent Complete
3. Command：

/path/to/scripts/Deluge http://movera:8000/webhook/qbittorrent

rTorrent

在 .rtorrent.rc 中加入：

method.set_key = event.download.finished,movera,"execute2={/path/to/scripts/rTorrent,http://movera:8000/webhook/qbittorrent,$d.base_path=,$d.custom1=}"

Aria2

啟動參數或 aria2.conf：

on-download-complete=/path/to/scripts/Aria2 http://movera:8000/webhook/qbittorrent

Note

所有腳本都在 scripts/ 目錄下，請根據你的環境修改 URL 和路徑

任務規則

Parse 模式

使用命名佔位符來解析檔名：

來源模式	{title} - {episode}.mp4
輸入檔名	公爵千金的家庭教師 - 01.mp4
目標模式	{title} - S01E{episode}.mp4
輸出檔名	公爵千金的家庭教師 - S01E01.mp4

Regex 模式

使用正規表達式和反向引用：

來源模式	(.+) - (\d{2}).+\.mp4
輸入檔名	公爵千金的家庭教師 - 01 [1080P].mp4
目標模式	\1 - S01E\2.mp4
輸出檔名	公爵千金的家庭教師 - S01E01.mp4

或者使用正規表達式命名規則來解析:

來源模式	(?P<title>\w+) - (?P<episode>\d{2})(v2)? (.+)\.mp4
輸入檔名	公爵千金的家庭教師 - 01 [1080P].mp4
目標模式	\g<title> - S01E\g<episode> \4.mp4
輸出檔名	公爵千金的家庭教師 - S01E01 [1080P].mp4

本地開發

系統需求

• Python 3.13+
• Node.js 24+
• uv (Python 套件管理)

後端

# 安裝依賴
uv sync

# 啟動開發伺服器
uv run main.py

前端

# 安裝依賴
npm install

# 啟動開發伺服器
npm run dev

# 建置生產版本
npm run build

Note

開發狀況下前後端使用的 Port 會不同
可以在根目錄建立 .env 設定 VITE_WEBSOCKET_BASE_URL 來指定 WebSocket 伺服器(後端)的 URL

API 文件

啟動伺服器後，可透過以下路徑存取 API 文件：

• Swagger UI: http://localhost:8000/docs
• ReDoc: http://localhost:8000/redoc

技術棧

後端

• FastAPI - 高效能 Python Web 框架
• SQLAlchemy - ORM 資料庫操作
• Alembic - 資料庫遷移
• Uvicorn - ASGI 伺服器

前端

• Vue 3 - 漸進式 JavaScript 框架
• Tailwind CSS - Utility-first CSS 框架
• Pinia - 狀態管理
• Vue Router - 路由管理
• Vue I18n - 國際化

授權條款

MIT License