MovieClaw

文档/安装

硬件转码

让 Intel / AMD 核显、NVIDIA 显卡或一台 Apple Silicon Mac 来转码,播放器放不了的格式也能流畅播放。

最后核对:2026-10-04

MovieClaw 能直接播放就直接播放,只有播放器放不了的编码才转码,转码前会告诉你代价。Infuse 这类全解码播放器永远走直连,不需要转码。 没有硬件转码也能用软件转码,只是很吃 CPU。

硬件方式
Intel 核显QSV / VAAPI,挂载 /dev/dri
AMD 核显VAAPI,挂载 /dev/dri
NVIDIA 显卡NVENC,需要 NVIDIA Container Toolkit
Apple Silicon MacVideoToolbox,通过「MovieClaw 转码器」远程转码

启动时 MovieClaw 会真的跑一秒编码来自检,能不能硬件转码、缺什么,都会用中文写在设置的「播放」页和启动日志里。

Intel / AMD 核显

先在宿主机上运行 ls /dev/dri,能看到 renderD128 之类的设备再继续。ARM 机型和没有核显的机器通常没有。

services:
  movieclaw:
    # ……其余配置不变
    devices:
      - /dev/dri:/dev/dri

NVIDIA 显卡

NVIDIA 显卡不走 /dev/dri。先在宿主机装好 NVIDIA 驱动和 NVIDIA Container Toolkit,再加上:

services:
  movieclaw:
    # ……其余配置不变
    runtime: nvidia
    environment:
      - TZ=Asia/Shanghai
      - NVIDIA_VISIBLE_DEVICES=all
      - NVIDIA_DRIVER_CAPABILITIES=all

用 Mac 转码

macOS 上的 Docker 跑在虚拟机里,用不到 Mac 的 GPU。所以 MovieClaw 提供了一个菜单栏 App「MovieClaw 转码器」, 让一台常开的 Apple Silicon Mac(比如 Mac mini)用 VideoToolbox 帮服务器转码。服务器可以在 NAS 上,Mac 不用挂载 NAS,转码器通过网络读取源文件、回传结果。

  1. 在 MovieClaw 网页的「设置 → 播放」里打开远程转码。
  2. 从 GitHub Releases 下载 MovieClawTranscoder-macos-arm64.zip,解压后把 App 拖进「应用程序」。需要 macOS 12 及以上。
  3. 打开 App,选中局域网里找到的 MovieClaw(找不到就手动填地址,建议用局域网地址),点「连接并配对」。
  4. App 会打开批准页,用管理员账号核对配对码后批准。之后在「设置 → 设备」里可以看到和吊销这台 Mac。