# MediaForge

MediaForge is a self-hosted media ingest engine, packaged as a single Docker container, that handles the complete journey of a raw video file from arrival to library-ready. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2444/mediaforge

## Description

MediaForge is a self-hosted media ingest engine, packaged as a single Docker container, that handles the complete journey of a raw video file from arrival to library-ready. It watches a folder for new files, detects codecs via ffprobe, identifies titles through TVDB, TMDB, and OMDb with LLM-assisted verification, transcodes H.264 files to HEVC using hardware acceleration (NVIDIA, AMD, Intel, or CPU fallback), and renames files to media-server-compatible conventions. MediaForge is not a media server; it feeds Plex, Jellyfin, Emby, or any other media server that watches a library folder.

## Platform availability

Available on 2 of 10 platforms: Unraid, Windows.

## Desktop and other devices

Windows.

## Health score

57/100 (Fair), based on 3 of 4 factors.
- Maintained: 88 (last commit 23 days ago)
- Popular: 17 (6 GitHub stars)
- Easy to install: 45 (2 install platforms, install notes, Docker image)

## Links

- desktop: https://github.com/braydin72/mediaforge/releases/latest
- Documentation: https://github.com/globaltechinfo/mediaforge
- Docker Hub: https://hub.docker.com/r/braydin72/mediaforge
- Unraid: https://ca.unraid.net/apps/mediaforge-0rqu1x20xinvg2?q=MediaForge

## Common questions

### Which API keys do I need to configure for identification?

TMDB is required for movies, and TVDB is required for TV shows. OMDb can be added as an optional fallback.

### What should I use for the /staging volume?

Use fast storage such as an SSD or cache pool. It is intended for encode working files.

### What port does the web UI use?

The web UI runs on port 8080. Expose 8080 in Docker Compose and access the server IP at that port.

### What happens if a file cannot be processed automatically?

It does not fail silently. The file is placed in the Review Queue with a specific reason.

### Is there a maximum file size?

Because processing is local, the limit depends on device memory. Files under 2GB are generally recommended for stability.

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