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

README.md

tvcl

A simple show tracker CLI

Intro

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

Features

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

Install

$ npm install tvcl -g

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

Usage

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.