这是一个 VLC 3 的 CRIWARE USM 解复用插件。它会从 USM 文件的 @SFV
chunk 中取出 VP9 视频帧,按配置的 CRIWARE key 解密,然后交给 VLC 自带的
VP9 解码器播放。
当前支持:
- 直接打开
.dat/ USM 文件。 - 加密 VP9 视频解密。
- 从默认 key 文件读取密钥,适合在文件管理器里双击打开。
- 基于时间轴拖动进度。
cmake -S . -B build
cmake --build build
ctest --test-dir build --output-on-failure在 MSYS2 的 MINGW64 shell 里安装依赖并构建:
pacman -S --needed mingw-w64-x86_64-gcc mingw-w64-x86_64-cmake \
mingw-w64-x86_64-pkgconf mingw-w64-x86_64-ninja \
mingw-w64-x86_64-libvpx mingw-w64-x86_64-vlc
cmake -S . -B build -G Ninja
cmake --build build
ctest --test-dir build --output-on-failure从 MINGW64 shell 构建时 pkg-config 会自动找到 vlc-plugin 和 vpx,无需手动配置
路径。若在其它环境构建,用环境变量 PKG_CONFIG_PATH 或 -DCMAKE_PREFIX_PATH 指定。
cd packaging/arch PKGDEST=../.. makepkg -f cd ../.. sudo pacman -U vlc-plugin-usm-0.1.0-3-x86_64.pkg.tar.zst
安装后 VLC 的插件缓存会由 pacman hook 自动更新。
把构建出的 libusm_plugin.dll 放进 VLC 的 plugins/demux 目录:
- 官网版 VLC:
C:\Program Files\VideoLAN\VLC\plugins\demux\ - MSYS2 版 VLC:
C:\msys64\mingw64\lib\vlc\plugins\demux\
Windows 构建默认会把 libvpx 以及 mingw 运行时(libgcc / libwinpthread)静态链接进 DLL(CMake 选项
USM_STATIC_VPX,Windows 下默认 ON)。这样最终 DLL 只依赖libvlccore.dll(VLC 自带)和系统库,官网版 VLC 和 MSYS2 版 VLC 都能直接加载, 不需要额外拷libvpx-1.dll。已在官网版 VLC 3.0.23 上实测可正常解复用并播放。如果想动态链接 libvpx(DLL 更小,但需自行保证
libvpx-1.dll在 VLC 能找到的路径 上),配置时加-DUSM_STATIC_VPX=OFF。
安装后若不识别,删除缓存 plugins.dat 并重建:
& "C:\Program Files\VideoLAN\VLC\vlc-cache-gen.exe" "C:\Program Files\VideoLAN\VLC\plugins"
推荐把 key 写到 VLC 配置目录下的默认文件里,这样双击文件打开时也能自动解密。
Linux:
mkdir -p ~/.config/vlc printf '0x7F4551499DF55E68\n' > ~/.config/vlc/usm-keys.txt
Windows(官网版 VLC):
New-Item -ItemType Directory -Force "$env:APPDATA\vlc" | Out-Null Set-Content "$env:APPDATA\vlc\usm-keys.txt" "0x7F4551499DF55E68"
默认读取顺序:
- Windows:
%APPDATA%\vlc\usm-keys.txt - Linux:
$XDG_CONFIG_HOME/vlc/usm-keys.txt,否则~/.config/vlc/usm-keys.txt
key 文件支持十进制或 0x 前缀的十六进制;多个 key 可以用逗号、分号、空白或换行
分隔。# 后面的内容会当作注释。配置多个 key 时,插件会用 libvpx 试解码自动选出
能正确解密的那个。
也可以启动时临时传 key:
vlc --usm-keys 0x7F4551499DF55E68 /path/to/movie.dat
& "C:\Program Files\VideoLAN\VLC\vlc.exe" --usm-keys 0x7F4551499DF55E68 C:\path\to\movie.dat
或者指定一个自定义 key 文件:
vlc --usm-key-file /path/to/usm-keys.txt /path/to/movie.dat
- 当前只输出视频流,没有输出音频流。
- seek 通过从文件头重扫到目标时间附近的 VP9 keyframe 实现;大文件拖进度时 可能会比普通容器慢一些。