x265-butler
x265-butler
Docker app from Human-126094's Repository
Overview
x265-butler reclaims disk space on Unraid by automatically transcoding video files
to HEVC (x265). Scans library shares for non-x265 files, transcodes them in the
background using ffmpeg, tracks results in a dashboard, and never re-encodes the
same file twice. Lighter-weight than Tdarr / FileFlows / Unmanic.
Recent highlights: Stats + Dashboard / UI Redesign /
Encoder-Benchmark with Pareto-Frontier / Encoder-Profile-Editor / Multi-Share /
Storage-Analyzer / Auto-Scan-on-Change.
See full release notes:
https://github.com/masterjb/x265-butler/blob/main/CHANGELOG.md
[!] Auto-update notice: This template now uses the :latest image tag,
which auto-deploys every release including potentially-breaking Major
version transitions (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). Release notes for every version:
https://github.com/masterjb/x265-butler/blob/main/CHANGELOG.md
Live release feed (all versions):
https://github.com/masterjb/x265-butler/blob/main/CHANGELOG.md
Runtime arguments
- Web UI
http://[IP]:[PORT:3000]/- Network
bridge- Shell
sh- Privileged
- false
Template configuration
WebUI PortPorttcp
HTTP port for the x265-butler dashboard
- Target
- 3000
- Default
- 3000
- Value
- 3000
LibraryPathrw
Path containing video files to scan + transcode
- Target
- /library
- Default
- /mnt/user/Media
ConfigPathrw
Persistent config + database directory
- Target
- /config
- Default
- /mnt/user/appdata/x265-butler
PUIDVariable
User ID (typically 99 on unRAID)
- Default
- 99
- Value
- 99
PGIDVariable
Group ID (typically 100 on unRAID)
- Default
- 100
- Value
- 100
TZVariable
Container timezone
- Default
- Europe/Berlin
- Value
- Europe/Berlin
Categories
Details
Repository
ghcr.io/masterjb/x265-butler:latestLast Updated2026-05-31
First Seen2026-05-22
Run x265-butler on Unraid.
x265-butler is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.