Configuration¶

This section describes the configuration values that affect Mopidy-Podcast’s core functions and the bundled feeds directory provider. For configuring external extensions, please refer to their respective documentation.

General Configuration Values¶

podcast/browse_limit¶: The maximum number of browse results and podcast episodes to show.

podcast/search_limit¶: The maximum number of search results to show.

podcast/search_details¶: Whether to return fully detailed search results. If set to off (the default), only a podcast’s or episode’s name and URI will appear in search results, similar to what is shown when browsing. If set to on, search results will also include meta information such as author name, track counts and lengths, publication dates and images, if available. However, this will slow down searching tremendously, so if you enable this you might consider decreasing podcast/search_limit.

podcast/update_interval¶: The directory update interval in seconds, i.e. how often locally stored information should be refreshed.

Feeds Directory Configuration Values¶

This section lists configuration values specific to the feeds podcast directory provider that is bundled with Mopidy-Podcast. If you do not plan to use the feeds directory, these can be safely ignored.

podcast/feeds¶

A list of podcast RSS feed URLs to subscribe to. Individual URLs must be seperated by either newlines or commas, with newlines preferred.

To subscribe to some podcasts from NPR‘s highly recommended All Songs Considered program:

feeds =
    http://www.npr.org/rss/podcast.php?id=510019
    http://www.npr.org/rss/podcast.php?id=510253
    http://www.npr.org/rss/podcast.php?id=510306

podcast/feeds_root_name¶: The directory name shown for browsing subscribed feeds.

podcast/feeds_cache_size¶: The maximum number of podcast RSS feeds that should be cached.

podcast/feeds_cache_ttl¶: The feeds cache time to live, i.e. the number of seconds after which a cached feed expires and needs to be reloaded.

podcast/feeds_timeout¶: The HTTP request timeout when retrieving RSS feeds, in seconds.

Default Configuration¶

For reference, this is the default configuration shipped with Mopidy-Podcast release 1.1.1:

[podcast]
enabled = true

# maximum number of browse results
browse_limit = 100

# maximum number of search results
search_limit = 20

# whether to return fully detailed search results; if set to "off",
# only name and URI will be returned for increased performance
search_details = off

# directory update interval in seconds
update_interval = 86400

# an optional list of podcast RSS feed URLs to subscribe to; URLs need
# to be seperated by commas or newlines
feeds =

# user-friendly name for browsing subscribed RSS feeds
feeds_root_name = Subscribed Feeds

# number of RSS feeds to cache
feeds_cache_size = 32

# feeds cache time-to-live in seconds
feeds_cache_ttl = 3600

# HTTP request timeout in seconds
feeds_timeout = 10