CLI‑recent scope

--recent-scope

Choose where a count-form --recent N limit applies when filters create multiple streams.

Usage

kei sync --recent 100 --recent-scope global
kei sync --recent 100 --recent-scope per-filter

Details

• Default: global
• Values: global, per-filter
• TOML key: [filters].recent_scope
• Applies only when recent is a numeric count

global means kei takes the library-wide recent N, then applies album, smart-folder, unfiled, media, filename, and date filters to that fixed set.

per-filter means each selected album, smart folder, or unfiled pass can contribute up to N assets. Use this when you intentionally want a count window per selected collection.

recent_scope is rejected without recent, and it is rejected with days windows such as --recent 30d.

Related

• --recent
• Content Filtering