/install ai-video-translation
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.
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install ai-video-translation - 安装完成后,直接呼叫该 Skill 的名称或使用
/ai-video-translation触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
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... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 375 次。
如何安装 AI Video Translation?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install ai-video-translation」即可一键安装,无需额外配置。
AI Video Translation 是免费的吗?
是的,AI Video Translation 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
AI Video Translation 支持哪些平台?
AI Video Translation 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 AI Video Translation?
由 wxj127(@wxj127)开发并维护,当前版本 v1.0.0。