Armangil's vodcatcher is a video podcast (or vodcast) client for the command line. It provides several download strategies (new shows only, back-catalog allowed, etc), supports BitTorrent, offers cache management, and generates playlists for video player applications. It is written in Ruby, and runs on Linux (tested), Windows, MacOS and many other operating systems.

To watch video podcasts, simply type something like vodcatcher subscriptions.opml > latest.m3u. This will download the subscribed shows into the current directory and generate an M3U playlist named latest.m3u.

This application accepts one or more feeds (RSS or Atom) or subscription lists (OPML or iTunes PCAST) as argument, in the form of URLs or filenames. Alternatively, it tries to read one such document from the standard input.

For help, use vodcatcher -h.

Merging with Armangil's podcatcher 23 Dec 2006, 9:48

As of version 2.0.0, Armangil's podcatcher is capable of downloading any type of content, including video. For example, podcatcher --content '^video/' downloads video content from

As a result, Armangil's vodcatcher, which is a clone of Armangil's podcatcher specialized in video, no longer has a reason of being. Version 1.3.3 is the last release of this software. For newer versions, please see Armangil's podcatcher.

Version 1.3.3 released 12 Jan 2006, 24:15

This release includes a major new feature: search. This function generates a subscription list by querying a set of subscription lists/feeds. Here are some usage examples:

The search function can safely be interrupted (through Control-C keystrokes on Linux): it still generates a valid subscription list.

This release also adds support for the XSPF playlist format, and adds the -p option for assigning a separate cache subfolder to each feed.

Version 1.2.0 released 6 Nov 2005, 17:22

This release includes many feature enhancements and a minor bug fix. Changes:

Vodcast test for videoblogs 3 Sep 2005, 18:34

Some videoblogs do not qualify as vodcasts, and vodcast clients such as Armangil's vodcatcher cannot handle them. Here is a quick (and geeky) test to determine whether a videoblog is a vodcast:

  1. Does the videoblog have an RSS or Atom feed?
  2. Does the feed list video files as enclosures? (i.e. does it contain elements such as <enclosure url="" length="2144275" type="video/quicktime" /> or <link rel="enclosure" href="" length="2144275" type="video/quicktime" />)

If the answer to both questions is yes, then the videoblog is a vodcast.

Finding vodcasts 3 Sep 2005, 17:57

Armangil's vodcatcher answers the question: "How do I receive vodcasts?". The next question is: "Where do I find vodcasts?". Here are some options:

Version 1.1.0 released 30 Aug 2005, 15:30

The initial release is available here. This software uses the code base of Armangil's podcatcher, which has been in development for almost a year now. As a result, this first release is already stable and feature-rich.

Credits: Thingamablog 1.0b3, Movablestyle
user@pc:~> vodcatcher -d ~/vodcasts -t asx feeds.opml > latest.asx
user@pc:~> cat latest.asx
<asx version = "3.0">
<ref href='/home/user/vodcasts/cache/rb_05_aug_26.wmv' />