diff --git a/_documentation/automation/automatic-downloads.md b/_documentation/automation/automatic-downloads.md new file mode 100644 index 000000000..ac81c2299 --- /dev/null +++ b/_documentation/automation/automatic-downloads.md @@ -0,0 +1,10 @@ +--- +texts: documentation.automation.automatic-downloads +layout: doc +parent: automation +icon: "fa-solid fa-download" +--- + +# {% t {{ page.texts }}.title %} + +{% tf {{ page.url | remove_first: "/" }}.md %} diff --git a/_i18n/en.yml b/_i18n/en.yml index f7d100066..aadd2cab5 100644 --- a/_i18n/en.yml +++ b/_i18n/en.yml @@ -250,6 +250,8 @@ documentation: title: "Automatic deletion" refreshing-podcasts: title: "Refreshing podcasts" + automatic-downloads: + title: "Automatic downloads" tasker: title: "Integration with other apps" bugs-first-aid: diff --git a/_i18n/en/documentation/automation/automatic-downloads.md b/_i18n/en/documentation/automation/automatic-downloads.md new file mode 100644 index 000000000..490d0cc0b --- /dev/null +++ b/_i18n/en/documentation/automation/automatic-downloads.md @@ -0,0 +1,24 @@ +When you subscribe to a podcast where you know you are interested in every new episode, automatic downloads save you from having to manually download each one. This page explains how to set it up and what to check when it isn't working. + +## How automatic downloads work + +When AntennaPod refreshes a podcast and finds new episodes, it places them in your `Inbox`. If automatic download is enabled for that podcast, AntennaPod downloads the episode in the background, adds it to the queue, and removes it from the inbox. + +Automatic downloads can be enabled in one of two ways: + +1. **Global switch**: go to `Settings` » `Downloads` and enable `Automatic download`. This toggles on automatic download for episodes of all subscriptions, but you can also exclude specific ones on the settings screen of each subscription. +2. **Per-podcast switch**: open the podcast, tap the gear (or settings) icon and enable `Include in automatic downloads`. If you want to enable automatic downloads for several podcasts at once, you can use multi-select on the subscriptions screen. + +On the global settings page, you can also configure to only perform automatic downloads when on Wi-Fi. +Most importantly, you can specify a limit for the maximum number of episodes to download before automatic downloads stop. The default limit is 50 episodes. +In `Settings` » `Downloads` » `Automatic deletion`, you can find related settings to automatically delete episodes after playing them or when automatic download needs more space. + +## Why isn't it downloading? + +If automatic downloads are enabled but episodes are not downloading, work through this checklist: + +1. Is `Include in automatic downloads` enabled on the specific podcast? +2. Are you on WiFi (or has the WiFi-only restriction been lifted)? +3. Has the episode download limit been reached? Check how many episodes are currently downloaded (on the `Downloads` screen, not just the ones in the queue) and compare it to the limit in `Settings` » `Downloads` » `Automatic download`. +4. Are the episodes of the podcast added to the inbox? Only episodes in the inbox are eligible for automatic download, so if you set the `New episodes action` to anything other than `Add to inbox`, nothing gets downloaded. Note that automatic download moves the episodes from the inbox to the queue once downloaded, so they still end up in your queue. +