X265-butler
X265-butler reclaims disk space on unRAID by automatically transcoding video files to HEVC (x265) using ffmpeg with hardware acceleration.
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
Variants
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
- x264 or x265 : r/selfhosted - Reddit (reddit)
- Is it worth converting my library to h.265? : r/selfhosted - Reddit (reddit)
- r/selfhosted on Reddit: Gearr announcement - A versatile video ... (reddit)
- Playing with x265 - VideoHelp Forum (forum)
- Human-126094 - Unraid (forum)
- Quick alternate to fix lagging x265 files : r/PleX - Reddit (reddit)
Collected 49 days ago - public community threads