# FinTV

FinTV is a self-hosted media servers app. FinTV creates virtual 24/7 TV channels from a Jellyfin media library and broadcasts them as HLS (HTTP Live Streaming) feeds. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/7772/fintv

## Description

FinTV creates virtual 24/7 TV channels from a Jellyfin media library and broadcasts them as HLS (HTTP Live Streaming) feeds. The same container hosts the repository for the FinTV Jellyfin plugin, so the plugin can be installed and managed directly from the Jellyfin dashboard. It supports CPU encoding via libx264 with optional NVIDIA NVENC hardware acceleration, configurable media path mappings, and API-key authentication, making it a good fit for homelab users who want their movies, shows, and music to stream continuously to TVs, tablets, and other devices.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

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

## Links

- Unraid: https://ca.unraid.net/apps/fintv-00o10ez1blaw53?q=FinTV
- GitHub: https://github.com/SolidProgramming/UnraidTemplates

## Common questions

### Why does FinTV fail on first start with "Applying database migrations failed"?

The container runs as UID 99 / GID 100 and expects the appdata directory to already exist with that ownership. Pre-create it in the Unraid terminal with mkdir -p /mnt/user/appdata/fintv and chown 99:100 /mnt/user/appdata/fintv before the first start; otherwise Docker creates the directory as root and the service cannot write the database.

### How do I configure media path mappings so FinTV finds the same files Jellyfin uses?

Mount the media share at /media inside the container, then set the path mapping "From" to the path as it appears in Jellyfin and "To" to the corresponding path inside the container.

### Can FinTV use hardware-accelerated encoding?

By default it encodes on the CPU with libx264, but optional NVIDIA NVENC acceleration is available if you have an NVIDIA GPU and the Unraid Nvidia Driver plugin installed.

### What are the requirements for the FinTV API key?

The key must be at least 32 characters. A practical way to generate one is to run openssl rand -hex 32 in the terminal and use the output.

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