Smart Groups

Smart groups automatically populate their collection pool based on filter rules instead of a manually curated list. Define the criteria once, and homescreen-hero finds every matching collection at rotation time.

How They Work

A regular group has a static list of collections you manually add. A smart group replaces that list with rules that are evaluated against your Plex collections on every rotation. Any collection matching all the rules gets included in the pool.

This means your groups stay up to date automatically. Add a new Trakt list that syncs into Plex? If it matches the smart group's rules, it gets picked up on the next rotation without any manual changes.

Creating a Smart Group

1. Go to the Groups page
2. Click New Group and select Smart Group
3. Add one or more filter rules
4. Use the Preview button to see which collections currently match
5. Configure the group settings (min/max picks, visibility, etc.) and save

Filter Rules

Rules define which collections belong to the smart group. Multiple rules are ANDed together (a collection must match all rules). Within a single rule, multiple values are ORed (a collection matches if it hits any of the values).

Available Filters

Field	Operators	Description
Label	includes, excludes	Match collections by their Plex labels
Source	is, is not	Match by where the collection came from (plex, trakt, letterboxd, mdblist, tmdb, anilist, mal)
Library	is, is not	Match by Plex library name (e.g., "Movies", "TV Shows")
Name	contains, does not contain	Match by collection title (substring search)
Sort Title	contains, does not contain	Match by the collection's sort title
Item Count	at least, at most	Match by number of items in the collection

Examples

All Trakt collections with 10+ items:

• Source is trakt
• Item Count at least 10

All movie collections except holiday ones:

• Library is Movies
• Label excludes holiday

Collections from any third-party source:

• Source is trakt, letterboxd, mdblist, tmdb, anilist, mal

Preview

The preview button evaluates your rules against the current state of your Plex library and shows exactly which collections would be included. Use this to fine-tune your rules before saving.

Smart Groups in Rotation

Smart groups participate in rotation exactly like regular groups. The only difference is how the collection pool is determined:

• Regular group: pool is the static list you configured
• Smart group: pool is resolved dynamically at rotation time

All other group settings work the same: min/max picks, collection selection, visibility, date ranges, display order, and per-user targeting.

Config Reference

groups:
  - name: All Trakt Lists
    enabled: true
    smart: true
    rules:
      - field: source
        operator: is
        values: [trakt]
    min_picks: 1
    max_picks: 2
    visibility_home: true
    visibility_shared: true

Multiple rules are ANDed:

groups:
  - name: Big Movie Collections
    smart: true
    rules:
      - field: library
        operator: is
        values: [Movies]
      - field: item_count
        operator: gte
        values: [20]
    max_picks: 1