Nas Movie Download
Search and download movies via Jackett.
- Rating
- 4.9 (174 reviews)
- Downloads
- 4,414 downloads
- Version
- 1.0.0
Overview
Search and download movies via Jackett.
Complete Documentation
View Source →
NAS Movie Download
Automated movie downloading system using Jackett for torrent search and qBittorrent for download management.
新功能:SMB 自动字幕下载! 🎬 下载完成后自动通过 SMB 为视频下载并上传字幕。
Configuration
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)
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_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_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
Usage
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
Workflow
完整下载流程
- 搜索电影: 使用 Jackett 搜索种子
- 添加到 qBittorrent: 自动添加最高质量的种子
- 等待下载完成: qBittorrent 下载视频到 NAS
- 自动下载字幕: 通过 SMB 连接到 NAS,为视频下载字幕
- 上传字幕: 将字幕文件上传到 NAS 对应位置
┌─────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ Jackett │───▶│ qBittorrent │───▶│ NAS │───▶│ 字幕下载 │
│ 搜索 │ │ 下载 │ │ 存储视频 │ │ SMB + subliminal│
└─────────────┘ └──────────────┘ └──────────────┘ └──────────────┘
Script Details
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
# 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
--subtitleflag 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
Troubleshooting
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 requestsjq: For JSON parsingpython3withpysmb: For SMB operationssubliminal: For subtitle download
apt-get install curl jq python3 python3-pip
pip3 install pysmb subliminal
Changelog
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.pyscript - ✅ 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.shscript - ✅ Updated
download-movie.shwith-sand-wflags - ✅ Support for OpenSubtitles API
- ✅ Multi-language subtitle support (zh-cn, en, ja, ko, etc.)
Installation
openclaw install nas-movie-download
💻Code Examples
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**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 --all
## Workflow
### 完整下载流程
1. **搜索电影**: 使用 Jackett 搜索种子
2. **添加到 qBittorrent**: 自动添加最高质量的种子
3. **等待下载完成**: qBittorrent 下载视频到 NAS
4. **自动下载字幕**: 通过 SMB 连接到 NAS,为视频下载字幕
5. **上传字幕**: 将字幕文件上传到 NAS 对应位置└─────────────┘ └──────────────┘ └──────────────┘ └──────────────┘
## Script Details
### 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:**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
## Troubleshooting
### SMB Connection Failed
1. Verify SMB credentials in `config/smb.env`
2. Check NAS IP address: `ping 192.168.1.246`
3. Ensure SMB service is running on NAS
4. Verify network connectivity
### Subtitle Download Issues
1. **No subtitles found**: Try different language codes or the video may not have subtitles available
2. **subliminal not installed**: `pip3 install subliminal`
3. **SMB upload failed**: Check folder permissions on NAS
### Permission Issues
Ensure scripts have execute permissions: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:scripts/jackett-search.sh -q "Inception"
scripts/jackett-search.sh -q "The Matrix"
scripts/jackett-search.sh -q "死期将至" # Chinese movie names supported# 下载电影并自动通过 SMB 下载字幕
scripts/download-movie.sh -q "Young Sheldon" --subtitle
# 指定字幕语言
scripts/download-movie.sh -q "Community" --subtitle --lang zh,en# 为单个视频下载字幕
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 --allTags
Quick Info
Ready to Install?
Get started with this skill in seconds
Related Skills
4claw
4claw — a moderated imageboard for AI agents.
Aap Passport
Agent Attestation Protocol - The Reverse Turing Test.
Adaptive Suite
A continuously adaptive skill suite that empowers Clawdbot.
Adversarial Prompting
Adversarial analysis to critique, fix.