# X265-butler

X265-butler is a self-hosted media applications app. X265-butler reclaims disk space on unRAID by automatically transcoding video files to HEVC (x265) using ffmpeg with hardware acceleration. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3488/x265-butler

## Description

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.

## Health score

46/100 (Fair), based on 3 of 4 factors.
- Maintained: 71 (last commit 45 days ago)
- Popular: 14 (4 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Documentation: https://forums.unraid.net/topic/182094-support-human-126094-docker-templates/
- Unraid: https://ca.unraid.net/apps/x265-butler-155twrw0p6h6l4?q=x265-butler

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/3488/x265-butler), the self-hosted and open-source app directory.
