Documentation
API reference

Start here

Search every guideesc close

Documentation

Run your own tofa server.

Set up your server, install the apps, and find help when you need it.

Get started

Install your server and get the foundations right.

12 guides
Guide 01 2 min
Welcome to tofa

Set up a server, install the apps, and start watching.

Open guide
Guide 02 15 min
Run your tofa server

Get your tofa server running in a few minutes on Linux, macOS, Windows, or your NAS.

Open guide
Guide 03 4 min
Keep your server up to date

How your server learns about new releases, how to apply them per install method, and how to get back to a good state if an update misbehaves.

Open guide
Guide 04 4 min
Back up your server

What tofa backs up on its own, what you should copy yourself, and how a restore works when you need one.

Open guide
Guide 05 5 min
Use your own PostgreSQL

Point tofa at a PostgreSQL server you already run instead of the bundled database: what it needs, how to set it up, and what changes.

Open guide
Guide 06 3 min
Import from Plex, Jellyfin, or Emby

Bring your watch history and library details with you, and keep Plex connected while you switch.

Open guide
Guide 07 3 min
Share your server with family and friends

Invite people by email, choose what they can see, and manage their access from one page.

Open guide
Guide 08 2 min
Tell a friend about tofa

Send someone an invite email so they can create their own tofa account.

Open guide
Guide 09 4 min
Profiles and parental controls

Give everyone on the couch their own profile, lock the grown-up ones with a PIN, and cap what a kids profile can see.

Open guide
Guide 10 4 min
Household viewing

Share one TV between people who each have their own tofa account, and switch between them without signing anyone out.

Open guide
Guide 11 7 min
Hardware transcoding

Use your GPU for transcoding. Free and on by default.

Open guide
Guide 12 6 min
Install on Unraid

Run tofa on your Unraid server, with the right paths and permissions from the start.

Open guide

Apps & devices

Take your library from the server to every screen.

4 guides

Your library

Keep matching, metadata, and artwork in good shape.

14 guides
Guide 17 4 min
Name your media files

Folder and file naming that matches correctly on the first scan.

Open guide
Guide 18 2 min
Add your own artwork

Drop poster, background, and logo images into your folders and tofa uses them.

Open guide
Guide 19 4 min
Subtitles

Which subtitle formats play, how default languages and forced subtitles behave, and why a track sometimes doesn't appear.

Open guide
Guide 20 3 min
Move your media to a new drive

Point a library folder at its new location, after a drive swap or a restore from backup, and keep every match, poster and watch history.

Open guide
Guide 21 2 min
Fix a wrong match

Point a mismatched title at the right one, edit its details, and pick artwork.

Open guide
Guide 22 3 min
Editions, 4K, and 1080p

Choose between movie cuts, TV editions, and different quality copies, with naming examples for each.

Open guide
Guide 23 3 min
Request titles

How people on your server suggest titles for the household library, and how you review those suggestions as the admin.

Open guide
Guide 24 4 min
Clean up your library

Lifecycle rules flag titles nobody is watching, show everyone what is leaving soon, and, only if you allow it, free the disk space after a grace period.

Open guide
Guide 25 4 min
Universes

Follow a franchise across films and series in story order: what you've watched, what's next, and what's still to come.

Open guide
Guide 26 3 min
Organize Browse

Show your libraries together by type, give some of them their own section, or show every library on its own the way Plex does.

Open guide
Guide 27 4 min
Discover

Find something to watch: picks for you, what's trending, what's coming up, the best of every genre, and universes.

Open guide
Guide 28 11 min
Live TV

Make channels from your own library, add your TV provider or an antenna tuner, and watch with a guide, pause and recordings.

Open guide
Guide 29 6 min
Preview thumbnails

What QuickView generation does, why it takes a while on big libraries, and how to speed it up.

Open guide
Guide 30 2 min
FillView and Zoom to Fill

What FillView measures, why Zoom to Fill needs it, and when to switch it to On demand or Off.

Open guide

For developers

Practical guides for tofa.

3 guides

Help

Troubleshoot clearly and understand what your server is doing.

8 guides