WP-iPodCatter: WordPress iTunes Podcast Directory Plugin

The WP-iPodCatter plugin help podcasters running WordPress create a valid feed for iTunes’ podcast directory and specify the itunes:duration and itunes:explicit tags on a per-episodes basis.

Download WP-iPodCatter 14 February 20067

Like the WP-iPodCatter? Say thanks and support its continued development via paypal

How To Use WP-iPodCatter

  1. Upload the contents of wp-content/plugins to your plugins folder and replacement rss file to your wordpress root.
  2. Activate the plugin.
  3. Set your iTunes tags in the Options -> WP-iPodCatter panel.

WP-iPodCatter is released under the GNU General Public License.

Version History
14 February 2007
Changed how databases are accessed to comply with a change in future WordPress versions.

06 November 2006
Added Zeug’s layout improvement

01 July 2006
Updated to reflect changes to iTunes directory categorization.

09 March 2006
This version is a patch graciously offered by Bruce Moyle, “The patch corrects the use of invalid characters in the itunes tags and also the subtitle length issue (which is still there in the latest version).”

1.6 (Released 23 January 2006)
– itunes:keywords now separated with commas
– itunes:subtitle now limited to 254 characters
– itunes:summary is now limited to 4000 characters, thanks Ashley

1.5.1 (Released 8 January 2006)
– Compatible with WordPress 2.0
– Solved a problem where keywords and durations wouldn’t be saved correctly
– Removed automatic duration detection and shipping without getid3 library cause it was giving me a headache

1.5 (Released 17 December 2005)
– Updated to support the revised iTunes Podcast Spec (deprecated support for itunes:category at the item level – blah!)
– Duplicate itunes:duration custom field bug solved (fingers-crossed)
– Fixed some issues with ampersands and other characters not escaping correctly
– Extra special thanks to Christian Wach for pulling this revision together. It wouldn’t exist without him. Chris, did I miss anything?

1.0 (Released 31 August 2005)
– All variables from the replacement wp-rss2.php file moved into the WP-iPodCatter section in WordPress admin Options tab.
– Updated wp-rss2.php file
– Support for itunes:block at an individual post level
– Support for Channel level category
– iTunes’ categories are now listed in the plugin
– Support for itunes subcategories
– Support for itunes:explicit at overall podcast level and individual post level
– Enter itunes:keywords manually or use wordpress categories
– Preview cover images within WordPress admin area.
– Turn your comments feed into a podcast using the replacement wp-commentsrss2.php file
– Automatically detects duration better

0.7.5 (Released 14 July 2005)
– Bug fix. “Works much better! ” – Chuck from ChuckChat

0.7 (Released 07 July 2005)
– Added support for itunes:duration tag, both manual entry and automatic detection.

0.5 (Released 06 July 2005)
– Hello World

