Documentation
API reference

Start here

Search every guideesc close

Versions

Editions, 4K, and 1080p

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

3 min read

Collectors end up with several files of the same movie: a 4K and a 1080p copy, a Theatrical and an Extended cut. tofa shows them as one title with one poster, and a picker for the rest.

4K and 1080p side by side#

Keep both files and tofa merges them into one title automatically; the naming guide covers the file layout, including 4K in its own library.

Keeping a 1080p copy next to your 4K is genuinely useful, not hoarding:

  • Devices. Not every screen plays HEVC or HDR. The 1080p file direct plays almost everywhere, so your server doesn't have to transcode the 4K down for the one old TV in the house.
  • Away from home. A 4K stream rarely fits through a remote connection, and never through the relay cap. With a 1080p version on hand, remote viewers get a clean direct play instead of a heavy live transcode.
  • Transcoding cost. Converting 4K HDR on the fly is the most expensive thing a media server does. A 1080p copy means it usually doesn't have to.

Which one plays#

You don't normally choose. For each device, tofa picks the best version it can play directly, looking at codec support, HDR and Dolby Vision capability, and available bandwidth. A 4K HDR TV gets the 4K file; a laptop on hotel Wi-Fi gets the 1080p.

To override it, use the version picker on the title page. Versions are labeled by tier (4K, HD, SD) with a separate chip for HDR or Dolby Vision.

You can also cap a person's quality: on the Users page, set Max quality for anyone you've invited, and they're never served more than that.

Editions#

An edition is a different cut of the film: Director's Cut, Extended, Theatrical, Unrated. Tag the file (or its folder) the way Plex, Jellyfin, and Radarr do:

Blade Runner (1982) {edition-Final Cut}.mkv

For movies, tofa also recognizes common edition wording after the year without the tag, like Blade Runner (1982) Final Cut.mkv. It understands Director's Cut, Extended, Theatrical, Unrated, Remastered, IMAX, Criterion, and friends. For TV, only the explicit {edition-...} tag counts.

When a title has more than one edition, the picker grows an Edition row above the quality row, so "4K Extended" and "1080p Theatrical" stay distinct choices. An edition set by hand sticks; one detected from the filename updates if you rename the file and rescan.

TV editions: one picker or separate shows#

To choose between editions within one show, put the {edition-...} tag on each episode filename and keep both copies under the same show folder:

Shows/
  Spider-Noir (2026)/
    Season 01/
      Spider-Noir S01E01 {edition-Colour}.mkv
      Spider-Noir S01E01 {edition-Black and White}.mkv

Repeat the naming for each episode, then run a library scan. The web title page's Edition picker lets you choose which edition to play. TV edition names need the explicit tag; plain words such as "Colour" in the filename are not enough.

If you prefer separate show listings, put the tag on the show folder instead, above the season folders:

Shows/
  Spider-Noir (2026) {edition-Colour}/
    Season 01/
      Spider-Noir S01E01.mkv
  Spider-Noir (2026) {edition-Black and White}/
    Season 01/
      Spider-Noir S01E01.mkv

After a full library scan, these appear as two shows, each with its own watched state. Choose this layout if you want to track watching each edition separately.

One resume position per title#

Watch progress belongs to the title, not the file. Pause the 1080p downstairs and the 4K upstairs resumes in the right place. That's also true across editions, so if you switch between cuts of different lengths mid-watch, expect the resume point to land approximately, not exactly.

The separate TV show listings described above each keep their own progress.