# Backdrop Generator

Backdrop Generator is a self-hosted media applications app. Generates .mp4 backdrop clips from your Jellyfin/Emby movie and TV libraries using FFmpeg. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2222/backdrop-generator

## Description

Generates .mp4 backdrop clips from your Jellyfin/Emby movie and TV libraries using FFmpeg. Supports audio control and expert mode for custom FFmpeg parameters. Fully configurable via Unraid UI.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

34/100 (Low), based on 4 of 5 factors.
- Maintained: 21 (last commit 519 days ago)
- Popular: 23 (13 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 75 (no serious findings)

## Links

- Docker Hub: https://hub.docker.com/r/vlx42/backdrop-generator
- Unraid: https://ca.unraid.net/apps/backdrop-generator-0zmy3re1hfij2e?q=backdrop-generator

## Common questions

### How can I stop the generator from recreating every clip on each run?

It automatically skips files that already have a backdrop unless FORCE is set to true or --force is passed.

### Can the generated backdrops be silent?

Set NO_AUDIO=true or use --no-audio to generate clips without audio; otherwise audio is included by default.

### How do I add custom FFmpeg arguments without changing the image?

Pass FFMPEG_EXTRA or --ffmpeg-extra with extra parameters, which are added to the FFmpeg command line; quote parameters with spaces.

### What controls how long a single FFmpeg encode can run?

Use --timeout or TIMEOUT to set the timeout per FFmpeg call in seconds; the default is 300 seconds.

### Can it keep rescanning the library after the first run?

The README lists an optional daemon mode for periodic rescanning.

---
Source: Our Local Host (https://ourlocalhost.com/app/2222/backdrop-generator), the self-hosted and open-source app directory.
