Findables

It’s good to understand the “findable” objects in flam - objects that can be found in a movie list. There are three findable types: movies, people, or roles.

Findable objects have many attributes. For example, ‘title’ is a movie attribute, and ‘birthday’ is a people’s attribute. Click here to read more about attributes and see a list of all builtin attributes.

Movies

Movies are exactly what you think - movies. You can browse all the movies in your list:

flam find movies

People

In the simplest case, you can find all the people in any of the movies in the list. But people can also be confined to a specific crew type (e.g. director, cast, etc.), and they can also be grouped by collaborators.

Formally, when finding people, each object is a list of people (could be more than 1) + a crew type + a group mode.

Crew type

Flam supports the following crew types:

director
assistant-director
producer
executive-producer
composer
cinematographer
choreographer
editor
writer
cast
stuntcast
casting-director
art-director
additional
any

The same person can have different properties when presented as different crew types. For example, Quentin Tarantino will have a different ‘num-movies’ attribute as a director than as a cast member.

The ‘any’ crew type is special - it means you don’t care about the crew type, you just want to find the people who were in the movies regardless of what they did in those movies.

Group mode

Grouping lets you turn collaborators into a single entity - when you search for directors, you probably want to see the Coen brothers as a single director.

People objects are always attached to a group mode: ‘separate’ or ‘group’.

• When separate, each returned object represents a single person.

• When grouped, flam will find people who’ve collaborated on movies together and return them as a single object.

Every crew type has a default group mode that makes sense for it. Directors are grouped by default, actors are separate. This means that if you:

flam find director-people

The Coen brothers will be shown as a single entry.

Roles

A role is an appearance of some people in some movie. Think “Cristoph Waltz as a castmember in Inglorious Basterds”. So when searching for roles, you will see an entry per people per movie.

Roles also have a crew type and a group mode like people do.

Since they combine a people and a movie, roles support any movie attribute, people attribute, and also their own role attributes.

# Browse directors and also the movies they directed from the list.
flam find director