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.
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 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.
What QuickView generation does, why it takes a while on big libraries, and how to speed it up.
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.
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.