← Back to Skills Marketplace
newtranx CLI (
375
Downloads
1
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install ai-video-translation
Description
newtranx CLI for translate MP4 videos, Used for directly translating video files on the terminal. When you want to translate video files from one country's a...
README (SKILL.md)
newtranx CLI (newtranx)
Translate videos and podcasts from the terminal using the newtranx API.
Installation
npx --yes newtranx-ai
Usage Process
1. login
npx newtranx-ai login
Automatically obtain device ID, call the registration login interface to obtain token, and save it to ~/. newtranx/config. json . The token is valid for 15 days.
2. Upload videos
Supports local files and HTTP URLs, only supports mp4 format. If the format is not supported, please use ffmepg to transcode to mp4 file size not exceeding 5GB and duration not exceeding 4 hours. Important: URLs containing ? or & must be quoted to avoid shell glob errors.
npx newtranx-ai upload ./video.mp4
# HTTP URL
npx newtranx-ai upload https://example.com/video.mp4
Restrictions: -Format: mp4 only -Size: not exceeding 5GB
Automatically upload videos in 4MB chunks and display upload progress. After uploading, output the task ID.
3. Submit translation task
npx newtranx-ai translate --id \x3CtaskID> \
--audio-lang en-US \
--trans-lang zh-CN \
--max-speakers 2 \
--export-subtitle
Parameter description:
--id(Required): Upload the returned task ID--audio-lang(Required): Call thenpx newtranx-ai languagecommand in the original language of the video to view--trans-lang(Required): Call thenpx newtranx-ai languagecommand to view the target translation language--max-speakers: Number of speakers--export-subtitle: Do you want to merge subtitles into the video--re-transwrite: Do you want to rewrite it--subtitle-font-size: Subtitle Font Size--subtitle-max-chars: Maximum number of characters per subtitle segment--subtitle-outline-color: Subtitle outline color--subtitle-primary-color: Subtitle main color
4. Regularly query query results
# default output translated video download link
npx newtranx-ai status --id \x3CtaskID>
# output original VTT subtitles download link
npx newtranx-cli status --id \x3CtaskID> --subtitle
# output translated VTT subtitles download link
npx newtranx-cli status --id \x3CtaskID> --targetSubtitle
# output metadata include speaker information download link
npx newtranx-cli status --id \x3CtaskID> --metadata
When 'iterationStatus==Succeeded', the result contains:
- Translated video download link
- Source language subtitle file link
- Target language subtitle file link
- Metadata file link
5. Query supported languages
npx newtranx-ai language
npx newtranx-ai language --region CN
Return a list of language codes and names that can be used for the audio lang and trans lang parameters of the translate command.
Usage Tips
- If the token expires, call
npx newtranx ai loginand then retry. - It must be called according to the process.
Usage Guidance
This skill appears to do what it says (an npx CLI that uploads and translates MP4 videos), but it relies on running an unvetted npm package (newtranx-ai) and saving an auth token in ~/.newtranx/config.json. Before installing or running these commands: 1) Verify the package on npm or its source repository and check the maintainer(s), stars, and recent activity; 2) Prefer to inspect the package source (or its GitHub repo) before running npx; 3) Understand the service's privacy policy — where uploaded videos and generated files are stored, how long they are retained, and whether data is encrypted; 4) Avoid uploading sensitive or regulated video content unless the backend is trusted; 5) Consider running the CLI in a sandbox/container or on a disposable account, and delete the ~/.newtranx/config.json file and revoke tokens after use; 6) If you need assurance, request the package's homepage/source, release hashes, or an official publisher identity — presence of these would increase confidence and could change this assessment.
Capability Analysis
Type: OpenClaw Skill
Name: ai-video-translation
Version: 1.0.0
The skill bundle provides instructions for an AI agent to interact with the 'newtranx-ai' CLI tool for video translation. The documentation covers standard operations such as authentication (storing tokens in ~/.newtranx/config.json), file uploading, and task status monitoring. There are no signs of data exfiltration, malicious execution, or prompt injection; the instructions even include helpful security tips like quoting URLs to prevent shell globbing errors in SKILL.md.
Capability Assessment
Purpose & Capability
The name/description (video translation) align with the SKILL.md which documents an npx CLI (newtranx-ai) that uploads MP4s, starts translation jobs, and returns download links. There are no unrelated requirements (no cloud creds or unrelated binaries declared). However, the package source and homepage are missing, which makes it hard to verify that the described CLI actually exists and is trustworthy.
Instruction Scope
Runtime instructions are narrowly scoped to: running npx newtranx-ai commands to login, upload MP4s (local or URL), create translation tasks, and poll status. The SKILL.md instructs storing a token in ~/.newtranx/config.json and references using ffmpeg for transcoding if needed. It does not ask the agent to read unrelated files or environment variables. Still, the instructions explicitly cause potentially sensitive video files and an authentication token to be uploaded/stored remotely — a data-exposure concern.
Install Mechanism
There is no install spec in the skill; instead the instructions tell users to run npx --yes newtranx-ai which will fetch and execute code from the npm registry at runtime. The skill provides no homepage, source repo, publisher info, or verification hashes. Running npx on an unvetted package carries supply-chain risk: arbitrary code can be executed with the user's account privileges and may exfiltrate data or create files (e.g., the token file).
Credentials
The skill declares no required environment variables or external credentials, which is proportionate. However, its workflow relies on an authentication token obtained via the CLI and saved at ~/.newtranx/config.json (token valid 15 days). That token and the uploaded video content are sensitive; the SKILL.md gives no details about the backend endpoints, data retention, encryption, or revocation, so the credential/storage behavior is a privacy/security concern even if it is functionally consistent with the skill's purpose.
Persistence & Privilege
The skill does not request always:true and does not declare elevated privileges. The CLI will create a config file in the user's home directory to store a token, which is a normal persistence pattern for a CLI but is worth noting because it stores credentials locally. No instructions indicate modifying other skills or system-wide settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install ai-video-translation - After installation, invoke the skill by name or use
/ai-video-translation - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of ai-video-translation skill.
- Introduces newtranx CLI for translating MP4 video files from the terminal.
- Supports upload from local files or HTTP URLs (MP4 only, ≤5GB, ≤4 hours).
- Allows translating audio between languages with speaker recognition and subtitle export.
- Provides commands for task management, including login, upload, translation, status check, and language query.
- Enables exporting original and translated videos, subtitles, and speaker metadata.
- Includes detailed command usage and parameters for customization.
Metadata
Frequently Asked Questions
What is AI Video Translation?
newtranx CLI for translate MP4 videos, Used for directly translating video files on the terminal. When you want to translate video files from one country's a... It is an AI Agent Skill for Claude Code / OpenClaw, with 375 downloads so far.
How do I install AI Video Translation?
Run "/install ai-video-translation" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is AI Video Translation free?
Yes, AI Video Translation is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does AI Video Translation support?
AI Video Translation is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created AI Video Translation?
It is built and maintained by wxj127 (@wxj127); the current version is v1.0.0.
More Skills