PenPen

Encode audio podcast episodes and generate the RSS feed.

Features

• Add ID3 tags to podcast episode files.
• Generate validated RSS feeds.
• Create RSS feed backups.
• Compatiable with mp3 and WAV.

Installation

# Install PenPen
git clone https://github.com/ryanmeasel/PenPen.git
cd PenPen
pip install -r requirements.txt
python setup.py install

# (Optional) Add LAME to transcode WAV to mp3
# [Ubuntu] sudo apt-get install lame
# [OSX] brew install lame

Usage

1. Create a custom configuration file specifying the details of the RSS feed. See configurationExample.conf for an example.

2. Run: penpen -c [CONFIG_FILE] [AUDIO_FILE]

   • Provide the episode title and description.
   • If a WAV file is provided, it will be encoded to MP3.
   • If the RSS feed doesn't exist yet, a new one will be generated, otherwise the episode will be appended to the existing file and a backup of the feed will be generated.

3. Upload the tagged audio file and generated RSS xml file to your hosting.

Requirements

• LAME MP3 encoder
  • Debian: sudo apt-get install lame
  • OS X: brew install lame
• Mutagen Metadata handler
  • All: pip install mutagen

Additional Resources

• RSS 2.0 Specification
• RSS Languages
• iTunes Podcast Best Practices
• iTunes Podcast Requirements
• Podcast Categories

TODO

• Configuration file parser needs to handle multi-line strings.
• Support links in tag values.
• Enforce subtitle 255 character limit.
• Support episode subtitles.
• Allow for up to 3 categories.
• Allow episode images to be added at runtime.
• Add parameter for LAME encoding options.