Skip to content
Python Groff Awk
Find file
Latest commit 460394f @cockroach episoder 0.7.3

episoder is a tool to tell you about new episodes of your favourite TV shows. It does so by parsing online TV episode guides.

Currently episoder can get data from epguides and TheTVDB and tells you whenever a new episode of a show listed on one of those sites is aired.

There is also a web-based version of episoder, called webisoder.


In order to use episoder, you will need python installed on your system. In addition to the default distribution, the yaml, sqlite2, sqlalchemy and tvdb_api modules are required.


You can install episoder through pypi (using easy_install or pip) or by downloading the tarball from here and running easy_install episoder-0.7.2.tar.gz


The configuration file at ~/.episoder contains your default settings for episoder. After installing episoder man episoder will help you with the configuration.

Using episoder

To use episoder you will typically:

  • Create a cron job to have your database rebuilt once a day using episoder update
  • Add episoder to your ~/.bashrc, ~/.bash_profile, /etc/bash.bashrc or /etc/profile if you want to see your upcoming shows every time you start a shell. Consult your shell's documentation to find out which file you want to use.
Something went wrong with that request. Please try again.