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.
Set up a server, install the apps, and start watching.
Get your tofa server running in a few minutes on Linux, macOS, Windows, or your NAS.
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.
What tofa backs up on its own, what you should copy yourself, and how a restore works when you need one.
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.
Bring your watch history and library details with you, and keep Plex connected while you switch.
Invite people by email, choose what they can see, and manage their access from one page.
Send someone an invite email so they can create their own tofa account.
Give everyone on the couch their own profile, lock the grown-up ones with a PIN, and cap what a kids profile can see.
Share one TV between people who each have their own tofa account, and switch between them without signing anyone out.
Use your GPU for transcoding. Free and on by default.
Run tofa on your Unraid server, with the right paths and permissions from the start.
Apps & devices
Take your library from the server to every screen.
Where to find the tofa apps and how your server shows up when you sign in.
Save movies and episodes on iPhone, iPad, or Android for watching without a connection.
Install tofa desktop player on a Mac, a Windows PC, or a Linux machine, and what it does that a browser tab can't.
Install the community-built Kodi add-on, and what to expect from an app we don't make ourselves.
Your library
Keep matching, metadata, and artwork in good shape.
Folder and file naming that matches correctly on the first scan.
Drop poster, background, and logo images into your folders and tofa uses them.
Which subtitle formats play, how default languages and forced subtitles behave, and why a track sometimes doesn't appear.
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.
Point a mismatched title at the right one, edit its details, and pick artwork.
Choose between movie cuts, TV editions, and different quality copies, with naming examples for each.
How people on your server suggest titles for the household library, and how you review those suggestions as the admin.
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.
Follow a franchise across films and series in story order: what you've watched, what's next, and what's still to come.
Show your libraries together by type, give some of them their own section, or show every library on its own the way Plex does.
Find something to watch: picks for you, what's trending, what's coming up, the best of every genre, and universes.
Make channels from your own library, add your TV provider or an antenna tuner, and watch with a guide, pause and recordings.
What QuickView generation does, why it takes a while on big libraries, and how to speed it up.
What FillView measures, why Zoom to Fill needs it, and when to switch it to On demand or Off.
For developers
Practical guides for tofa.
Sign your script or add-on in with the device flow, get a token, and make your first API calls against your own server.
The wire contract for synced playback rooms: every frame in both directions, who may do what, and how rooms live and die.
Follow playback sessions, scans, and library changes as they happen, instead of polling the API on a timer.
Help
Troubleshoot clearly and understand what your server is doing.
Report a problem, contact us, and find the details that help us investigate.
The three paths a stream can take from your server to your screen, what each one means for quality, and how to get the fastest one.
Reach your server at full quality through Tailscale, a Cloudflare Tunnel, or your own reverse proxy, with no port forwarding.
What Direct Play means, why a stream sometimes converts, how the Auto quality setting decides, and what your server can handle at once.
Symptom-first fixes for stutter, stalls, low quality, wrong colors, and titles that refuse to start.
Everything that has shipped recently, on the server and in the apps, newest first.
What your server sends to our services, what stays on your machine, and the settings you control.
Passkeys, two-step verification, recovery codes, and what tofa does behind the scenes to keep your account and your server yours.