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.
Bring your watch history and watchlist with you, and keep them in sync while you switch.
Invite people by email, choose what they can see, and manage their access from one page.
Invite someone to try Tofa. We email them when their beta access is ready.
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.
Take movies and episodes with you on iPhone and iPad: how downloads work, what plays offline, and where the storage controls live.
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 ask for titles that aren't in the library yet, and how you review those asks 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.
Open a report and we'll take it from there. Plus what helps us fix things faster.
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.
A precise account of every connection your tofa server makes, what data is in it, what stays on your box, and how to turn things off.
Passkeys, two-step verification, recovery codes, and what tofa does behind the scenes to keep your account and your server yours.