fetchtv-cli

A CLI tool to download recordings from Fetch TV boxes using UPnP.

This is a fork of the original project called FetchTV-Helpers.

Introduction

This tool allows you to download recordings from Fetch TV boxes.

It can also be used to query recording information on the Fetch TV box.

Installation

The recommended way to install fetchtv-cli is to use pipx.

After getting pipx installed, simply run:

pipx install fetchtv-cli

Please don't use pip system-wide.

You can of course also install it using classic virtualenvs.

Features

• Autodiscover Fetch TV DLNA box
• View box information
• List all recordings, or matches for specified shows or titles
• Save only new recordings, or save everything that matches shows or titles
• Get responses as JSON. This includes additional item attributes, e.g. file size, duration, type (episode or movie), description
• List recordings in a pretty table view

Notes/quirks

It seems that Fetch do not reveal if a recording is deleted (actually only marked for deletion), via the DLNA returned.

I've scoured the XML, tried different filters etc -- nothing works. They must be keeping that flag in a different database, of which the status isn't reflected in the XML/DLNA. This means that you'll see all recordings on the box, deleted or not, and if the state JSON goes missing, will probably be re-downloaded in certain situations.

Usage

fetchtv [COMMANDS] [OPTIONS]

Examples

• Display Fetch box details

  fetchtv --info
  

• List all available recorded shows (doesn't include episodes)

  fetchtv --recordings --ip 192.168.1.10 --shows
  

• List only recordings that haven't been saved

  fetchtv --recordings --new --ip 192.168.1.10
  

• Return responses as JSON

  fetchtv --recordings --json --ip 192.168.1.10
  

• List all available recorded items (all shows and episodes) in the default table view

  fetchtv --recordings --ip 192.168.1.10
  

• List all available recorded items (all shows and episodes) in a flatter view

  fetchtv --recordings --ip 192.168.1.10 --no-table
  

• Save any new recordings to C:\Temp

  fetchtv --recordings --ip 192.168.1.10 --save "C:\\temp"
  

• Save any new recordings to /tmp

  fetchtv --recordings --ip 192.168.1.10 --save /tmp
  

• Save any new recordings to C:\Temp apart from 60 Minutes

  fetchtv --recordings --ip 192.168.1.10--save "C:\\temp" --exclude "60 Minutes"
  

• Save any new episodes for the show 60 Minutes to C:\Temp

  fetchtv --recordings --ip 192.168.1.10 --folder "60 Minutes" --save "C:\\temp"
  

• Save episode containing 'S4 E12' for the show 60 Minutes to C:\Temp

  fetchtv --recordings --ip 192.168.1.10 --overwrite --folder "60 Minutes" --title "S4 E12" --save "C:\\temp"
  

• Save episode containing 'S4 E12' or 'S4 E13' for the show 60 Minutes to C:\Temp

  fetchtv --recordings --ip 192.168.1.10 --overwrite --folder "60 Minutes" --title "S4 E12, S4 E13" --save "C:\\temp"
  

• List anything currently recording

  fetchtv --isrecording --ip 192.168.1.10
  

Commands

Options