Metadata-Version: 2.1
Name: podcastbackup
Version: 0.1.3
Summary: UNKNOWN
Home-page: https://github.com/duggan/podcastbackup
Author: Ross Duggan
Author-email: ross@duggan.ie
License: MIT License
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: Implementation :: PyPy
Description-Content-Type: text/markdown
Requires-Dist: feedparser
Requires-Dist: requests
Requires-Dist: progressbar2
Requires-Dist: pypandoc

# podcastbackup

Back up podcasts with metadata from a feed URL. Progress indicator and resuming.
Hacky, only really tested against FeedBurner/libsyn feeds.

When you run it, you get a directory named after the podcast with a list of `mp3` files and `metadata.json` files.

```
tree /mnt/backups/podcast/
/mnt/backups/podcast/
├── bestshowever1.mp3.metadata.json
├── bestshowever1.mp3
├── bestshowever2.mp3.metadata.json
├── bestshowever2.mp3
├── bestshowever3.mp3.metadata.json
├── bestshowever3.mp3
```

The `metadata.json` files look like:

```json
{
    "text": "This is probably the best show yet!",
    "href": "http://bestshowever.cachefly.net/bestshowever/bestshowever42.mp3",
    "title": "Best Show Ever 42: All The Answers"
}
```

## In action

![Screenshot of podcastbackup downloading](https://i.imgur.com/55g4iQY.gif)

## Usage

```
$ pip install podcastbackup
```

```
usage: podcastbackup [-h] -f FEED [-o OUTPUT] [-t TYPE] [-i FILTER]

Helps you back up your podcasts.

optional arguments:
  -h, --help            show this help message and exit
  -f FEED, --feed FEED  RSS feed url
  -o OUTPUT, --output OUTPUT
                        Location for downloaded items
  -t TYPE, --type TYPE  File extension to look for in feed items
  -i FILTER, --filter FILTER
                        Apply a regular expression filter on titles
```

Example:

```
$ podcastbackup -f http://feeds.feedburner.com/se-radio
```

Works with Python 2 and 3.

## Ignores file

Drop a file named `.ignores` into the download directory of a particular podcast to skip downloading particular episodes.

Useful for skipping over broken / missing episodes. An example of the syntax is in the .ignores file with this repo.



