tomaccosheep edited this page Jan 5, 2013 · 3 revisions

Hpodder FAQ

Here are answers to some of the most frequently asked questions about hpodder.

Basic Hpodder Startup

How do I start using hpodder?

Do the following steps:

  1. Download and install hpodder
  2. Find a couple podcasts’ URL feeds that you’d like to hear
  3. Add those podcast’s URL to hpodder’s cast database, see either other FAQ, or read the hpodder user manual on how to do this
  4. Run hpodder update to load episode information.
  5. Run hpodder catchup — this initially updates your episodes database by querying your new podcasts regarding each episode’s status and then saves the information that it retrieves. Basically it enters each CASTID and episode’s number with a status. The status is marked according to these rules:
    • Set all episodes except the most recent status to = “Skipped”. This will prevent older episodes from being downloaded.
    • The most recent episode statuses are set to “Pending”, which makes them available for download the next time.
  6. Run hpodder download to download your podcasts.
  7. Whenever you want to download new episodes, just run hpodder

Hpodder Functions

How do I add a podcast to hpodder?

  1. First, you need to find the URL for your particular podcast. Looks for such notes as “RSS Feed”, subscription, etc. Copy that URL to your clipboard.
  2. Then, go to a terminal and execute command hpodder add URL — put the URL you copied after the “add”. hpodder will then assign a specific castid number to the podcast URL to the podcast.

The title of the new podcast will appear after the next update.

What hpodder help and documentation is available?

There are many sources of information:

  • The manpage, which you can access on Linux/Unix systems with man hpodder. This is the hpodder manual. You can also view it online in PDF or HTML versions.
  • You can get general help by running hpodder --help
  • You can see a list of available hpodder commands by running hpodder lscommands
  • For each command, you can run hpodder command --help for help on that specific command
  • This FAQ

How can I find out which podcasts hpodder will use for downloading?

Run hpodder lscasts. All podcasts are listed, and any disabled podcasts are marked.

How can I help the hpodder project?

Several ways. You can:

  • Contribute code; see the hpodder homepage
  • Contribute to the hpodder wiki, FAQ, or manual
  • Help with bug reports

How can I configure hpodder?

There is a configuration file for hpodder, normally stored in ~/.hpodder/hpodder.conf. The manpage discusses this file in detail.

How do I change an episode’s status?

Use hpodder setstatus. For example, to change podcast 10’s episode 20 and 22 to Skipped, here’s the command:

hpodder setstatus -c 10 -s Skipped 20 22

Valid status states, case sensitive, are: Pending, Downloaded, Error or Skipped. Further information is located in the hpodder manual.

Does hpodder work on “X” format podcasts?

hpodder will download download those files called out by the podcast’s feed file information, typically mp3 or ogg files. However, is not limited to those file formats.

I want hpodder to make a file listing all my podcasts or episodes. How can I do this?

A couple way to make such a file are:

  • Cast file command: hpodder lscasts |sort -g > ~/mycast.txt This creates a text file of your hpodder casts, sorted by their numerical number.
  • General episode file command: hpodder lseps > ~/myeps.txt This creates a text file list of all episodes, sorted by podcast CASTID.
  • Specific podcast (for example podcast 10) episode file command: hpodder lseps 10 > /mycast10eps.txt This creates a text file of your podcast 10 episodes.

You can also add -l to lseps or lscasts to include URLs.

What does the hpodder command actually do?

First time you execute this command, it executes the new user setup process. This process asks you 2 basic questions, your answers are then place in the hpodder configuration file. But normally, it is totally equivalent to executing

  1. hpodder update, followed by
  2. hpodder download.

It is also identical to executing hpodder fetch

How do use hpodder to download podcasts that require a username and password?

The short answer is, you must use a curlrc file to tell libcurl to get passwords from a .netrc file. For more information, check out this page: Authenticated Podcasts

How can I import an OPML file?

While they cannot be directly imported, you can get a list of the sources in the OPML file with the command

for i in `awk '{ FS = "xmlUrl=\"|\"/>"; print $2; }' file.opml`; do echo $i; done

and you can add every source with the command

for i in `awk '{ FS = "xmlUrl=\"|\"/>"; print $2; }' file.opml`; do hpodder add $i; done


Add yourself here if you edited the FAQ, if you like.

Thanks to Frank Russell for the initial FAQ.