# Send Nas Movie Download to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "nas-movie-download",
    "name": "Nas Movie Download",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/Roger0808/nas-movie-download",
    "canonicalUrl": "https://clawhub.ai/Roger0808/nas-movie-download",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/nas-movie-download",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=nas-movie-download",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "_meta.json",
      "config/smb.env",
      "scripts/archive-movie.py",
      "scripts/download-and-archive.sh",
      "scripts/download-movie-subtitles-advanced.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/nas-movie-download"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/nas-movie-download",
    "downloadUrl": "https://openagent3.xyz/downloads/nas-movie-download",
    "agentUrl": "https://openagent3.xyz/skills/nas-movie-download/agent",
    "manifestUrl": "https://openagent3.xyz/skills/nas-movie-download/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/nas-movie-download/agent.md"
  }
}
```
## Documentation

### NAS Movie Download

Automated movie downloading system using Jackett for torrent search and qBittorrent for download management.

新功能：SMB 自动字幕下载！ 🎬 下载完成后自动通过 SMB 为视频下载并上传字幕。

### Environment Variables

Set these environment variables for the skill to function properly:

Jackett Configuration:

JACKETT_URL: Jackett service URL (default: http://192.168.1.246:9117)
JACKETT_API_KEY: Jackett API key (default: o5gp976vq8cm084cqkcv30av9v3e5jpy)

qBittorrent Configuration:

QB_URL: qBittorrent Web UI URL (default: http://192.168.1.246:8888)
QB_USERNAME: qBittorrent username (default: admin)
QB_PASSWORD: qBittorrent password (default: adminadmin)

SMB Configuration (for subtitle download):

SMB_USERNAME: SMB username (default: 13917908083)
SMB_PASSWORD: SMB password (default: Roger0808)
SMB_SERVER: SMB server IP (default: 192.168.1.246)
SMB_SHARE: SMB share name (default: super8083)
SMB_PATH: SMB download path (default: qb/downloads)

Subtitle Configuration:

SUBTITLE_LANGUAGES: Default subtitle languages (default: zh,en)

### SMB Setup

SMB 配置已保存到 config/smb.env：

cat config/smb.env

### Indexer Setup

The skill works with Jackett indexers. Currently configured indexers:

The Pirate Bay
TheRARBG
YTS

Ensure these indexers are enabled and configured in your Jackett installation for best results.

### Search Movies

Search for movies without downloading:

scripts/jackett-search.sh -q "Inception"
scripts/jackett-search.sh -q "The Matrix"
scripts/jackett-search.sh -q "死期将至"  # Chinese movie names supported

### Download Movie Only

Download movie without subtitles:

scripts/download-movie.sh -q "The Matrix"

### Download with Automatic Subtitles via SMB 🆕

完整流程：搜索 → 下载 → 自动下载字幕 → 上传到 SMB

# 下载电影并自动通过 SMB 下载字幕
scripts/download-movie.sh -q "Young Sheldon" --subtitle

# 指定字幕语言
scripts/download-movie.sh -q "Community" --subtitle --lang zh,en

参数说明：

--subtitle: 启用自动字幕下载（通过 SMB）
--lang: 指定字幕语言（默认：zh,en）

### SMB Subtitle Download (Standalone)

为 NAS 上已下载的视频通过 SMB 下载字幕：

# 为单个视频下载字幕
python3 scripts/smb-download-subtitle.py -f "movie.mkv"

# 为整个目录下载字幕
python3 scripts/smb-download-subtitle.py -d "qb/downloads/Movie Folder"

# 批量处理所有视频
python3 scripts/smb-download-subtitle.py --all

### 完整下载流程

搜索电影: 使用 Jackett 搜索种子
添加到 qBittorrent: 自动添加最高质量的种子
等待下载完成: qBittorrent 下载视频到 NAS
自动下载字幕: 通过 SMB 连接到 NAS，为视频下载字幕
上传字幕: 将字幕文件上传到 NAS 对应位置

┌─────────────┐    ┌──────────────┐    ┌──────────────┐    ┌──────────────┐
│  Jackett    │───▶│ qBittorrent  │───▶│    NAS       │───▶│   字幕下载    │
│   搜索      │    │   下载       │    │  存储视频     │    │  SMB + subliminal│
└─────────────┘    └──────────────┘    └──────────────┘    └──────────────┘

### jackett-search.sh

Search Jackett for torrents.

Parameters:

-q, --query: Search query (required)
-u, --url: Jackett URL (optional, uses env var)
-k, --api-key: API key (optional, uses env var)

### qbittorrent-add.sh

Add torrent to qBittorrent.

Parameters:

-m, --magnet: Magnet link (required)
-u, --url: qBittorrent URL (optional, uses env var)
-n, --username: Username (optional, uses env var)
-p, --password: Password (optional, uses env var)

### download-movie.sh

One-click search, download, and subtitle fetching.

Parameters:

-q, --query: Movie name (required)
-s, --subtitle: Enable automatic subtitle download via SMB
-l, --lang: Subtitle languages (default: zh,en)
--quality: Quality preference (4k, 1080p, 720p, any)

### smb-download-subtitle.py 🆕

Download subtitles for videos on NAS via SMB.

Parameters:

-f, --file: Single video filename (relative to SMB path)
-d, --directory: Directory path (relative to SMB path)
-l, --lang: Subtitle languages (default: zh,en)
--all: Process all videos in SMB download folder

Example:

# Single video
python3 scripts/smb-download-subtitle.py -f "Lilo And Stitch 2025.mkv"

# Entire folder
python3 scripts/smb-download-subtitle.py -d "qb/downloads/Movie Folder"

# All videos
python3 scripts/smb-download-subtitle.py --all

Features:

Connects to NAS via SMB
Uses subliminal for subtitle search
Downloads Chinese and English subtitles
Uploads subtitles to corresponding video folders
Skips existing subtitle files

### Tips and Best Practices

Use English movie names for better search results
Check Jackett indexer status if searches return no results
Monitor qBittorrent to manage download progress
SMB subtitle download works best for popular movies and TV shows
Test SMB connection with python3 scripts/smb-download-subtitle.py --test
For TV series: Use --subtitle flag to auto-download subtitles for all episodes
Subtitle resolution independence: Subtitles are resolution-independent; 720p subtitles work on 1080p videos if the timing matches
Expand subtitle sources: By default uses 9 subtitle providers (addic7ed, opensubtitles, podnapisi, etc.) to maximize subtitle find rate

### SMB Connection Failed

Verify SMB credentials in config/smb.env
Check NAS IP address: ping 192.168.1.246
Ensure SMB service is running on NAS
Verify network connectivity

### Subtitle Download Issues

No subtitles found: Try different language codes or the video may not have subtitles available
subliminal not installed: pip3 install subliminal
SMB upload failed: Check folder permissions on NAS

### Permission Issues

Ensure scripts have execute permissions:

chmod +x scripts/*.sh
chmod +x scripts/*.py

### Security Notes

Keep SMB credentials secure in config/smb.env
Use HTTPS connections when possible
Consider setting up VPN for torrent traffic
Monitor qBittorrent for unauthorized downloads

### Dependencies

curl: For HTTP requests
jq: For JSON parsing
python3 with pysmb: For SMB operations
subliminal: For subtitle download

Install dependencies:

apt-get install curl jq python3 python3-pip
pip3 install pysmb subliminal

### v3.2.0 - 2025-03-06

✅ Expanded subtitle providers: Now uses all 9 available subtitle sources (addic7ed, bsplayer, gestdown, napiprojekt, opensubtitles, opensubtitlescom, podnapisi, subtitulamos, tvsubtitles)
✅ Improved subtitle find rate: Successfully found subtitles for 141/141 Young Sheldon episodes (131 Chinese + 20 English)
✅ Resolution independence: Clarified that subtitles are not resolution-dependent; 720p subtitles work on 1080p videos
✅ Enhanced smb-download-subtitle.py: Refactored with modular functions and better error handling

### v3.0 - 2025-02-23

✅ Added SMB subtitle download support
✅ New smb-download-subtitle.py script
✅ Integrated subtitle download into download workflow
✅ Automatic subtitle upload via SMB
✅ Support for Chinese and English subtitles

### v2.0 - 2025-02-17

✅ Added automatic subtitle download support
✅ New subtitle-download.sh script
✅ Updated download-movie.sh with -s and -w flags
✅ Support for OpenSubtitles API
✅ Multi-language subtitle support (zh-cn, en, ja, ko, etc.)
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: Roger0808
- Version: 3.2.2
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/nas-movie-download)
- [Send to Agent page](https://openagent3.xyz/skills/nas-movie-download/agent)
- [JSON manifest](https://openagent3.xyz/skills/nas-movie-download/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/nas-movie-download/agent.md)
- [Download page](https://openagent3.xyz/downloads/nas-movie-download)