Skip to content
Back to search

cinema-manager

Hermes Agent skill - Movie/TV resource search + Quark cloud drive auto-save

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/davidbb-l--cinema-manager/badge.svg)](/listings/davidbb-l--cinema-manager)

HTML

<a href="/listings/davidbb-l--cinema-manager"><img src="/api/listings/davidbb-l--cinema-manager/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

git clone https://github.com/249695811/cinema-manager.git ~/.hermes/skills/cinema-manager
pip install httpx
python3 ~/.hermes/skills/cinema-manager/scripts/setup.py

Setup wizard walks you through: 1. **夸克网盘登录** — 账号密码(推荐)或 Cookie 2. **内容源选择** — 自动检测已安装插件,逐个启用/禁用 3. **自动分类** — OMDB API(推荐)/ 内容源抓取 / 关闭 4. **保存目录** — 夸克网盘中的文件夹名

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 46 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: cinema-manager
  3. description: Personal media library management — discover content, save to Quark cloud drive, auto-organize for Infuse/Plex. Plugin system for content sources. Use when user wants to find/watch movies, save to cloud drive, or manage media library.
  4. ---
  5. # Cinema Manager
  6. Media discovery → Cloud save → Library organization.
  7. ## Quick Start
  8. ```bash
  9. python3 scripts/cinema.py auto "电影名" # search + save + organize
  10. python3 scripts/cinema.py search "电影名" # search only
  11. python3 scripts/cinema.py plugins # list plugins
  12. ```
  13. ## Config
  14. `config.json` (not committed, create from `config.example.json`):
  15. - `quark.cookie` — Quark session cookie (login to pan.quark.cn, copy cookie from browser DevTools)
  16. - `plugins` — enable/disable content source plugins
  17. - `save_folder` — Quark folder name (default: "影视资源")
  18. ## Adding Content Sources
  19. 1. Copy `scripts/plugins/example.py` to `scripts/plugins/your_site.py`
  20. 2. Implement `search()` and `extract_link()`
  21. 3. Add `"your_site": {"enabled": true}` to config.json
  22. ## Library Management
  23. `cinema.py organize <fid> <title> --type movie|tv`
  24. Organizes files into Infuse/Plex-compatible structure:
  25. - Movies: `影视资源/Movie Name (Year)/Movie Name (Year).ext`
  26. - TV: `影视资源/Show Name/Season XX/Show Name - SXXEXX.ext`
  27. ## Workflow
  28. 1. User says "I want to watch X"
  29. 2. `cinema.py search` across all configured sources
  30. 3. Score results, pick best quality version
  31. 4. `cinema.py save` → quark drive
  32. 5. `cinema.py organize` → proper folder structure
  33. 6. Infuse/Plex auto-detects and fetches metadata
