Skip to main content

Audio podcasting suite.

Project description

# PenPen
Encode audio podcast episodes and generate the RSS feed.

![alt tag](http://vignette1.wikia.nocookie.net/evangelion/images/6/60/Pen_Pen_(NGE).png)

Features:
- Works with WAVs or MP3s (encodes WAVs to ).
- Adds ID3 tags to the file.
- Generates the RSS feed.
- Creates RSS feed backups.

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

1. Run:
```bash
penpen -c [CONFIG_FILE] [AUDIO_FILE]
```
At runtime, the user will be prompted to provide the episode title and description.

If a WAV file is provided, it will be encoded to MP3. ID3 tags and cover art
will be written.

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.

1. Upload the newly encoded audio file and newly 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](https://cyber.law.harvard.edu/rss/rss.html)
- [RSS Languages](https://cyber.law.harvard.edu/rss/languages.html)
- [iTunes Podcast Best Practices](https://help.apple.com/itc/podcasts_connect/#/itc2b3780e76)
- [iTunes Podcast Requirements](https://help.apple.com/itc/podcasts_connect/#/itc1723472cb)
- [Podcast Categories](https://www.podcastmotor.com/itunes-podcast-category-list/)


# 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.
- Support Python 3.
- Add parameter for LAME encoding options.
- Check on installation into virtual environments.


Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

PenPen-0.1.1b1.tar.gz (10.2 kB view details)

Uploaded Source

Built Distribution

PenPen-0.1.1b1-py2-none-any.whl (13.7 kB view details)

Uploaded Python 2

File details

Details for the file PenPen-0.1.1b1.tar.gz.

File metadata

  • Download URL: PenPen-0.1.1b1.tar.gz
  • Upload date:
  • Size: 10.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for PenPen-0.1.1b1.tar.gz
Algorithm Hash digest
SHA256 73207c76ed672117e0c4202613a51d56c0d0ca1caf37dff493af224de8cb71c7
MD5 e5d86848003b11b5fa40d01ba0615556
BLAKE2b-256 d3811c96f835f5d50f976dcc5a15623602ab0063770d252e9e5c951296fbf490

See more details on using hashes here.

File details

Details for the file PenPen-0.1.1b1-py2-none-any.whl.

File metadata

File hashes

Hashes for PenPen-0.1.1b1-py2-none-any.whl
Algorithm Hash digest
SHA256 0a4456ddcfa8bda525742974e81baf5b4ac5d971c11f19f75fb9ef57267faa57
MD5 de9a8229fc0c8e69fc5cf2262cff85f1
BLAKE2b-256 a2906b66353aec44aec03614f6321ecab46785c44a2218f5a40cb92ffcee65ec

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page