Condition Blocks

The condition block controls when a rule is applied, based on channel properties, client, playlist, and more.

All fields are optional. Multiple fields in one block must all match (implicit AND): for example, patterns together with clients matches only when both do. For explicit combinations use and or or, which take arrays of nested condition blocks.

Generated channels

A generated channel belongs to its parent playlist, so playlists matches it by the parent playlist name, not the channel name.

YAML Structure

condition:
  selector: ""
  patterns: []
  clients: []
  playlists: []
  and: []
  or: []
  invert: false

Fields

Field	Type	Required	Description
`selector`	`Selector`	No	See selector docs for details on matching properties
`patterns`	`[]regex`	No	Array of regex patterns, matches channel name or other selector item
`clients`	`[]string`	No	Restrict to clients by name
`playlists`	`[]string`	No	Restrict to playlists by name
`and`	`[]Condition`	No	All nested conditions must match
`or`	`[]Condition`	No	At least one nested condition must match
`invert`	`boolean`	No	If true, invert the condition result

Examples

Channel Name Pattern:

condition:
  patterns: ["^CNN.*", "^BBC.*"]

Limit to Clients/Playlists:

condition:
  clients: ["family-tablet", "living-room-tv"]
  playlists: ["sports-premium", "news-channels"]

Attribute Match Using Selector:

condition:
  selector: "attr/group-title"
  patterns: ["^Sports$"]

Nested Conditions with AND/OR:

condition:
  or:
    - clients: ["premium-client"]
    - patterns: ["^HD .*"]

Invert Condition:

condition:
  patterns: ["^Music .*"]
  invert: true