A custom Docker image that combines the official Homebridge Ubuntu container with Jellyfin's optimized FFmpeg build for enhanced video processing capabilities.

This is based off the ubuntu base of the official container, so before you switch to this, you might want to make sure you're using homebridge/homebridge:ubuntu.

• Latest Homebridge: Always builds from the latest official Homebridge Docker image - Ubuntu version
• Jellyfin FFmpeg: Includes Jellyfin's hardware-accelerated FFmpeg build with Intel Quick Sync support
• Automatic Updates: GitHub Actions automatically checks for and builds new versions daily
• Multi-Architecture: Supports both AMD64 and ARM64 platforms
• Zero Maintenance: Set it and forget it - updates happen automatically

After switching to this docker

Since we dont replace the stock ffmpeg, you will need to update the ffmpeg path youre using to the new one:

/usr/lib/jellyfin-ffmpeg/ffmpeg

In this example, I have to change 'Video Processor' option in your Homebridge UI for the Unifi-Video plugin to reflect the new path.

To verify Jellyfin FFmpeg is properly installed:

docker exec homebridge-ffmpeg-intel /usr/lib/jellyfin-ffmpeg/ffmpeg -version

Section 8: Environment Variables

This image is automatically updated when:

• New Homebridge releases are published
• New Jellyfin FFmpeg builds are available
• Daily checks run at 2 AM UTC via GitHub Actions

• GitHub Actions: Checks daily at 2:00 AM UTC
• Watchtower: Checks daily at 4:00 AM local time (if enabled)
• Manual: Trigger builds via GitHub Actions tab

git clone https://github.com/keithah/homebridge-ffmpeg-intel.git cd homebridge-ffmpeg-intel docker build -t homebridge-ffmpeg-intel .

docker logs homebridge-ffmpeg-intel

sudo chown -R 1000:1000 ./homebridge

docker exec homebridge-ffmpeg-intel which /usr/lib/jellyfin-ffmpeg/ffmpeg

docker exec homebridge-ffmpeg-intel /usr/lib/jellyfin-ffmpeg/ffmpeg -version

sudo lsof -i :8581

docker run ... -e HOMEBRIDGE_CONFIG_UI_PORT=8582 ...

• Homebridge Documentation
• Homebridge Docker Image
• Jellyfin FFmpeg Documentation
• Docker Compose Documentation

1. Fork the repository
2. Create a feature branch: git checkout -b feature-name
3. Commit your changes: git commit -am 'Add feature'
4. Push to the branch: git push origin feature-name
5. Submit a pull request

This project builds upon the official Homebridge Docker image and Jellyfin FFmpeg. Please refer to their respective licenses:

• Homebridge License
• Jellyfin License

• Homebridge - HomeKit support for the impatient
• Jellyfin - Free Software Media System
• FFmpeg - Complete, cross-platform solution for video/audio

Star ⭐ this repo if it helped you!