org-tvdb - keep track of tvshows in orgmode

What does this do?

This package lets you track tv shows that you watch. It gets the information about episodes from the TVDB. Each show, season and episode is represented by a headline. Whether an episode has aired and whether you have already watched it, is tracked by the TODO status.

This screenshot shows how it looks in practice.

Installation and configuration

Either clone this repo and add the folder to your load path or install from melpa (not yet available). Then

(require 'org-tvdb)

or rely on the autoloads. You also have to give org-tvdb a valid api key for the TVDB API. This is done by setting org-tvdb-api-key either through custom or with setq.

You can of course also use use-package.

(use-package org-tvdb
     :ensure nil ; remove this if available through melpa
     :custom (org-tvdb-api-key "your-api-key")
     :commands (org-tvdb-insert-todo-list
                org-tvdb-add-season
                org-tvdb-add-series
                org-tvdb-mark-series-watched
                org-tvdb-mark-season-watched
                org-tvdb-update-series
                org-tvdb-update-season))

Usage

org-tvdb gives you the following commands to work with series in an org-mode buffer.

• org-tvdb-insert-todo-list: Insert #+TODO option with released, unreleased and watched TODO status
• org-tvdb-add-series: Add a new series at point.
• org-tvdb-add-season: Add a new season to the series at point.
• org-tvdb-update-series: Update series at point.
• org-tvdb-update-season: Update season at point.
• org-tvdb-mark-series-watched: Mark the series at point watched by changing the TODO status.
• org-tvdb-mark-season-watched: Mark the season at point watched by changing the TODO status.
• org-tvdb-released-tree: Create sparse tree with released but not watched episodes.

  The idea is that you track tv series by adding them to an org file and marking episodes as watched as you watch them. org-tvdb-released-tree or org-tvdb-agenda-command can then be used to view a list of episodes that are available but have not yet been watched.

  org-tvdb-agenda-command is a custom agenda command that can be used to view unwatched episodes in Org Agenda. To use it, you need at least to adjust the paths to your org files with tv series in them.