# Tofarr

Tofarr is an unofficial companion app for the Tofa media server. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/6931/tofarr

## Description

Tofarr is an unofficial companion app for the Tofa media server. It builds Tofa collections from TMDB, Trakt and IMDb lists, Tofa's own discovery shelves or a list of TMDB ids, keeps them in the order of the source, and updates them on a schedule. A Discover page shows posters with an In library badge, and with Seerr connected you can request titles you do not have. Nothing is written until you have seen a preview. Setup: open the web UI and create your login, then open Settings and enter your Tofa address (for example http://192.168.1.10:33333, not the relay) and an admin API key from Tofa under Server, Settings, API keys. A free TMDB API key is needed for TMDB and IMDb sources, a Trakt client ID for Trakt, and a Seerr address and key for requests. The variables below are optional defaults for the same settings.

## Platform availability

Available on 1 of 9 platforms: Unraid.

## Health score

40/100 (Fair), based on 3 of 4 factors.
- Maintained: 75 (last commit 1 day ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 20 (1 install platform, Docker image)

## Links

- Unraid: https://ca.unraid.net/apps/tofarr-0g0uox60rlaq9i?q=Tofarr
- GitHub: https://github.com/Ferdinand99/tofarr

## Common questions

### What Tofa address should I enter in Tofarr?

Use the direct Tofa address, for example an HTTP URL with the host and port. Do not use the relay address.

### Where are Tofarr settings stored, and how do environment variables behave?

Saved settings live in /config. They override the environment variables, which only act as defaults.

### How can I reset a forgotten Tofarr password?

Start the container once with AUTH_RESET=true. It removes the login, so the next visit shows the create-login page again. Remove the variable afterwards.

### Does the local-network skip-login option work through a reverse proxy?

No, it never applies to requests that come through a reverse proxy. It only lets devices on private addresses such as 192.168.x.x or 10.x.x.x in without signing in.

### Which external API keys does Tofarr use?

A TMDB API key is needed for TMDB sources, and a Trakt client ID is needed for Trakt sources. A Seerr address and API key are used to request titles you do not have.

### What happens to titles that are not found in Tofa?

The Wanted page lists every title from the last run of each collection that was not found in the Tofa library. With Seerr connected, each title can show a Request button.

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