puckfetcher 1.2.0

A simple command-line podcatcher.

puckfetcher
===========

| |BSD3 License|

| |Build Status|

| |Coverage Status|

| |Issue Count|

.. image:: https://badge.fury.io/py/puckfetcher.svg
:target: https://badge.fury.io/py/puckfetcher

.. image:: https://badge.waffle.io/andrewmichaud/puckfetcher.png?label=ready&title=Ready
:target: https://waffle.io/andrewmichaud/puckfetcher
:alt: 'Stories in Ready'

A simple command-line podcatcher.

GitHub Project: (https://github.com/andrewmichaud/puckfetcher)

Supports Python 3.6+. Please report any issues on the GitHub project or reach out over email.

| You’ll need setuptools (https://pypi.python.org/pypi/setuptools) to run this in its current
| state. Go get it, clone this repo, and you can run the below commands. Should work on OSX and
| Linux, from the command line. You’ll want a default config file, name it config.yaml and look at
| example\_config.yaml to see how it should be structured.

Directory for config file:

- OSX: /Users/[USERNAME]/Application Support/puckfetcher/config.yaml
- Linux: /home/[USERNAME]/.config/puckfetcher/config.yaml

Build + Install:

::

python3 setup.py install

Test:

::

python3 setup.py test

Features
--------
- Download any podcast with an RSS URL.
- Download newest episodes on demand.
- Download any episode from a podcast's backlog.
- Respects podcast authors' websites - rate limits, checks when feed was last updated when trying
to refresh.
- Provides progress on downloads.
- Provides summary of recently-downloaded podcasts per-session, as well as summary of
recently-downloaded episodes per-podcast.
- Add MP3 tag support to clean up tags based on feed information if it’s messy.

Ideas for Future Releases
-------------------------
- Text-based progress for other time-consuming actions.
- Support PyPy (when it supports 3.6+).
- Allow parallel downloading.

.. |BSD3 License| image:: http://img.shields.io/badge/license-BSD3-brightgreen.svg
:target: https://tldrlegal.com/license/bsd-3-clause-license-%28revised%29
.. |Build Status| image:: https://travis-ci.org/andrewmichaud/puckfetcher.svg?branch=master
:target: https://travis-ci.org/andrewmichaud/puckfetcher
.. |Coverage Status| image:: https://coveralls.io/repos/andrewmichaud/puckfetcher/badge.svg?branch=master&service=github
:target: https://coveralls.io/github/andrewmichaud/puckfetcher?branch=master
.. |Issue Count| image:: https://codeclimate.com/github/andrewmichaud/puckfetcher/badges/issue_count.svg
:target: https://codeclimate.com/github/andrewmichaud/puckfetcher