tvcmd

 tvcmd

command line tool to keep track of tv shows episodes

View project onGitHub

What is it?

Tvcmd is a command line interface (CLI) to keep track of tv shows episodes. It has a functionality similar to websites such as myepisodes.com followmy.tv or mytvshows.org but for the command line. Tvcmd features the following commands:

  • update: updates the list of episodes from the configured source
  • new/adquire/see: change the state of episodes from new -> adquired -> seen
  • ls: shows the current state of episodes, can be filtered by status
  • format: pretty print the list of new episodes, useful to automatically find torrents
  • save: saves the episode list and their state

Install

archlinux

archlinux users can easily install the packages: tvcmd or tvcmd-git both available at the aur

others

run the setup.py script included in the bundles:

$ ./setup.py 

Configure and Run

configuration file

the main configuration is located here: $XDG_CONFIG_HOME/tvcmd/main.cfg create this file with a list of the shows you want to keep track of, something like this:

[general]
shows = an_idiot_abroad, how_i_met_your_mother, through_the_wormhole, community
source = thetvdb
formats =
https://torrentz.eu/verified?f=${show+}+s${season}e${episode},
http://fenopy.se/search/${show+}+s${season}e${episode}.html

shell mode

tvcmd is a shell-like command interpreter, the shell can be brought up by running tvcmd with no parameters:

$ tvcmd 

command mode

optionally you can execute single commands with the -e parameter:

$ tvcmd -e "adquire lost.s01e*"