Document common auto-download issues #500
+36
−0
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -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 %} |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change | ||||||
|---|---|---|---|---|---|---|---|---|
| @@ -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. | ||||||||
|
Member
There was a problem hiding this comment.
Suggested change
|
||||||||
| 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. | ||||||||
|
Member
There was a problem hiding this comment.
Suggested change
|
||||||||
|
|
||||||||
| On the global settings page, you can also configure to only perform automatic downloads when on Wi-Fi. | ||||||||
|
Member
There was a problem hiding this comment.
Suggested change
Isn't this conditional based on Android version? I don't see this option. (Maybe we should refer to Downloads → Mobile updates instead?) |
||||||||
| 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. | ||||||||
|
Member
There was a problem hiding this comment.
Suggested change
|
||||||||
|
|
||||||||
| ## 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)? | ||||||||
|
Member
There was a problem hiding this comment.
Suggested change
|
||||||||
| 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`. | ||||||||
|
Member
There was a problem hiding this comment. We should maybe re-introduce a way to make this easier. Maybe a banner at the top of the Downloads screen if the limit is hit? |
||||||||
| 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. | ||||||||
|
|
||||||||
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.