v2.3.0

What's new

• --box-wait <minutes> lets a save wait for a box that stops answering, for example after standby or a restart. While it waits, fetchtv starts no new recordings and checks the box at 5, 10, and 20 seconds, then every 30 seconds. When the box answers, each recording carries on from its .part file, and the wait does not use up its retries. If the box does not answer in time, the remaining recordings fail with box-unreachable. The default is 0, which keeps the old behaviour.
• Saving again no longer copies a recording a second time when its file name changed (for example after switching on Plex names). A half-saved recording carries on under its new name.
• A save that stalls because the box went quiet now tries again after 60 seconds, and Stop works at once.
• A show the box says no longer exists is skipped at once, instead of being retried for about 10 seconds.

Upgrading

• A download now gives up on connecting after 10 seconds, even with --box-wait at 0. Before, a box that did not answer could hold a connection attempt for as long as the operating system allowed. The retries stay the same.

API

• saveRecordings takes boxWaitMs (default 0), connectTimeout (default 10000), onBoxState({ state }) with lost, back, or gave-up, and onRetry({ id, attempt, of }). If onBoxState or onRetry throws, the save carries on.
• downloadFile takes connectTimeout (default 10000).
• New exports: BOX_STATE and BOX_UNREACHABLE ('box-unreachable').
• planSaves and copyAgain are new in this release.