Finding Feeds & Usage

September 16, 2026 ยท View on GitHub

< Docs index | Project README

Finding Podcast RSS Feeds

MinusPod includes a built-in podcast search on the Add Feed page. It works out of the box using Apple's iTunes directory, which needs no account or API key. If you prefer PodcastIndex.org, pick it under Settings > Podcast Search, get free API credentials at api.podcastindex.org/signup, and add them there; the Test connection button sends a signed one-result search so you know the credentials work before you need them. Installs that already had PodcastIndex credentials before the provider option existed keep using PodcastIndex until they choose otherwise.

Podcast search on the Add Feed page, Dracula dark theme

You can also find RSS feeds manually:

  1. Podcast website - Look for "RSS" link in footer or subscription options
  2. Apple Podcasts - Search on podcastindex.org using the Apple Podcasts URL
  3. Spotify-exclusive - Not available (Spotify doesn't expose RSS feeds)
  4. Hosting platforms - Common patterns:
    • Libsyn: https://showname.libsyn.com/rss
    • Spreaker: https://www.spreaker.com/show/{id}/episodes/feed
    • Omny: Check page source for omnycontent.com URLs

No RSS feed at all

If a show never had an RSS feed to begin with, such as your own recordings or an archive of downloaded episodes, see Local Feeds for building a feed from your own audio files instead of finding one to subscribe to.

Usage

Add your modified feed URL to any podcast app:

http://your-server:8000/your-feed-slug

The feed URL is shown in the web UI and can be copied to clipboard.

Audiobookshelf

If using Audiobookshelf as your podcast client, its SSRF protection will block requests to MinusPod when running on a local/private network. Add your MinusPod hostname or IP to Audiobookshelf's whitelist:

SSRF_REQUEST_FILTER_WHITELIST=minuspod.local,192.168.1.100

This is a comma-separated list of domains excluded from Audiobookshelf's SSRF filter. See Audiobookshelf Security docs for details.

Feeds on a private or LAN host

MinusPod validates feed source URLs and blocks private/loopback/LAN addresses by default (SSRF protection). If a feed source is on a private address (a LAN Audiobookshelf server or a self-hosted feed), set MINUSPOD_ALLOW_PRIVATE_FEED_HOSTS=true.

LLM Cost and Model-Usage Stats API

Two read-only endpoints expose the LLM call ledger for cost tracking: GET /api/v1/stats/model-usage breaks down spend by provider and model, and GET /api/v1/stats/episode-costs breaks it down by episode instead. Both are paginated (page, limit), sortable (sortBy, sortDir), and filterable by date range (from, to), podcastSlug, provider, and model.

Spend includes failed calls that were still billed by the provider, not just successful ones. A model's cost can be unknown if MinusPod has no pricing data for it; model-usage reports these separately as unknownCostCount rather than folding them into the total as zero. episode-costs distinguishes an episode's most recent processing run (latestRunCostUsd) from its lifetime total across every run (cumulativeCostUsd), which differ once an episode has been reprocessed.

See openapi.yaml for full parameter and response details.

< Docs index | Project README