Skip to content

docs: correct what the youtube item limits actually control - #181

Merged
umputun merged 1 commit into
masterfrom
docs-youtube-item-limits
Sep 20, 2026
Merged

umputun merged 1 commit into
masterfrom
docs-youtube-item-limits

Conversation

@umputun

@umputun umputun commented Sep 20, 2026

Copy link
Copy Markdown
Owner

corrects the youtube limit documentation after #125. max_per_channel was documented as the per-channel download limit, which it is not: a channel with no explicit keep gets its Keep from system.max_per_feed, and for a configured channel with a positive effective keep that value overrides max_per_channel for downloads.

the note under the config example says what the effective keep controls, including that cleanup retains up to keep + 1, and that the upstream feed returns only a window of recent entries so a limit above it raises retention rather than fetching more per poll.

also adds a backlog item for the generate/serve limit split this turned up: POST /yt/rss/generate drops the channel's Keep and so uses max_per_channel, while GET /yt/rss/{channel} for configured channels and the automatic writes use keep.

Fixed #125

max_per_channel was documented as the per-channel download limit, which it is not.
setDefaults gives every channel Keep from system.max_per_feed when the channel sets
none, and for a configured channel with a positive effective keep that value overrides
max_per_channel for downloads. What max_per_channel does limit is the channel source
page, RSS requests for channel ids absent from the config, and files written by
POST /yt/rss/generate.

Also documents that the upstream feed returns only a window of recent entries, so a
limit above that window raises retention rather than fetching more per poll, and adds
a backlog item for the generate/serve limit split this turned up.

Fixed #125
Copilot AI lite review requested due to automatic review settings September 20, 2026 02:42

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@umputun
umputun merged commit f1312b9 into master Sep 20, 2026
6 checks passed
@umputun
umputun deleted the docs-youtube-item-limits branch September 20, 2026 02:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Total number of files limited to 256

2 participants