Skip to content

v2.0.0

Choose a tag to compare

@furey furey released this 30 Oct 04:32
· 852 commits to main since this release

Freetvarr 2.0 redesigns the app around five destinations: Home, Live TV, TV guide, Recordings, and Settings. Your recordings, series rules, folders, settings, and sync history carry over. The docs at https://furey.github.io/freetvarr/ describe every part of it.

Important


Before you upgrade, stop Freetvarr and back up the whole Freetvarr config folder. Read Before you upgrade: on its first start, 2.0 moves some recorded files between your one-off folder and your TV folder.

Highlights

  • Home: highlight slides, New recordings, On now, Recording tonight, and For you suggestions made on your own computer from what you record and watch.
  • Recordings: a Library of posters with a page for each show, and Scheduled, with the week's recordings and a timeline of what each tuner records.
  • Shows, one-offs, and movies: one rule decides the shelf and the folder of each title. Move to Shows, Move to One-offs, Merge into another show…, and Not a movie / This is a movie correct it, and Freetvarr moves the files to match.
  • Player: one full-screen player for live TV and recordings, with Start over (including From the start while a programme records), the Miniplayer, picture in picture, and Multiview with up to four live channels (two on a phone).
  • Plex watched state, both ways: what you watch in Plex shows as watched in Freetvarr, with its resume point, and what you watch in Freetvarr shows as watched in Plex.
  • Your whole Plex library: Recordings also lists the episodes and films in your Plex TV and Movies libraries, such as what Sonarr or Radarr downloaded, and plays them.
  • Sonarr and Radarr: when you delete a file that Sonarr or Radarr downloaded, Freetvarr asks it to stop monitoring the file and to delete it, so it does not download again.
  • Activity: Settings → System → Activity shows what the server is doing now (syncs, imports, ad removal, library folder moves, and background jobs), with steps and logs, beside the sync history.
  • TV guide: a Watchlist for shows not in the guide yet, ratings, reviews, classification, and cast with photos, and record wording that fits a movie, a one-off, or a series.
  • Settings: grouped as About, Watching, Recording, System, and Danger zone, with Search settings and a System diagram.

Before you upgrade

Back up the whole Freetvarr config folder (config/freetvarr in the default layout), with Freetvarr stopped. Freetvarr 2.0 keeps its SQLite database in write-ahead log mode, so a backup must include state.db-wal and state.db-shm beside state.db. A copy of state.db alone can miss recent changes.

Then update as usual:

docker compose pull
docker compose up -d

What changes for existing installs

  • Database migrations: the first start runs 30 new migrations (0007 to 0036). Freetvarr 1.x does not start on the upgraded database, so keep your backup if you might go back.

  • Files move once at startup: Freetvarr sorts every title as a show, a one-off, or a movie with the new rules, then moves the files once to match, in the background, about 3 minutes after the first start. Recordings that the TV guide numbers as episodes (such as a series filed with the year as its season), or that recorded on two or more days, move from the one-off folder into the TV folder and get a show folder. A one-off filed in the TV folder moves to the one-off folder. A move never overwrites an existing file; Freetvarr skips it and lists it in Activity under Library folders. Plex refreshes after the moves. After that, Freetvarr checks again after each sync and when you change a shelf.

  • Plex watched sync is on: if Plex is set up, From Plex and Back to Plex are both on, for the Plex account that owns the token. Your Plex watched marks change when you watch in Freetvarr. Turn either off in Settings → Recording → Plex.

  • Your whole Plex library is on: Recordings lists your Plex TV and Movies libraries alongside your recordings. Deleting one of those files from Freetvarr deletes it through Sonarr or Radarr, or from the disk when no app manages it, after a dialog that lists each file. Turn it off in Settings → Recording → Plex → Show your whole Plex library.

  • TV file names: new TV episodes no longer carry a guide episode title that only repeats the number, such as Episode 3 of Season 2. Files already imported keep their names.

  • Imports never overwrite: when a file of the same name already exists and Freetvarr does not own it, the import saves the episode under a copy name, such as Show - S01E02 - copy 2.ts. Deleting an episode keeps a library file that another recording also uses.

  • Series rule titles are escaped: a new series recording made from a TV guide title saves the title with regular-expression characters escaped, so it matches only that title in TVHeadend. Existing series rules stay as they are. A hand-typed regular expression with nested or unbounded repeats still records in TVHeadend, but Freetvarr no longer shows it as matched.

  • Episodes deleted outside Freetvarr are hidden: when an episode's library file is gone (deleted in Plex, a file manager, or by hand), it leaves the Library. The Recording log keeps it.

  • Live streams at once (Settings → Watching → Playback): Freetvarr measures the computer at startup and sets the default from the result. LIVE_TV_MAX_SESSIONS, when set, is the upper limit and the default. A Docker compose file from before 2.0.0 sets it to 2, so to let the measurement decide, change ${LIVE_TV_MAX_SESSIONS:-2} to ${LIVE_TV_MAX_SESSIONS:-} in your docker-compose.yml, then run docker compose up -d.

  • Sonarr and Radarr mounts (optional): to let Freetvarr read their API keys, set SONARR_CONFIG_PATH and RADARR_CONFIG_PATH in .env, and add the environment and volume lines from docker-compose.example.yml to your docker-compose.yml. The install script keeps an existing Docker compose file, so it does not add them. Without the mounts, paste each API key in Settings → Recording → Sonarr and Radarr. The same file now also passes TVH_URL, MOVIES_ROOT, and LIVE_TV_VAAPI_DEVICE from .env; copy those lines too if you use them.

  • Series folders: a series recording with no folder gets a show folder in your TV library on its next import, and Series rules shows that folder before it exists. Unassign folder is gone from series, because the next import made the folder again. To save a series to the one-off folder, choose Move to One-offs in its ⋯ menu in Recordings.

  • Old addresses: bookmarks to the old tabs (#/dashboard, #/series, #/syncs, #/doctor, filtered #/recordings) open the new pages.

Docs