Plex Smart Filters¶

The first collection requires both Dave Chappelle and Comedy; the second accepts either. Plex reevaluates these rules as library metadata changes.

collections:
  Dave Chappelle Comedy:
    smart_filter:
      all:
        actor: Dave Chappelle
        genre: Comedy

  Dave Chappelle or Comedy:
    smart_filter:
      any:
        actor: Dave Chappelle
        genre: Comedy

Includes unplayed movies released after January 1, 2020. The date uses MM/DD/YYYY; true is an unquoted boolean. Changes to play state can change membership without a Kometa run.

collections:
  Unplayed Recent Movies:
    smart_filter:
      all:
        release.after: 01/01/2020
        unplayed: true

Shows up to 20 Action movies with an audience rating of at least 7.5, highest rating first. The decimal is a minimum rating; the integer limits results.

collections:
  Top Action Movies:
    smart_filter:
      all:
        genre: Action
        audience_rating.gte: 7.5
      sort_by: audience_rating.desc
      limit: 20

Includes movies outside the configured /media/movies library root. .not excludes that root folder. Plex does not expose nested subfolders as Folder Location choices.

collections:
  Movies Outside Main Folder:
    smart_filter:
      all:
        folder_location.not: /media/movies

Includes movies from the 1990s using one numeric value instead of a list of ten years. decade takes no modifier.

collections:
  90s Movies:
    smart_filter:
      any:
        decade: 1990

Creates a Music smart playlist of tracks with exactly one skip. Numeric music filters use comparison modifiers: .is means equal to the integer, rather than a boolean switch.

music_playlists:
  Skipped Tracks:
    smart_filter:
      type: track
      all:
        track_skips.is: 1

Creates a track collection from the configured music-archive root folder. Music folder_location filtering requires track level; this example is a collection, rather than a Music smart playlist.

collections:
  Music From Archive Folder:
    builder_level: track
    smart_filter:
      all:
        folder_location: /media/music-archive

Boolean Filters take no modifier and can only be either true or false.

Boolean attributes¶

Date filters can be used with no modifier or with .last, .notlast, .before, or .after. The legacy .not modifier is also accepted as .notlast.

No date filter can take multiple values.

Date attributes¶

Number filters can use .is, .isnot, .gt, .gte, .lt, or .lte as a modifier. Only rating filters can use .rated.

No number filter can take multiple values.

Number attributes¶

String filters can be used with either no modifier or with .not, .is, .isnot, .begins, or .ends.

String filter can take multiple values only as a list.

String attributes¶

Tag filters can be used with either no modifier or with .not except for decade and resolution which can only be used with no modifier.

Tag filter can take multiple values as a list or a comma-separated string.

Tag attributes¶

You can use current_year to have Kometa use the current year. This can be combined with a -# at the end to subtract that number of years. i.e. current_year-2

folder_location values must match a root folder configured in the Plex library. Plex does not expose nested subfolders as Folder Location filter choices. In music libraries, folder_location is only available with builder_level: track.