Repository navigation
v2.7.0
A bug hunt and security pass across the whole app: about 120 fixes, each with a test that failed on the old code.
Recording and series
- Series recordings now record only the show they name: "The Chase" no longer records "The Chase Australia" or "Beat The Chase". Titles with a colon, a dash, or a bracket after the name still record.
- Automatic show folders no longer collect longer titles of other shows. New "Australian Survivor" recordings get their own folder instead of going into "Survivor".
- A paused series no longer shows expected episodes in Scheduled.
- Skipping and then re-recording a series episode keeps its padding, and pressing Record twice no longer risks a second timer.
- A repeat you record by hand is no longer turned off as a duplicate.
- Cancel series finishes even after a partial failure.
Imports and removal
- Remove after import tries again at the next sync when a removal was skipped or failed, and never removes a recording while it plays.
- A failed import shows as FAILED with the error, and the next sync tries again. Before, it stayed on Importing for ever.
- If a library folder is empty while your imported recordings point into it (for example, a NAS share that was not mounted), syncs import nothing into it and remove nothing from TVHeadend. Health warns.
- Freetvarr reads TVHeadend's full finished list, so libraries with more than 5,000 finished recordings import completely.
- A recording you clear from the log while TVHeadend still has it comes back on the next sync, with its picture.
- New recordings without an episode number are dated by the local air day.
- Settings refuses library folders that sit inside each other.
Watching
- An episode no longer shows as watched when playback stopped part-way, and episodes with ads cut count as watched at the end.
- Resume after ads are cut starts at the same moment in the programme.
- Switching channel no longer says the NAS is already playing a stream while the old one shuts down.
- A new channel, recording, or From the start on the same phone or browser ends that device's kept stream, unless someone else watches it or it plays in Picture in Picture.
- From the start survives a phone lock, and a few seconds of network loss no longer ends live TV.
Library, Plex, and For you
- Films you recorded or opened are no longer treated as series.
- Pictures, scores, and cast no longer go blank after a refresh, and a series no longer shows a same-named film's Plex poster.
- Large Plex libraries (over 20,000 items) keep their watched state; watched sync no longer stalls on a moved item.
- Turning Fewer like this off now works; those shows appear in Hidden shows, where Show again brings them back. Not interested and thumbs are kept while history is paused.
- Deletes work with a large Radarr library.
Settings, setup, and Health
- Errors say what happened: "Could not reach Freetvarr" for a lost connection, and a plain message instead of "HTTP 429".
- If Settings fails to load, it says so and offers Try again instead of showing blank fields.
- New Health checks: Library folders, Series recordings, and a warning when the TV guide stops updating because Freetvarr's address changed.
- The update drawer's backup command works with a custom CONFIG_PATH and without a .env file.
Security
- Freetvarr now sends a saved TVHeadend password, Plex token, or Sonarr or Radarr API key only to the address it was saved with. Auto-detect token no longer returns the token.
- File names from TVHeadend cannot point outside the recordings folder, and image routes serve only raster pictures (SVG logos are converted).
- The database file is readable by its owner only, and GitHub Actions are pinned to exact versions.
What changes for existing installs
- Database changes
0041and0042run on first start. To go back without a backup, see Updating → Go back without a backup. - On first start, Freetvarr changes the titles of the series recordings it made to the whole-title form. TVHeadend then drops timers for longer titles that contain the show title; they come back when the guide uses the show title, or press Record on the airing. The log lists each one.
- Changed series rules make their timers again, so a padding change on a single episode goes back to the rule's padding.
- The first sync marks recordings TVHeadend already removed itself.
- If you edit a TVHeadend, Plex, Sonarr, or Radarr address, enter its password, token, or API key again in the same save. A detected Plex token works only with a Plex server on the same computer.
- Saving a library folder that does not exist, or a system folder, now shows an error.
- Clearing the movies folder leaves films already filed where they are; new films go to
MOVIES_ROOT.