85 comments for “WP-iPodCatter: WordPress iTunes Podcast Directory Plugin

  1. tim
    July 6, 2005 at 6:13 pm

    if you did duration and per-show explicit tags as well I’d love you long time!

    Would be nice to have text boxes for the other categories.

    But hey I’m not listed after 6 days so may never be anyway!

  2. July 6, 2005 at 8:25 pm

    Tim, you’re in luck. WP-iPodCatter supports per-show explicit tags right now. I’m investigating duration right now.

  3. Nate Friedman
    July 10, 2005 at 3:54 am

    when i use your plugin, i get a…

    Fatal error: Call to undefined function: str_ireplace() in /Websites/pms/php/blog/wp-content/plugins/wp-ipodcatter.php on line 81

    right after my enclosuer… help!

  4. July 10, 2005 at 7:35 am

    str_ireplace is a php 5-only function. Try changing str_ireplace to str_replace (remove the ‘i’) and let me know if that works for you.

  5. Nate Friedman
    July 10, 2005 at 10:13 am

    yeah, i don’t know what happened, I moved your RSS file back in and everything worked fine…

    maybe i forgot to enable the plugin?

    i dunno…

  6. July 11, 2005 at 12:47 pm

    I’m getting this error when trying to submit my podcast to iTunes:

    Error parsing feed: Invalid XML: Error on line 96: XML document structures must start and end withing the same entity.

    Does it matter that I renamed wp-rss2.php to wp-itunes-rss2.php?

  7. July 13, 2005 at 5:33 am

    Yep, I’m getting the same problem:

    The following tags were not closed: rss, channel, item. Error processing resource ‘http://yama.theoldergamers.com/wordpress…

    Here is the link to the rss file:

    Any hints?

  8. August 1, 2005 at 2:36 pm

    Just installed the latest version on Friday, but even though I mark my posting a “NOT EXPLICIT”, the feed still shows Yes in the explicit field. Is this a bug that has been reported already..?


  9. August 2, 2005 at 12:20 pm

    I’m running WP 1.5.

    I had to revert back to the stock WP wp-rss2.php: after installing the iPodCatter wp-rss2.php file, nobody’s reader — even the permissive NetNewsWire nor Firefox’s Feedview extension — could read the feed.


    Maybe I’m not doing it right, I don’t know. … or maybe there’s something about WP 1.5 as opposed to later versions?

    Where should troubleshooting start?

    Anyway, I thank you for all the effort you have already put into iPodCatter, which is needed!

    A U S T I N ,

    Cinema Minima

  10. Larry Kluger
    August 5, 2005 at 12:15 pm

    Hi Garrick,
    Are you still actively working on the plugin? If not, I’m planning to update the plugin as follows:

    1) Enable setting of “channel-level” parameters via the Admin’s ‘Options’ menu page.
    Each would get a text box, description, etc.
    This would include the title, copyright, block, category, subcategory, explicit, keywords, owner, subtitle, image and summary tags.

    The above tags are at the channel or “station” level.

    2) Enable setting of all the appropriate itunes tags at the “item” (“episode”) level as additional fields in the post forms (regular and advanced)

    author (artist) — use poster name as default but can be changed for when you’re posting on behalf of the artist

    block, category, subcategory, explicit, keywords
    — use values from the channel’s settings as defaults.

    duration (as is already implemented by WP-iPodCatter)

    subtitle — iTunes description of the episode

    image — image for just this episode. Different from the channel’s image. Default to channel’s image.

    summary — extended description of the episode.

    3) The iTunes RSS tags file http://phobos.apple.com/static/iTunesRSS.html
    implies that podcast channel has at most 1 category/subcategory. An episode can also have, at most, 1 category/subcategory.

    Does anyone know differently?



  11. August 7, 2005 at 8:01 pm

    is it normal that itunes dosent reconize my image and Name ?


    Thanks !

  12. August 8, 2005 at 2:48 am


    Thanks for your great plugin!
    iTunes comes up with only one track even if I
    link more mp3’s and add more enclosure tags.
    Whats wrong?


    kind regards,

  13. August 24, 2005 at 9:55 pm

    Thanks Garrick really getting slick now!

  14. September 1, 2005 at 11:25 am

    This is the line I keep geeting errors on. I am using the new version 1.0
    \ A view from the couch!

    shouldn’t the tag be

    I am new with this and love your itunes work because itune has been a buster for me. When this is working I will donate for your work.
    much thank
    John bennie

  15. Carmen
    September 3, 2005 at 10:58 pm

    Hey everyone,

    I too am getting the same error:

    Xml Data error ‘80040002’
    Unable to parse Xml: The following tags were not closed: rss, channel, item.

    /feedcheck/incRSS.asp, line 135

    Here’s a link to my RSS:

    I would really appreciate any help! Thanks in advance!

  16. September 17, 2005 at 3:39 pm

    I have been working on this for about 3 weeks and every time I replace the wp-rss2 file with the iTunes file, it breaks the whole rss feed for the site. I get an error for line 91 column 1. I even had a php coder at work look at the file and he can find nothing wrong, but the rss error continues. Any suggestions on resolving this?

  17. September 17, 2005 at 3:54 pm

    Garrick, I just found the post at WP forums about the getid3 file not being included and as soon as I located that and uploaded it to the site, everything started working great.
    Suggestion: put a link to the discussion over at WordPress on you site. It helped me a lot.
    Thanks for a great tool.

  18. October 8, 2005 at 1:46 pm

    Another error question: When I activate the plug-in I get

    Fatal error: Call to undefined function: is_plugin_page() in /usr/local/4admin/apache/vhosts/mombo.org/httpdocs/wordpress/wp-content/plugins/wp-ipodcatter.php on line 11

    Any thoughts?

  19. udo
    October 9, 2005 at 12:22 am

    is there some kind of documentation (except those relatively useless 3 lines above) on how to actually use this plugin?
    what do i have to do where to get a podcast up and running?
    yes, I have to put the mp3s somewhere, but what do i do then?

  20. October 11, 2005 at 4:07 pm

    I’m having issues with my feed when using this plugin. It isn’t validating for a couple of reasons, a couple of which would be solved if the plugin used my post summary instead of entire post for the [itunes:description].

    You can see my validator results here:


    Thanks so much for this plugin, I can’t wait to get my feed working. 🙂

  21. October 17, 2005 at 3:05 am

    I´m trying to use it to a videoblog, and works but there is a problem with the database. I have 15 or more itunes:duration items in my wordpress database without a value. Could it be a detect duration problem? Can I disable duration detection?

  22. October 18, 2005 at 11:26 pm

    Very much liking what you’ve done with this plugin so far.
    One request:
    We need the ability to vary the author/artist of the content on a per post basis – this needs to be independant of the user publishing the post.

    keep up the good work

    – james

  23. October 29, 2005 at 11:06 am

    After installing your plugin, I still don’t have the WP-i
    in my options menu. Instead I’m getting this error message about the plugin.

    Fatal error: Call to undefined function: wp_ipodcatter_config() in /usr/www/users/rwilkins/blog/wp-content/plugins/wp-ipodcatter.php on line 11

    Line 11 is referencing this file but I don’t have a config file in any of the directories. Is that the problem?

  24. October 30, 2005 at 10:23 am

    Why don’t I have any reference to wp_ipodcatter in my options menu? It is as if it doesn’t recognize the new plugin at all.

  25. Oz
    November 1, 2005 at 2:26 pm

    Any chance of some docs for iPodcatter?

    Great tool!


  26. November 3, 2005 at 9:40 am

    So I setup wp-ipodcatter, but it doesn’t seem to work right. First, it tried to install its files to /wp-content/wp-plugins so I moved all those files to wp-content/plugins where it belongs. Then I activated the plugin and it showed up in the options menu. But changing the options for the plugin seems to have no effect whatsoever on the contents of the feed itself. what gives?

  27. November 3, 2005 at 11:10 am

    The itunes tags are in the replacement rss2.php file included in the wp-ipodcatter.zip file.

  28. November 21, 2005 at 3:08 pm

    while trying to add my feed to iTunes they responded with this message…any idea how I can fix it?

    Dear Podcast Creator,

    This is to inform you that your podcast has been removed from the iTunes Music Store because of a technical problem with your feed.

    If your problem can be resolved, you can fix it in your RSS feed, and then re-submit your podcast to the Music Store.


    The Music Store Team

  29. December 10, 2005 at 4:55 am

    I had a couple problems with this, both related. It didn’t like ampersands & or # signs.

    #1 the category Arts & Culture was gagging with the message
    The XML page cannot be displayed
    Cannot view XML input using XSL style sheet. Please correct the error and then click the Refresh button, or try again later.
    Whitespace is not allowed at this location. Error processing resource ‘http://radio.bonsaitalk.com/feed/’. Line 23, Positi…

    Art & Culture

    similar error on the Arts & Entertainment

    #2 Same thing was happening on the phrase, which appears in each of my podcasts. It didn’t like the # sign, so I tried   before it but it still gagged.

    Reference to undefined entity ‘nbsp’. Error processing resource ‘http://radio.bonsaitalk.com/feed/?a=11’. Line 75, Positio…

    Download Program #03



  30. Pingback: Haystack
  31. December 29, 2005 at 8:16 pm

    I’m having some trouble with getting keywords and duration to work. When I fill it out and then save, the information I’ve entered seems to get lost. This is in spite of having set the option to manual in the settings.

    Other than that, thanks for making this great plug-in and saving a ton of people a lot of very boring work. 🙂

  32. Karim Brusseleers
    January 1, 2006 at 5:33 pm

    The duartion tag is not working. Nothing appears in iTunes… Somebody can help me?

  33. January 2, 2006 at 4:13 pm

    HAs any one tried upgrading to wordpress 2.0 who is using this plugin? It is not listed as a plug in that works and is not listed as one that doesw not work. Is this plugin needed in the same way with the 2.0 version of WP? I would love to know from someone who has tried it before I give it a shot.

  34. January 3, 2006 at 2:09 pm

    It seems to work (mostly). I set up a test blog with WordPress 2.0 and iPodCatter, the feed validated okay. Upon examining the feed, I noticed that dc:creator and itunes:author are empty. I have not found any other error. In fact, the newest version of iPodCatter definitely fixes some problems. The new wp-rss2.php in wp2.0 works a little different, so I’m assuming that a minor chance to that will be in order.

  35. January 6, 2006 at 11:19 pm

    Everything is good so far – the new update fixed a few things. However, there is still an issue with the description length – the posts with the episodes tend to be sort of long on the mixtape show site, so feedvalidator.org gives me errors saying that it is exceeding the 4000 word limit. Any workarounds or fixes for this? Otherwise good ish…thanks!

  36. January 8, 2006 at 5:35 pm

    Will this work with video casts in itunes?

  37. January 8, 2006 at 7:19 pm

    The plug-in should work the same for video, audio, or anything else you throw at it.

  38. Pingback: Quixtar Blog
  39. jab
    January 23, 2006 at 12:39 am

    Just wondering if there is a way to add iTunes keywords for individual posts? My category is named “Music Podcasts” and it won’t validate because it says I need to use commas to seperate keywords. I would like to be able to put in customized keywords for each post.

  40. January 27, 2006 at 4:44 am

    Noticed this: If your podcast’s file-format is m4a/mp4, it is not recognized and added to the rss file as an enclosure. I don’t know if that is hard to do or not, but I do know that the new Podcast-friendly version of GarageBand will use the .m4a and/or .mov file formats.

    BTW – I apologize if you have tried to reach me for Mac testing. My e-mail has been down. I’ve included another one with this comment.

  41. January 27, 2006 at 9:06 am

    Rasmus, you’re right – I believe only mp3s and a couple other formats are automatically recognized by WordPress’ enclosure detector. You can alway enter them by hand or use the enclosure flex plugin.

  42. February 20, 2006 at 1:15 pm

    I’m using WP 2.0 and wp-ipodcatter and it’s working great except I’ve found myself in the unique situation where I’m using a single WP installation to serve a number of podcasts. I’m organizing each show in it’s own category and this works great for creating a unique RSS feed for each show, but I’m having problems because I want the itunes:subtitle and itunes: summary fields to be unique for each WP category. Instead they are being set by wp-ipodcatter off the WP install information and there’s no way I can customize them for each category, thus my unique feeds on iTunes are showing up with the general level description and not a description for each show.

    So suggestions.. would it be possible to allow wp-ipodcatter to have unique subtitles and summaries for each category, or allow a way I can manually override these for each post? I hate to have to do a separate WP install for each show but that’s the only way I can think of to fix this? I’ve even tried passing this feed through feedburner but they don’t allow editing of those itunes fields either.

    Geeky Volunteer for Community Radio WERU 89.9 FM Blue Hill, ME

  43. May 2, 2007 at 6:45 am

    WordPress Mu Support? Hi Garrick, this looks like exactly the kind of tool we need at the university I work at. Only problem is we’re using WordPress MU. There’s a post in your forums saying you’ve got a version ready to upload. Does that fix it?

Leave a Reply

Your email address will not be published. Required fields are marked *