Skip to content
A simple show tracker CLI
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
img Update image Jun 9, 2019
.eslintrc.json Get rid of yarn Nov 10, 2018
LICENSE Initial commit Jul 15, 2015


A simple show tracker CLI


This small tool is a CLI for API. It allows to track tv shows you follow and the episodes you didn't watch yet.


  • Lookup for shows
  • Viewing episodes titles, air dates, overview, and more
  • Marking episodes as wacthed
  • Showing episodes you didn't watch yet


$ npm install tvcl -g

tvcl uses the API. In order to use it you should get an API key and put it into THETVDB_API_KEY environment variable.


Lookup the series title:

$ tv lookup the simpsons

(you can use search alias)

Add the series to local database by id:

$ tv add {id}

List added series:

$ tv list

View the list of episodes for specified series (--wo stands for "with overview"):

$ tv view {series_id} --wo

(you can use show alias)

Mark episode as watched:

$ tv watch {epid}

Mark all episodes till the specified as watched:

$ tv watch-till {epid}

(you can use wt alias)

Show the not-watched-yet episoded:

$ tv remained

or just

$ tv
You can’t perform that action at this time.