X265-butler

X265-butler reclaims disk space on unRAID by automatically transcoding video files to HEVC (x265) using ffmpeg with hardware acceleration.

  • Media Applications
  • Productivity
  • Tools & Utilities
X265-butler reclaims disk space on unRAID by automatically transcoding video files to HEVC (x265) using ffmpeg with hardware acceleration. It scans media shares for non-x265 files, transcodes them in the background, tracks results in a dashboard, and never re-encodes the same file twice. Designed for self-hosters who want a lightweight alternative to Tdarr, FileFlows, or Unmanic.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

46/100 Fair

Maintained
71last commit 45 days ago
Popular
144 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed today, links checked 16 days ago

GitHub stars
4
Open issues
0
Last commit
2026-10-07
Latest release
jellyfin-ffmpeg-v7.1.4-3
Activity
stale

Checked 5 days ago - source: GitHub (masterjb/x265-butler)

Resources & Compatibility

Requirements not published yet.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Pin Version for Production Stability The Unraid template uses the :latest image tag, which auto-deploys every release including potentially-breaking major version transitions (e.g. v2.x to v3.x). For production stability, edit the Container's Repository field to pin an exact version (e.g. ghcr.io/masterjb/x265-butler:2.16.0). source
  • Migrate to GitLab image The GitHub repository is archived. Update the unRAID container Repository to registry.gitlab.com/misterjb/x265-butler:latest to receive updates. source
  • Update existing unRAID installs to the new GitLab image The project moved to GitLab. If you already run X265-butler on unRAID, edit the container and change the Repository field to registry.gitlab.com/misterjb/x265-butler:latest. The old GitHub (ghcr.io) image is no longer updated, and un-migrated installs stay on 2.53.0 with no further updates. source

Fetched today - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Which image tag should a Unraid user pin for x265-butler?

The Unraid template uses the latest tag, which auto-deploys every release including potentially breaking major version transitions. For production stability, pin an exact semver tag in the container's Repository field.

Does x265-butler delete original video files after transcoding?

Originals are handled through a trash store with configurable retention, defaulting to 30 days, and can be restored. You can also choose whether the transcoded file keeps an .x265.mkv suffix or replaces the original in place.

Does x265-butler keep Unraid hard drives active while encoding?

It uses cache-pool staging so HDDs can stay spun down during encoding.

Can x265-butler transcode without a supported GPU?

It auto-detects QSV, NVENC, and VAAPI hardware encoders and falls back to libx265 software encoding when needed.

Is the x265-butler dashboard protected by authentication by default?

Username and password authentication is optional and is off by default.

Will new video files be queued automatically after installation?

No; new installs start with the automatic-encode master switch off, and the onboarding wizard asks about it. Files are queued without a click only when that switch is on.

Answers sourced from github.com

Community

Collected 49 days ago - public community threads