Lists

To work with flam is to work with movie lists. So it’s good to familiarize yourself with how to reference lists, and what types of lists flam supports.

Composite lists

Flam lets you define lists which are remixes of other lists you’ve configured. After you’ve configured “simple” lists with flam config list, you may use them to define “composite” lists:

# Define a list "rated" of only the movies from your "watched" list which you've personally rated.
flam config composite rated watched -has my-rating

# Define a list "all" which combines both your "watched-movies" and "watched-shows" lists.
flam config composite all watched-movies watched-shows

Generally, composite lists are one or more simple lists combined together, then optionally filtered.

Listdefs

“Listdefs” are how you describe which list you’re talking about to flam. They have a number of forms:

• "<fetcher>=<address>" (ex: “imdb-listid=083886771”)

  A raw form for lists which haven’t been given a name. The kind of address it expects depends on the fetcher.

• "<name>" (ex: “watched”)

  The name of a list configured with flam config list or flam config composite.

• "<list type>=<name>" (ex: “list=watched”)

  Like above, but with an explicit list type so there’s no ambiguity. <list type> is either ‘list’ or ‘composite’.

• "*"

  A special listdef indicating to use all configured lists.

• "defaults"

  A special listdef indicating to use all lists configured as --default-fetch (if you’re using fetch), or --default-find (if you’re using find).