Mopidy-Podcast-iTunes

Mopidy-Podcast-iTunes is a Mopidy extension for searching and browsing podcasts on Apple Podcasts, using the iTunes Search API.

Note

The iTunes Search API is limited to approximately 20 calls per minute (subject to change). Mopidy-Podcast-iTunes uses in-memory caching extensively, so you should not be affected by this limit with normal, interactive usage.

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

enabled

Whether this extension should be enabled or not.

base_url

The iTunes Search API base URL.

country

The two-letter country code for the store you want to search.

explicit

Whether you want to include explicit content in your search results.

charts_limit

The maximum number of podcast charts entries to retrieve when browsing.

search_limit

The maximum number of search results to retrieve.

timeout

The HTTP request timeout in seconds when using the Search API.

retries

The maximum number of HTTP connection retries when using the Search API.

Default Configuration

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

[podcast-itunes]
enabled = true

# iTunes Search API base URL
base_url = https://itunes.apple.com/

# ISO country code for the store to be used
country = US

# whether search results should include explicit content; possible
# values are "Yes", "No", or empty for store defaults
explicit =

# maximum number of charts entries to retrieve, or empty for store
# defaults; maximum is 200
charts_limit = 20

# maximum number of search results to retrieve, or empty for store
# defaults; maximum is 200
search_limit = 20

# HTTP request timeout in seconds
timeout = 10

# maximum number of HTTP connection retries
retries = 3