Configuration

This extension provides a number of configuration values that can be tweaked. However, the default configuration should contain everything to get you up and running, and will usually require only a few modifications, if any, to match personal preferences.

Configuration Values

podcast/enabled

Whether this extension should be enabled or not.

podcast/browse_root

A local path or URL pointing to an OPML syndication feed to use as the root for browsing the Podcasts directory in Mopidy. Relative paths refer to files in the extension’s configuration directory 1.

For example, this will point the Podcasts directory to a collection of all the BBC Radio and Music feeds:

browse_root = http://www.bbc.co.uk/podcasts.opml

The default value is Podcasts.opml, so simply exporting your subscribed feeds from your favorite podcast client under this name and dropping the file in Mopidy-Podcast’s configuration directory is usually all you need to do.

If set to an empty string, the Podcasts directory will be hidden when browsing Mopidy.

podcast/browse_order

Whether to sort podcast episodes by ascending (asc) or descending (desc) publication date for browsing.

podcast/lookup_order

Whether to sort podcast episodes by ascending (asc) or descending (desc) publication date for lookup, for example when adding a podcast to Mopidy’s tracklist.

podcast/cache_size

The maximum number of podcast feeds that will be cached in memory.

podcast/cache_ttl

The cache’s time to live, i.e. the number of seconds after which a cached feed expires and needs to be reloaded.

podcast/timeout

The HTTP request timeout when retrieving podcast feeds, in seconds.

Default Configuration

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

[podcast]
enabled = true

# optional path or URL to an OPML file used as the root for browsing;
# relative paths will be resolved according to the extension's
# configuration directory
browse_root = Podcasts.opml

# sort podcast episodes by ascending (asc) or descending (desc)
# publication date for browsing
browse_order = desc

# sort podcast episodes by ascending (asc) or descending (desc)
# publication date for lookup, e.g. when adding a podcast to Mopidy's
# tracklist
lookup_order = asc

# maximum number of podcast feeds to cache in memory
cache_size = 64

# cache time-to-live in seconds
cache_ttl = 86400

# HTTP request timeout in seconds
timeout = 10

Footnotes

1

When running Mopidy as a regular user, this will usually be ~/.config/mopidy/podcast. When running as a system service, this should be /etc/mopidy/podcast. Note that it may be necessary to create these directories manually when installing the Python package from PyPi, depending on local file permissions.