Import from Plex, Jellyfin, or Emby

tofa can import watch history, saved titles, and library details from Plex, Jellyfin, or Emby. You review what to bring over before applying it.

Imports do not copy your video files. First add your media to tofa and let the library scan finish so the import can match titles. Use media you have the right to use.

What comes over#

On server 0.10.0 or newer, the import offers these choices where your source has the data:

• Watch history and progress. Finished titles and resume positions. Plex can also provide dated watch and rewatch history.
• Saved titles. Watchlists and favorites become your tofa watchlist.
• Collections and movie playlists. Review shared library groupings before importing.
• Artwork and edited metadata. Compare artwork, keep individual images, and choose which title details to bring over.
• Personal settings. Audio and subtitle preferences and a profile picture.

Older servers offer fewer choices. Update your server if a step is missing.

Run the import#

Open your server in the web app and go to Settings, Connected Accounts, then choose Connect. You can also open /import on your server.

1. Choose a source. Pick Plex, Jellyfin, or Emby. Plex opens its sign-in page; Jellyfin and Emby ask for the old server's address and your sign-in.
2. Check the destination. Confirm which tofa profile should receive the history and saved titles. Stay on that profile until the import finishes.
3. Review the data. Work through the available steps and select what to import. Unmatched titles appear in the preview so you can check them.
4. Apply and review. Wait for each import to finish and check its result before moving to the next step. Large libraries and artwork imports can take a while.

People can import into their own profiles. Admins can also use the household import to map each person's history and saved titles to the right tofa profile, while importing shared library details once.

Keep Plex connected while you switch#

If you keep using Plex, choose ongoing sync for the data you want to keep following there. Collections and artwork can stay synced as well as watch activity. Jellyfin and Emby use a one-time import.

Manage the connection under Settings, Connected Accounts. You can pause sync, check its status, or unlink it. Unlinking stops future sync; data already imported stays in tofa. Admins can also review import connections under Integrations.

Where your sign-in goes#

Your tofa server uses the source account to read data from the old server. A continuing connection keeps its credentials encrypted on your server until you unlink it. A one-time import only needs the connection for the import session.

Plex, Jellyfin, and Emby are trademarks of their owners. tofa is not affiliated with or endorsed by them.