README.md · README · 144 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # 🎬 Cinema Manager - Hermes Skill
  2. A [Hermes Agent](https://github.com/nousresearch/hermes-agent) skill for personal media library management — discover content, save to Quark cloud drive, and auto-organize with genre classification.
  3. ## Features
  4. - 🔍 **Multi-source search** — plugin system, add any content source
  5. - 📊 **Quality scoring** — auto-ranks by resolution, source, HDR, audio, codec, subtitles
  6. - ☁️ **Quark save** — one-click save to your Quark cloud drive
  7. - 🎭 **Genre auto-classification** — OMDB API or content source scraping, with local cache
  8. - 📁 **Library management** — auto-organize files for Infuse/Plex/Jellyfin
  9. ## Quick Start
  10. ```bash
  11. git clone https://github.com/249695811/cinema-manager.git ~/.hermes/skills/cinema-manager
  12. pip install httpx
  13. python3 ~/.hermes/skills/cinema-manager/scripts/setup.py
  14. ```
  15. Setup wizard walks you through:
  16. 1. **夸克网盘登录** — 账号密码(推荐)或 Cookie
  17. 2. **内容源选择** — 自动检测已安装插件,逐个启用/禁用
  18. 3. **自动分类** — OMDB API(推荐)/ 内容源抓取 / 关闭
  19. 4. **保存目录** — 夸克网盘中的文件夹名
  20. ## Usage
  21. ### Via Hermes Agent
  22. Just tell your agent:
  23. - "我要看星际穿越"
  24. - "搜一下流浪地球2"
  25. - "帮我整理一下夸克网盘里的影视资源"
  26. ### CLI
  27. ```bash
  28. python3 scripts/cinema.py search "流浪地球" # Search
  29. python3 scripts/cinema.py auto "星际穿越" # Search + save + organize
  30. python3 scripts/cinema.py save "https://pan.quark.cn/s/xxx" # Save a link
  31. python3 scripts/cinema.py organize <fid> "电影名" --type movie # Organize
  32. python3 scripts/cinema.py plugins # List plugins
  33. python3 scripts/setup.py # Re-run setup wizard
  34. ```
  35. ## Configuration
  36. Edit `config.json` (created by setup wizard):
  37. ```json
  38. {
  39. "quark": {
  40. "cookie": "your_cookie_from_browser"
  41. },
  42. "plugins": {
  43. "wp365": { "enabled": true }
  44. },
  45. "save_folder": "夸克影视",
  46. "omdb_api_key": ""
  47. }
  48. ```
  49. ### Quark Auth
  50. Login to [pan.quark.cn](https://pan.quark.cn), open browser DevTools (F12) → Network tab → copy the `Cookie` header value from any request. Paste it into `config.json` as `quark.cookie`.
  51. Cookies expire after ~7 days. When expired, grab a fresh one from the browser.
  52. ### Genre Classification
  53. | Mode | Config | Accuracy | Cost |
  54. |------|--------|----------|------|
  55. | OMDB API | `"omdb_api_key": "your_key"` | High | Free, 1000 req/day |
  56. | Content scrape | `"omdb_api_key": ""` | Medium | Free |
  57. | Disabled | (movies go to flat structure) | N/A | Free |
  58. Get a free OMDB key at [omdbapi.com/apikey.aspx](http://www.omdbapi.com/apikey.aspx) — just enter your email.
  59. Genre results cached in `scripts/genre_cache.json`.
  60. ## Adding Content Sources
  61. Drop a `.py` plugin file into `scripts/plugins/`:
  62. ```bash
  63. cp scripts/plugins/example.py scripts/plugins/your_site.py
  64. ```
  65. Implement two methods:
  66. ```python
  67. from plugins import ResourcePlugin, ResourceResult
  68. class Plugin(ResourcePlugin):
  69. name = "your_site"
  70. display_name = "Your Site Name"
  71. requires_auth = False
  72. url = "https://your-site.com"
  73. def search(self, query: str, page: int = 1) -> list[ResourceResult]:
  74. ...
  75. def extract_link(self, resource: ResourceResult) -> str | None:
  76. ...
  77. ```
  78. Then enable in `config.json` or re-run `setup.py`. See `scripts/plugins/example.py` for a full template.
  79. ## Library Structure
  80. ```
  81. 夸克影视/
  82. ├── 动作/
  83. │ └── 金谍行动 (2026)/
  84. │ └── In.the.Grey.2026.2160p.WEB-DL.mkv
  85. ├── 剧情/
  86. │ └── 大濛 (2025)/
  87. │ └── A.Foggy.Tale.2025.1080p.NF.WEB-DL.mkv
  88. ├── 科幻/
  89. │ └── 流浪地球2 (2023)/
  90. │ └── 流浪地球2 (2023).mkv
  91. └── 其他/
  92. └── 未识别类型的电影 (2024)/
  93. ```
  94. Infuse/Plex compatible naming:
  95. - Movie: `Movie Name (Year).ext`
  96. - TV: `Show Name/Season XX/Show Name - SXXEXX.ext`
  97. ## Quality Scoring
  98. | Factor | Best | Worst |
  99. |--------|------|-------|
  100. | Resolution | 2160p/4K (+100) | 480p (+5) |
  101. | Source | BluRay/REMUX (+90) | CAM (+5) |
  102. | HDR | Dolby Vision (+30) | None (0) |
  103. | Audio | Atmos/TrueHD (+15) | AAC (+2) |
  104. | Codec | H.265/HEVC (+10) | H.264 (+5) |
  105. | Subtitles | Included (+5) | None (0) |
  106. | Platform | Quark (+15) | Baidu (0) |
  107. ## License
  108. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.