Skip to content
🚧 These docs are a work in progress and may contain inaccuracies. Content is being actively reviewed and validated.

Subscriptions & Settings

Each podcast subscription has its own settings that override global defaults:

SettingDefaultDescription
Auto-downloadOffAutomatically download new episodes when they appear
Download limitNoneMaximum episodes to keep downloaded (oldest deleted first)
Auto-add to queueOffAutomatically add new episodes to your queue
Queue positionLastWhere new episodes are inserted: “Next” (front) or “Last” (back)
NotificationsOffGet notified when new episodes are published
Playback speedPer-podcast speed override (0.5–3.0x). Blank uses global default

Filters let you control which episodes are included when auto-downloading or auto-queuing:

  • Episode types — Include only full episodes, trailers, bonus content, or any combination
  • Minimum duration — Skip very short episodes (e.g., under 5 minutes)
  • Maximum duration — Skip very long episodes (e.g., over 3 hours)
  • Title exclusion — Skip episodes whose title matches specific keywords

Filters apply to auto-download and auto-queue actions. They don’t hide episodes from your library — you can always manually play or download any episode.

Episodes can be downloaded for offline playback. Downloaded episodes are stored on the server and available to play without an internet connection to the podcast host.

Select any episode and choose Download. The episode enters a download queue and is processed by the server in the background.

Download states:

StatusMeaning
QueuedWaiting to be downloaded
DownloadingCurrently being fetched from the host
CompletedDownloaded and available offline
FailedDownload failed (network error, etc.)

Enable auto-download on a subscription to automatically download new episodes as they appear. Combine with a download limit to cap storage — when the limit is reached, the oldest downloaded episodes are removed to make room.

Delete a download to free storage space. This removes the local file but keeps the episode in your library — you can re-download it or stream it directly at any time.

These settings apply across all podcasts unless overridden by a per-podcast setting:

PreferenceDefaultDescription
Default speed1.0xPlayback speed for all podcasts (0.5–3.0x)
Skip forward30sSeconds to skip when pressing the forward button
Skip backward15sSeconds to skip when pressing the back button
Trim silenceOffRemove long pauses in speech
Volume boostOffNormalize audio levels
Continuous playbackOnAuto-play the next episode in your queue
Mark-played threshold90%Percentage of an episode to listen to before marking as played
Audio proxyOnRoute audio through the server to hide your IP
Visible categoriesAllWhich podcast categories appear on the Discover tab

Dubby periodically checks your subscribed podcasts for new episodes. Polling intervals adapt based on how active each feed is:

Feed activityPoll interval
New subscription (first 24h)30 minutes
Active (episode in last 7d)1 hour
Moderate (episode in last 30d)6 hours
Dormant (no episode in 30d+)24 hours

When a feed check fails (network error, invalid RSS, host downtime), Dubby uses exponential backoff — doubling the interval with each consecutive failure, up to a maximum of 24 hours.

After 10 consecutive failures, a feed is marked as dead. Dead feeds are no longer polled automatically but remain in your library. If the podcast comes back online, an admin can manually refresh the feed to reactivate it.

Dubby stores ETag and Last-Modified headers from each feed response. Subsequent polls send these back as conditional headers, so the podcast host can respond with 304 Not Modified when nothing has changed — saving bandwidth for both sides.

StateMeaning
ActiveFeed is healthy and being polled on schedule
PausedPolling is suspended (can be resumed manually)
DeadFeed has failed 10+ times and is no longer polled

Unsubscribing from a podcast removes your subscription and per-podcast settings. The podcast and its episodes are removed from your library. Downloaded files are deleted. Your listening history (progress entries) is preserved.