HandBrake Web
A self-hosted web platform for distributed video encoding using HandBrake across multiple headless devices.
What is HandBrake Web?
HandBrake Web is a self-hosted platform that provides a web interface to use HandBrake for video encoding on headless devices. It allows users to distribute encoding tasks across multiple machines, managing a shared job queue through a browser-based dashboard. The project solves the problem of efficiently processing large video libraries by leveraging distributed computing and hardware acceleration.
Media server administrators, homelab enthusiasts, and developers who need to batch encode videos across multiple headless machines without a desktop GUI. It's ideal for those with a collection of devices (like NAS units, spare PCs, or servers) they want to utilize for video processing.
Developers choose HandBrake Web because it offers a scalable, self-hosted solution for distributed video encoding that integrates seamlessly with HandBrake's powerful CLI. Its unique selling point is the ability to pool resources from multiple workers into a single managed queue, with support for hardware-accelerated encoding, all accessible via a clean web interface.
Overview
A self-hosted platform to use HandBrake on your headless devices via a bespoke web interface. Harness the processing power of multiple devices to work on a single queue.
Use Cases
Best For
- Encoding large video libraries across multiple headless servers
- Setting up a distributed media processing pipeline for a homelab
- Batch converting video formats using HandBrake presets without a desktop
- Automating video encoding with directory watchers for new media
- Leveraging GPU hardware acceleration (Intel QSV/NVIDIA NVENC) in a server environment
- Managing a shared encoding queue accessible via a web browser
Not Ideal For
- Teams requiring a stable, production-ready video encoding solution without beta software risks
- Users with only a single machine who don't need distributed encoding capabilities
- Environments without Docker or where containerization infrastructure is not available
- Projects needing immediate support for AMD GPU hardware acceleration (VCN)
Pros & Cons
Pros
Leverages multiple workers across devices to process jobs concurrently, enabling scalable batch processing for large media libraries as highlighted in the features.
Provides a browser dashboard for managing jobs, presets, and workers, making it accessible from anywhere without a desktop GUI, as shown in the screenshots.
Integrates Intel QSV and NVIDIA NVENC for faster GPU encoding, with detailed wiki pages for configuration, speeding up processing times significantly.
Directory watchers automatically create encoding jobs when new videos are added to monitored folders, streamlining media server workflows.
Cons
The project is at v0.9.0 with a warning about heavy development and known issues, making it risky for critical or stable production environments.
Requires Docker Compose configuration with separate server and worker containers, which can be challenging for users unfamiliar with container orchestration.
Relies on presets exported from the desktop HandBrake app; built-in preset creator is a planned feature not yet implemented, limiting on-the-fly customization.
Frequently Asked Questions
Related Projects
HuginnCreate agents that monitor and act on your behalf. Your agents are standing by!
matchering🎚️ Open Source Audio Matching and Mastering
µTaskµTask is an automation engine that models and executes business processes declared in yaml. ✏️📋
CronmasterCronjob management UI with human readable syntax, live logging and log history for your cronjobs.
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.