Metadata-Version: 1.1
Name: podfetch
Version: 0.4.3
Summary: Fetch audio podcasts and store files locally.
Home-page: https://github.com/akeil/podfetch
Author: Alexander Keil
Author-email: alex@akeil.net
License: BSD
Description: ########
        podfetch
        ########
        Fetch audio or video podcasts and store files locally.
        
        Features
        ########
        - Manage subscriptions through the command line
          or by editing configuration files.
        - Download all podcasts with a single command,
          e.g. as a cron-job.
        - Hooks to execute additional commands after downloading new episodes.
        
        
        Usage
        #####
        To add a subscription:
        
        .. code:: shell-session
        
            $ podfetch add http://example.com/rss
        
        To update subscriptions:
        
        .. code:: shell-session
        
            $ podfetch update
        
        To list recently downloaded episodes:
        
        .. code:: shell-session
        
            $ podfetch ls
        
        Use ``podfetch --help`` for more.
        
        
        Configuration
        #############
        The central configuration files are
        * ``/etc/podfetch.conf`` for system-wide settings
        * ``~/.config/podfetch/podfetch.conf`` for user based settings
        
        Configuration options are:
        
        .. code:: ini
        
            [podfetch]
            # where to store downloaded episodes
            content_dir = ~/Documents/Podcasts
        
            # filenames for downloaded episodes
            filename_template = {pub_date}-{title}
        
            # number of threads for parallel downloads
            update_threads = 8
        
            # ignore these files in the subscriptions directory
            ignore = .*
        
        
        Subscriptions
        =============
        Subscriptions are kept as ini-files under ``~/.config/podfetch/subscriptions``
        with one file per feed.
        The files look like this (``url`` is the only mandatory setting):
        
        .. code:: ini
        
            [subscription]
            url = http://www.example.com/podcast
        
            # maximum number of episodes to keep
            max_episodes = 30
        
            # display title
            title = My Podcast
        
            # override application wide template for this subscription
            filename_template = {title}
        
            # override application config for this subscription
            content_dir = /path/to/episodes
        
            # set this to False to stop fetching updates for this subscription
            enabled = True
        
        
        Interesting Directories
        =======================
        ``~/.config/podfetch``
            Contains the user-specific config file
            and the ``subscriptions/`` subdirectory with settings for
            individual podcasts.
            Can also contain *hooks*.
        
        ``~/.local/share/podfetch``
            The default location for downloaded episodes
            and *index files* where episode details are stored.
        
        ``~/.cache/podfetch``
            Recent values from *etag* and *last-modified* HTTP headers
            for each subscription.
        
        
        
        
        History
        -------
        
        0.1.0 (2013-09-11)
        ++++++++++++++++++
        
        * First release on PyPI.
Keywords: podfetch
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
