Skip to main content

TV episode notifier

Project description



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 which can be used for free at


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


The official website, bug tracker etc. for episoder can be found at


You can install episoder through pypi (using easy_install or pip) or by running from the downloaded and extracted tarball.


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

Using episoder

To use episoder you will typically:

  • Create a cron job to update your database 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 to use.
  • Or run episoder notify at regular intervals to get notifications by e-mail.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

episoder-0.10.1.tar.gz (37.9 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page