# joshuaboniface/rffmpeg

rffmpeg: remote SSH FFmpeg wrapper tool

Repository: https://github.com/joshuaboniface/rffmpeg
Canonical: https://ross.abutalabs.com/products/rffmpeg
Language: Python
License: GPL-3.0
License Family: copyleft
Last push: 2025-11-03T19:42:58+00:00

## Health v2 (maintenance only)
Score: 45/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 50, release rhythm 8, longevity 100
- inputs: {"age_days": 2510, "days_push": 303, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1067, forks 59 (observed 2026-08-28T04:03:27.261599+00:00)

## What it is
rffmpeg is a Python CLI wrapper that executes FFmpeg and ffprobe commands on remote servers over SSH. It lets media servers like Jellyfin offload transcoding to remote machines with better hardware or distribute transcodes across multiple hosts.

## Use cases
- offload jellyfin ffmpeg transcoding to a remote server over ssh
- distribute video transcoding across multiple servers for load balancing
- use hardware acceleration on a remote machine for media transcodes
- run ffmpeg commands on remote hosts transparently
- set up a transcode backend for a home media server
- replace local ffmpeg binary with a remote ffmpeg wrapper

## When to choose
- you run a media server like Jellyfin whose local hardware can't handle transcoding
- you want to spread transcoding load across several machines
- you need ffmpeg to run transparently on remote hosts via SSH

## When to avoid
- you only transcode locally and have sufficient hardware
- you need a general-purpose distributed video processing pipeline rather than an ffmpeg drop-in
- your media server and transcode host cannot communicate over SSH

## Facets
- artifact type: cli-tool
- maturity: active
- function: video-processing, cli, developer-tools
- domain: media, self-hosted
- platform: python, cli, self-hosted
- tags: ffmpeg, ssh, transcoding, jellyfin, load-balancing, remote-execution, video, automation, linux

## Member repositories
- joshuaboniface/rffmpeg (main) score 45

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:27.261599+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:55:10.789085+00:00, confidence not recorded.
  - readme: https://github.com/joshuaboniface/rffmpeg (fetched 2026-08-28T04:03:27.261599+00:00, sha 9ea1e2d1c4e5)
- Data as of 2026-08-30T08:39:29.467469+00:00.