All apps · 0 apps

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. Setup guide (install, updates, GPU): https://gitlab.com/MisterJB/x265-butler/-/blob/main/docs/user/README.md [!] Images moved to the GitLab registry with v2.54.0. Installs from before must change the Repository field to registry.gitlab.com/misterjb/x265-butler:latest to keep receiving updates; the old ghcr.io image stays at 2.53.0. Recent highlights: Stats + Dashboard / UI Redesign / Encoder-Benchmark with Pareto-Frontier / Encoder-Profile-Editor / Multi-Share / Storage-Analyzer / Auto-Scan-on-Change. Release notes for every version: https://gitlab.com/MisterJB/x265-butler/-/releases [!] Image tag: we strongly recommend keeping the :latest tag in the Repository field. Fixes only ship in new releases, older version tags are removed from the registry over time, and Unraid shows update notices only for :latest. Read the release notes before a major upgrade (v2.x to v3.x). A version tag (registry.gitlab.com/misterjb/x265-butler:X.Y.Z) is only a short way back to the previous release: back up your AppData folder first and switch back to :latest once a fix is out.

Related apps

Explore more like this

Explore all

Video apps Productivity

Links

Projectgitlab.com Supportforums.unraid.net Registrygitlab.com Templateraw.githubusercontent.com

Details

Repository

registry.gitlab.com/misterjb/x265-butler:latest

Registry

https://gitlab.com/MisterJB/x265-butler/container_registry

Last Updated2026-10-16

First Seen2026-10-07

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

MediaPathrw

Your media share. Butler scans it and writes the HEVC file into the same folder as the original, so it needs read and write access. Installs from an older template that use /library keep working unchanged.

Target: /media
Default: /mnt/user/Media

AppDataPathrw

Database, settings and a cache subfolder for encode scratch space and job logs. Called Config in versions before 2.52: same path, nothing to change. To put the cache on a fast pool, set Cache Pool below.

Target: /config
Default: /mnt/user/appdata/x265-butler

Cache Pool (optional)Pathrw

Optional. Leave empty to keep the cache inside AppData. Point it at a fast SSD pool, e.g. /mnt/cache/x265-butler.

Target: /cache

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

NVIDIA_VISIBLE_DEVICESVariable

Optional, for NVENC only. Set to all (or a GPU UUID) and add --runtime=nvidia under Extra Parameters. Leave empty without an NVIDIA GPU.

NVIDIA_DRIVER_CAPABILITIESVariable

For NVENC only. Keep compute,video,utility; without video every NVENC encode fails. Ignored without --runtime=nvidia.

Default: compute,video,utility
Value: compute,video,utility

Library

Curated

Categories