← Back to Skills Marketplace
adminlove520

Movie Subtitle Viewer

by Anonymous · GitHub ↗ · v0.1.0 · MIT-0
cross-platform ⚠ suspicious
353
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install movie-subtitle-viewer
Description
Search, download, parse, and summarize movie subtitles from OpenSubtitles in .srt or .ass formats using movie name and year.
Usage Guidance
This skill appears to implement an OpenSubtitles client and subtitle parser, which is coherent with its description — but there are several mismatches and missing files you should watch for before installing: - Credentials: The code expects OPENSUBTITLES_API_KEY, OPENSUBTITLES_USERNAME, and OPENSUBTITLES_PASSWORD in the environment, but the registry metadata lists no required env vars. Do not supply credentials until you confirm where and how they will be stored. Prefer creating a dedicated API key/account with least privilege. - Workspace writes: Downloaded subtitle files are saved into the workspace. If that workspace is backed up or synced, sensitive data could be persisted. Consider the storage location and clean-up policy. - Missing/unused files: SKILL.md and README reference a movie_summary.py and scripts/movie_viewer.py that are not present; the summary-generation step is not included in the bundle. Ask the author for the missing files or updated documentation. - Dependency handling: The package lists python-dotenv but code doesn't load it; verify how you will provide env vars (system env vs .env file). Avoid committing .env files with real credentials. If you want to proceed: (1) ask the maintainer to fix the registry metadata to declare required env vars and to provide the missing summary code, (2) run the code in a sandbox or isolated environment, and (3) avoid reusing high-value credentials — create a separate OpenSubtitles account/API key for testing.
Capability Analysis
Type: OpenClaw Skill Name: movie-subtitle-viewer Version: 0.1.0 The skill is functional for its stated purpose but contains a path traversal vulnerability in `src/subtitle_client.py`. The `download` method uses the `file_name` attribute directly from the OpenSubtitles API response as a local file path without sanitization, which could allow a malicious or compromised API response to overwrite arbitrary files in the agent's environment. While the logic in `SKILL.md` and the rest of the source code appears benign and aligned with the intended subtitle-viewing functionality, the lack of input sanitization on file operations is a significant security flaw.
Capability Assessment
Purpose & Capability
The code and SKILL.md behavior (searching OpenSubtitles, downloading .srt/.ass, parsing via pysubs2) align with the declared purpose. However the registry metadata claims no required env vars/credentials while both SKILL.md and subtitle_client.py clearly require OPENSUBTITLES_API_KEY, OPENSUBTITLES_USERNAME, and OPENSUBTITLES_PASSWORD — that registry omission is an inconsistency that should be corrected.
Instruction Scope
Runtime instructions and code explicitly read OpenSubtitles credentials from environment variables and save downloaded subtitle files into the workspace. The SKILL.md also references higher-level features (generating summaries) and files (movie_summary.py, scripts/movie_viewer.py) that are not present in the package — the missing components and the discrepancy between declared and actually-used env vars are scope/integrity concerns. The instructions do not ask for unrelated system files, but they do rely on environment variables that the registry didn't list.
Install Mechanism
There is no install spec (instruction-only from platform perspective) but a requirements.txt is included and README suggests pip installing pysubs2, requests, and python-dotenv. This is low-to-moderate risk; no arbitrary remote downloads or extract steps are present. One minor inconsistency: python-dotenv is listed but the code does not call dotenv.load_dotenv (it expects env vars to be set), and README/SKILL.md reference files (.env.example) that are not in the bundle.
Credentials
The environment variables required by the code (OPENSUBTITLES_API_KEY, OPENSUBTITLES_USERNAME, OPENSUBTITLES_PASSWORD) are appropriate for accessing OpenSubtitles, but the registry metadata does not declare them (primaryEnv is none). That mismatch could cause users to miss that credentials are needed. The skill will store downloaded subtitle files in the workspace — consider whether you want API credentials and downloaded files in that environment.
Persistence & Privilege
The skill does not request always:true and it does not attempt to modify other skills or system-wide configuration. It writes subtitle files to the workspace (normal for this function) but does not request elevated or persistent platform privileges.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install movie-subtitle-viewer
  3. After installation, invoke the skill by name or use /movie-subtitle-viewer
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Movie Subtitle Viewer Skill 0.1.0 - Initial release with support for searching and downloading movie subtitles from OpenSubtitles. - Allows parsing .srt and .ass subtitle files to extract movie dialogue. - Generates AI-powered plot summaries from parsed subtitles. - Provides trigger phrases for easy access to search, download, and analyze subtitles. - Includes setup instructions for required OpenSubtitles API credentials.
Metadata
Slug movie-subtitle-viewer
Version 0.1.0
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is Movie Subtitle Viewer?

Search, download, parse, and summarize movie subtitles from OpenSubtitles in .srt or .ass formats using movie name and year. It is an AI Agent Skill for Claude Code / OpenClaw, with 353 downloads so far.

How do I install Movie Subtitle Viewer?

Run "/install movie-subtitle-viewer" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Movie Subtitle Viewer free?

Yes, Movie Subtitle Viewer is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Movie Subtitle Viewer support?

Movie Subtitle Viewer is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Movie Subtitle Viewer?

It is built and maintained by Anonymous (@adminlove520); the current version is v0.1.0.

💬 Comments