Skip to content

v0.7.25

Choose a tag to compare

View all tags
@github-actions github-actions released this 04 Sep 13:38
· 101 commits to main since this release
v0.7.25
6eb7881

Remote VideoToolbox for FFmpeg: use a Mac or Apple Silicon system over LAN as an IP-based H.264/HEVC encode/decode/transcoding accelerator.

1-minute quickstart

  1. On the Mac server, download vtremoted-macos-arm64.tar.gz (Apple Silicon) or vtremoted-macos-x86_64.tar.gz (Intel Mac).
  2. On the client, download the FFmpeg build for your platform: ffmpeg-linux-x86_64.tar.gz, ffmpeg-macos-arm64.tar.gz, ffmpeg-macos-x86_64.tar.gz, or ffmpeg-windows-x86_64.tar.gz.
  3. Start vtremoted on the Mac:
tar -xzf vtremoted-macos-arm64.tar.gz
./vtremoted/vtremoted --listen 0.0.0.0:5555 --log-level 1
  1. Run a remote encode from the client:
mkdir -p ffmpeg-client
tar -xzf ffmpeg-linux-x86_64.tar.gz -C ffmpeg-client
./ffmpeg-client/ffmpeg -i input.mkv \
  -c:v h264_videotoolbox_remote \
  -vt_remote_host <MAC_IP>:5555 \
  -b:v 6000k \
  output.mkv

Which asset do I need?

  • vtremoted-macos-arm64.tar.gz: macOS server binary for Apple Silicon Macs.
  • vtremoted-macos-x86_64.tar.gz: macOS server binary for Intel Macs.
  • ffmpeg-linux-x86_64.tar.gz: FFmpeg client build for Linux.
  • ffmpeg-macos-arm64.tar.gz: FFmpeg client build for Apple Silicon Macs.
  • ffmpeg-macos-x86_64.tar.gz: FFmpeg client build for Intel Macs.
  • ffmpeg-windows-x86_64.tar.gz: FFmpeg client build for Windows.
  • vtremote-vaapi-linux-x86_64.tar.gz: encode-only VA-API driver, Plex packet shim, and experimental static C SDK for Linux.
  • vtremote-vaapi-*-source.tar.gz: matching VA-API driver source bundle.
  • SHA256SUMS.txt: checksums for all release tarballs.

Build and upgrade notes

  • v0.4.1-capable clients and servers negotiate the expanded media surface explicitly: hardware-frame ingest/output, HEVC bgra/ayuv/p210le, frame and packet side-data forwarding, and vtremote_transcode HDR signaling.
  • Linux FFmpeg artifacts are built for x86_64. If a source build fails in FFmpeg x86 assembly, first install current nasm and yasm; as a compatibility fallback, rebuild with make build-ffmpeg FFMPEG_DISABLE_X86ASM=1.
  • To verify a macOS server upgrade, run vtremoted --version, pgrep -fl vtremoted, and lsof -nP -iTCP:5555 -sTCP:LISTEN on the Mac.
  • Release tarballs are smoke-tested after packaging to confirm the vtremote FFmpeg encoders, decoders, and vtremote_transcode bitstream filter are present.
  • The VA-API artifact is tested through stock FFmpeg and an unclaimed-server Plex Transcoder smoke; claimed Plex Pass servers can additionally run the PMS playback-policy test.

What changed in this release?

Changed

  • Rebased the vendored ffmpeg/ subtree to upstream master snapshot 818e5d965be9 (from 9fc8c785e274).

Learn more

Assets 19
Loading