Attributes

Attributes are all the information bits you can know about a findable object. Things like the title of a film, its metascore, the name of a person, his height, etc. are all attributes.

Attributes provide some facilities for using them generically without caring about the specific attribute:

• They let you sort the attribute’s values

• They let you convert values to strings

• They let you parse those strings back into values

• Flam generically handles attributes which return lists

• Flam generically handles attributes whose values are missing (i.e. not available in the fetch source)

• There are a few more ways that attributes support generic handling

Each attribute is specific to some findable type, but role attributes support any attribute of movies or people!

Tip

Flam supports implementing custom attributes.

List of builtin attributes

Note that almost every attribute may return None if the data is not available. As a string, it looks like '-'.

Many attributes below support variants. Here are the variants we support:

len-X

For some attribute X, “len-X” is the length of the attribute as a string.

Ex: len-title - the length of the movie’s title.

num-X

For some attribute X, “num-X” is the number of elements in the attribute if it returns a list. For non-lists, the value is 1.

Ex: num-cast - the number of cast members in a movie.

avg-X

For some movie attribute X, “avg-X” is a people attribute which returns the average of X across all movies those people were in.

Ex: avg-rating - the average rating across all movies the person was in.

For a people attribute X, “avg-X” is a movie attribute which returns the average of X for all the people in the movie.

Ex: avg-height - the average height of everyone in the movie.

avg-X-as-CT

Any attribute which supports avg-X also supports “avg-X-as-CT”, where CT is a crew type.

For some movie attribute X, “avg-X-as-CT” is a people attribute which returns the average of X across all movies those people were in as the crew type CT.

Ex: avg-rating-as-director - the average rating across all movies the person directed.

For a people attribute X, “avg-X-as-CT” is a movie attribute which returns the average of X for all the people in the movie as the crew type CT.

Ex: avg-height-as-cast - the average height of all actors in the movie.

sum-X

Same as avg-X, but with summation instead of averaging.

sum-X-as-CT

Same as avg-X-as-CT, but with summation instead of averaging.

Movie attributes

additional - list of names of the movie’s crewmembers in this crew type.

variants:

len, num

aliases:

ascending:

True

default op:

‘~’

art-director - list of names of the movie’s crewmembers in this crew type.

variants:

len, num

aliases:

ascending:

True

default op:

‘~’

assistant-director - list of names of the movie’s crewmembers in this crew type.

variants:

len, num

aliases:

ascending:

True

default op:

‘~’

budget-usd - the movie’s budget in US dollars.

variants:

len, num, avg, sum

aliases:

budget

ascending:

False

default op:

‘=’

cast - list of names of the movie’s crewmembers in this crew type.

variants:

len, num

aliases:

ascending:

True

default op:

‘~’

casting-director - list of names of the movie’s crewmembers in this crew type.

variants:

len, num

aliases:

ascending:

True

default op:

‘~’

choreographer - list of names of the movie’s crewmembers in this crew type.

variants:

len, num

aliases:

ascending:

True

default op:

‘~’

cinematographer - list of names of the movie’s crewmembers in this crew type.

variants:

len, num

aliases:

ascending:

True

default op:

‘~’

composer - list of names of the movie’s crewmembers in this crew type.

variants:

len, num

aliases:

ascending:

True

default op:

‘~’

content-rating - the movie’s content rating.

variants:

len, num

aliases:

ascending:

True

default op:

‘~’

countries - list of the movie’s producing countries.

variants:

len, num

aliases:

country, nation, nations, nationality, nationalities

ascending:

True

default op:

‘~’

director - list of names of the movie’s crewmembers in this crew type.

variants:

len, num

aliases:

ascending:

True

default op:

‘~’

editor - list of names of the movie’s crewmembers in this crew type.

variants:

len, num

aliases:

ascending:

True

default op:

‘~’

end-date - the TV show’s final air date in this date format.

variants:

len, num

aliases:

e-d

ascending:

False

default op:

‘=’

end-day-of-month - the TV show’s final air date in this date format.

variants:

len, num

aliases:

e-d-o-m

ascending:

True

default op:

‘=’

end-day-of-week - the TV show’s final air date in this date format.

variants:

len, num

aliases:

e-d-o-w

ascending:

True

default op:

‘=’

end-day-of-week-monday - the TV show’s final air date in this date format.

variants:

len, num

aliases:

e-d-o-w-m

ascending:

True

default op:

‘=’

end-day-of-year - the TV show’s final air date in this date format.

variants:

len, num

aliases:

e-d-o-y

ascending:

True

default op:

‘=’

end-month - the TV show’s final air date in this date format.

variants:

len, num

aliases:

e-m

ascending:

True

default op:

‘=’

end-month-day - the TV show’s final air date in this date format.

variants:

len, num

aliases:

e-m-d

ascending:

True

default op:

‘=’

end-week-of-year - the TV show’s final air date in this date format.

variants:

len, num

aliases:

e-w-o-y

ascending:

True

default op:

‘=’

end-week-of-year-monday - the TV show’s final air date in this date format.

variants:

len, num

aliases:

e-w-o-y-m

ascending:

True

default op:

‘=’

end-year - the TV show’s final air date in this date format.

variants:

len, num

aliases:

e-y

ascending:

False

default op:

‘=’

end-year-month - the TV show’s final air date in this date format.

variants:

len, num

aliases:

e-y-m

ascending:

False

default op:

‘=’

episodes-num - the number of episodes in this TV show.

variants:

len, num, avg, sum

aliases:

episodes

ascending:

False

default op:

‘=’

executive-producer - list of names of the movie’s crewmembers in this crew type.

variants:

len, num

aliases:

ascending:

True

default op:

‘~’

genres - list of the movie’s genres.

variants:

len, num

aliases:

genre, category, categories

ascending:

True

default op:

‘~’

is-liked - whether you gave the film a like.

variants:

len, num

aliases:

liked, my-like

ascending:

False

default op:

‘=’

languages - list of the movie’s languages.

variants:

len, num

aliases:

language

ascending:

True

default op:

‘~’

likes - how many people liked the film.

variants:

len, num, avg, sum

aliases:

like-count

ascending:

False

default op:

‘=’

list-index - list of the movie’s indexes in the lists it came from.

variants:

len, num

aliases:

index, list-indices, indices, list-indexes, indexes

ascending:

True

default op:

‘=’

list-note - list of notes left on this movie in this list.

variants:

len, num

aliases:

list-comment, list-notes, list-comments

ascending:

True

default op:

‘~’

listing-date - list of when you added this movie to this list or all lists compositing this list, in this date format.

variants:

len, num

aliases:

l-d

ascending:

False

default op:

‘=’

listing-day-of-month - list of when you added this movie to this list or all lists compositing this list, in this date format.

variants:

len, num

aliases:

l-d-o-m

ascending:

True

default op:

‘=’

listing-day-of-week - list of when you added this movie to this list or all lists compositing this list, in this date format.

variants:

len, num

aliases:

l-d-o-w

ascending:

True

default op:

‘=’

listing-day-of-week-monday - list of when you added this movie to this list or all lists compositing this list, in this date format.

variants:

len, num

aliases:

l-d-o-w-m

ascending:

True

default op:

‘=’

listing-day-of-year - list of when you added this movie to this list or all lists compositing this list, in this date format.

variants:

len, num

aliases:

l-d-o-y

ascending:

True

default op:

‘=’

listing-month - list of when you added this movie to this list or all lists compositing this list, in this date format.

variants:

len, num

aliases:

l-m

ascending:

True

default op:

‘=’

listing-month-day - list of when you added this movie to this list or all lists compositing this list, in this date format.

variants:

len, num

aliases:

l-m-d

ascending:

True

default op:

‘=’

listing-week-of-year - list of when you added this movie to this list or all lists compositing this list, in this date format.

variants:

len, num

aliases:

l-w-o-y

ascending:

True

default op:

‘=’

listing-week-of-year-monday - list of when you added this movie to this list or all lists compositing this list, in this date format.

variants:

len, num

aliases:

l-w-o-y-m

ascending:

True

default op:

‘=’

listing-year - list of when you added this movie to this list or all lists compositing this list, in this date format.

variants:

len, num

aliases:

l-y

ascending:

False

default op:

‘=’

listing-year-month - list of when you added this movie to this list or all lists compositing this list, in this date format.

variants:

len, num

aliases:

l-y-m

ascending:

False

default op:

‘=’

media-type - whether this “movie” is actually a movie, or a TV series, etc.

variants:

len, num

aliases:

type, title-type

ascending:

True

default op:

‘~’

metascore - the movie’s metascore.

variants:

len, num, avg, sum

aliases:

meta-score, metacritic-score

ascending:

False

default op:

‘=’

metascore-votes - how many critic’s reviews went into this movie’s metascore.

variants:

len, num, avg, sum

aliases:

metacritic-review-count, metacritic-vote-count, metascore-review-count, metascore-vote-count, metacritic-rating

ascending:

False

default op:

‘=’

my-notes - list of notes left on this movie by you in general.

variants:

len, num

aliases:

my-note, my-comment, my-comments

ascending:

True

default op:

‘~’

my-rating - the rating you gave to this movie.

variants:

len, num, avg, sum

aliases:

my-score, my-ratings, myrating

ascending:

False

default op:

‘=’

origin-uid - the movie’s UID in the source from which the data is fetched.

variants:

len, num

aliases:

origin-id, origin-guid, origin-identifier

ascending:

True

default op:

‘~’

original-title - the movie’s original title in its native language.

variants:

len, num

aliases:

original-name, native-title, native-name

ascending:

True

default op:

‘~’

oscar-noms - list of Oscar nominations received by this movie.

variants:

len, num

aliases:

oscar-nominations, noms, nominations

ascending:

True

default op:

‘~’

oscar-wins - list of Oscars won by this movie.

variants:

len, num

aliases:

oscars, awards

ascending:

True

default op:

‘~’

people - list of names of the movie’s crewmembers in this crew type.

variants:

len, num

aliases:

ascending:

True

default op:

‘~’

producer - list of names of the movie’s crewmembers in this crew type.

variants:

len, num

aliases:

ascending:

True

default op:

‘~’

profit-usd - the movie’s profit in US dollars.

variants:

len, num, avg, sum

aliases:

profit

ascending:

False

default op:

‘=’

rating - the movie’s rating.

variants:

len, num, avg, sum

aliases:

user-rating, user-score, ratings

ascending:

False

default op:

‘=’

release-date - the movie’s release date in this date format.

variants:

len, num

aliases:

r-d

ascending:

False

default op:

‘=’

release-day-of-month - the movie’s release date in this date format.

variants:

len, num

aliases:

r-d-o-m

ascending:

True

default op:

‘=’

release-day-of-week - the movie’s release date in this date format.

variants:

len, num

aliases:

r-d-o-w

ascending:

True

default op:

‘=’

release-day-of-week-monday - the movie’s release date in this date format.

variants:

len, num

aliases:

r-d-o-w-m

ascending:

True

default op:

‘=’

release-day-of-year - the movie’s release date in this date format.

variants:

len, num

aliases:

r-d-o-y

ascending:

True

default op:

‘=’

release-month - the movie’s release date in this date format.

variants:

len, num

aliases:

r-m

ascending:

True

default op:

‘=’

release-month-day - the movie’s release date in this date format.

variants:

len, num

aliases:

r-m-d

ascending:

True

default op:

‘=’

release-week-of-year - the movie’s release date in this date format.

variants:

len, num

aliases:

r-w-o-y

ascending:

True

default op:

‘=’

release-week-of-year-monday - the movie’s release date in this date format.

variants:

len, num

aliases:

r-w-o-y-m

ascending:

True

default op:

‘=’

release-year - the movie’s release date in this date format.

variants:

len, num

aliases:

r-y

ascending:

False

default op:

‘=’

release-year-month - the movie’s release date in this date format.

variants:

len, num

aliases:

r-y-m

ascending:

False

default op:

‘=’

revenue-usd - the movie’s revenue in US dollars.

variants:

len, num, avg, sum

aliases:

revenue

ascending:

False

default op:

‘=’

runtime - the movie’s runtime in minutes.

variants:

len, num, avg, sum

aliases:

runtime-minutes, length, minutes, run-length, run-time

ascending:

True

default op:

‘=’

seasons-num - the number of seasons in this TV show.

variants:

len, num, avg, sum

aliases:

seasons

ascending:

False

default op:

‘=’

source - for composite lists - which lists this movie came from.

variants:

len, num

aliases:

sources, origin, origins, src, list, lists

ascending:

True

default op:

‘~’

stars - list names of the movie’s starring actors.

variants:

len, num

aliases:

star-cast, leads, lead-actors, lead-cast

ascending:

True

default op:

‘~’

studios - list of the movie’s producing studios.

variants:

len, num

aliases:

studio

ascending:

True

default op:

‘~’

stuntcast - list of names of the movie’s crewmembers in this crew type.

variants:

len, num

aliases:

ascending:

True

default op:

‘~’

synopsis - the movie’s synopsis.

variants:

len, num

aliases:

plot, summary, description, desc, overview

ascending:

True

default op:

‘~’

tagline - the movie’s tagline.

variants:

len, num

aliases:

slogan

ascending:

True

default op:

‘~’

title - the movie’s title.

variants:

len, num

aliases:

name, movie

ascending:

True

default op:

‘~’

uid - the movie’s UID in flam.

variants:

len, num

aliases:

id, guid, identifier

ascending:

True

default op:

‘~’

url - link to the movie’s page on the website it was fetched from.

variants:

len, num

aliases:

link, page

ascending:

True

default op:

‘~’

votes - how many people voted on this movie’s rating.

variants:

len, num, avg, sum

aliases:

vote-count

ascending:

False

default op:

‘=’

watch-date - list of dates that you watched the film in this date format.

variants:

len, num

aliases:

w-d

ascending:

False

default op:

‘=’

watch-day-of-month - list of dates that you watched the film in this date format.

variants:

len, num

aliases:

w-d-o-m

ascending:

True

default op:

‘=’

watch-day-of-week - list of dates that you watched the film in this date format.

variants:

len, num

aliases:

w-d-o-w

ascending:

True

default op:

‘=’

watch-day-of-week-monday - list of dates that you watched the film in this date format.

variants:

len, num

aliases:

w-d-o-w-m

ascending:

True

default op:

‘=’

watch-day-of-year - list of dates that you watched the film in this date format.

variants:

len, num

aliases:

w-d-o-y

ascending:

True

default op:

‘=’

watch-month - list of dates that you watched the film in this date format.

variants:

len, num

aliases:

w-m

ascending:

True

default op:

‘=’

watch-month-day - list of dates that you watched the film in this date format.

variants:

len, num

aliases:

w-m-d

ascending:

True

default op:

‘=’

watch-week-of-year - list of dates that you watched the film in this date format.

variants:

len, num

aliases:

w-w-o-y

ascending:

True

default op:

‘=’

watch-week-of-year-monday - list of dates that you watched the film in this date format.

variants:

len, num

aliases:

w-w-o-y-m

ascending:

True

default op:

‘=’

watch-year - list of dates that you watched the film in this date format.

variants:

len, num

aliases:

w-y

ascending:

False

default op:

‘=’

watch-year-month - list of dates that you watched the film in this date format.

variants:

len, num

aliases:

w-y-m

ascending:

False

default op:

‘=’

writer - list of names of the movie’s crewmembers in this crew type.

variants:

len, num

aliases:

ascending:

True

default op:

‘~’

People attributes

birth-date - list of every person’s birthday in this date format.

variants:

len, num

aliases:

birthday, b-d

ascending:

False

default op:

‘=’

birth-day-of-month - list of every person’s birthday in this date format.

variants:

len, num

aliases:

b-d-o-m

ascending:

True

default op:

‘=’

birth-day-of-week - list of every person’s birthday in this date format.

variants:

len, num

aliases:

b-d-o-w

ascending:

True

default op:

‘=’

birth-day-of-week-monday - list of every person’s birthday in this date format.

variants:

len, num

aliases:

b-d-o-w-m

ascending:

True

default op:

‘=’

birth-day-of-year - list of every person’s birthday in this date format.

variants:

len, num

aliases:

b-d-o-y

ascending:

True

default op:

‘=’

birth-month - list of every person’s birthday in this date format.

variants:

len, num

aliases:

b-m

ascending:

True

default op:

‘=’

birth-month-day - list of every person’s birthday in this date format.

variants:

len, num

aliases:

b-m-d

ascending:

True

default op:

‘=’

birth-week-of-year - list of every person’s birthday in this date format.

variants:

len, num

aliases:

b-w-o-y

ascending:

True

default op:

‘=’

birth-week-of-year-monday - list of every person’s birthday in this date format.

variants:

len, num

aliases:

b-w-o-y-m

ascending:

True

default op:

‘=’

birth-year - list of every person’s birthday in this date format.

variants:

len, num

aliases:

b-y

ascending:

False

default op:

‘=’

birth-year-month - list of every person’s birthday in this date format.

variants:

len, num

aliases:

b-y-m

ascending:

False

default op:

‘=’

countries - list of every person’s countries.

variants:

len, num

aliases:

country, nation, nations, nationality, nationalities

ascending:

True

default op:

‘~’

crew-type - the people’s crew type.

variants:

len, num

aliases:

ascending:

True

default op:

‘~’

death-date - list of every person’s death date in this date format.

variants:

len, num

aliases:

d-d

ascending:

False

default op:

‘=’

death-day-of-month - list of every person’s death date in this date format.

variants:

len, num

aliases:

d-d-o-m

ascending:

True

default op:

‘=’

death-day-of-week - list of every person’s death date in this date format.

variants:

len, num

aliases:

d-d-o-w

ascending:

True

default op:

‘=’

death-day-of-week-monday - list of every person’s death date in this date format.

variants:

len, num

aliases:

d-d-o-w-m

ascending:

True

default op:

‘=’

death-day-of-year - list of every person’s death date in this date format.

variants:

len, num

aliases:

d-d-o-y

ascending:

True

default op:

‘=’

death-month - list of every person’s death date in this date format.

variants:

len, num

aliases:

d-m

ascending:

True

default op:

‘=’

death-month-day - list of every person’s death date in this date format.

variants:

len, num

aliases:

d-m-d

ascending:

True

default op:

‘=’

death-reason - list of every person’s death reason.

variants:

len, num

aliases:

ascending:

True

default op:

‘~’

death-week-of-year - list of every person’s death date in this date format.

variants:

len, num

aliases:

d-w-o-y

ascending:

True

default op:

‘=’

death-week-of-year-monday - list of every person’s death date in this date format.

variants:

len, num

aliases:

d-w-o-y-m

ascending:

True

default op:

‘=’

death-year - list of every person’s death date in this date format.

variants:

len, num

aliases:

d-y

ascending:

False

default op:

‘=’

death-year-month - list of every person’s death date in this date format.

variants:

len, num

aliases:

d-y-m

ascending:

False

default op:

‘=’

gender - list of every person’s gender (the exact strings representing each gender may vary based on where the data was fetched from).

variants:

len, num

aliases:

sex

ascending:

True

default op:

‘~’

group-mode - the people’s group mode.

variants:

len, num

aliases:

ascending:

True

default op:

‘~’

height-cm - list of every person’s height in centimeters.

variants:

len, num, avg, sum

aliases:

height

ascending:

False

default op:

‘=’

movies - list of movie titles these people were in.

variants:

len, num

aliases:

titles, credits

ascending:

True

default op:

‘~’

movies-as-additional - list of movie titles these people were in as this crew type.

variants:

len, num

aliases:

titles-as-additional, credits-as-additional

ascending:

True

default op:

‘~’

movies-as-any - list of movie titles these people were in as this crew type.

variants:

len, num

aliases:

titles-as-any, credits-as-any

ascending:

True

default op:

‘~’

movies-as-art-director - list of movie titles these people were in as this crew type.

variants:

len, num

aliases:

titles-as-art-director, credits-as-art-director

ascending:

True

default op:

‘~’

movies-as-assistant-director - list of movie titles these people were in as this crew type.

variants:

len, num

aliases:

titles-as-assistant-director, credits-as-assistant-director

ascending:

True

default op:

‘~’

movies-as-cast - list of movie titles these people were in as this crew type.

variants:

len, num

aliases:

titles-as-cast, credits-as-cast

ascending:

True

default op:

‘~’

movies-as-casting-director - list of movie titles these people were in as this crew type.

variants:

len, num

aliases:

titles-as-casting-director, credits-as-casting-director

ascending:

True

default op:

‘~’

movies-as-choreographer - list of movie titles these people were in as this crew type.

variants:

len, num

aliases:

titles-as-choreographer, credits-as-choreographer

ascending:

True

default op:

‘~’

movies-as-cinematographer - list of movie titles these people were in as this crew type.

variants:

len, num

aliases:

titles-as-cinematographer, credits-as-cinematographer

ascending:

True

default op:

‘~’

movies-as-composer - list of movie titles these people were in as this crew type.

variants:

len, num

aliases:

titles-as-composer, credits-as-composer

ascending:

True

default op:

‘~’

movies-as-director - list of movie titles these people were in as this crew type.

variants:

len, num

aliases:

titles-as-director, credits-as-director

ascending:

True

default op:

‘~’

movies-as-editor - list of movie titles these people were in as this crew type.

variants:

len, num

aliases:

titles-as-editor, credits-as-editor

ascending:

True

default op:

‘~’

movies-as-executive-producer - list of movie titles these people were in as this crew type.

variants:

len, num

aliases:

titles-as-executive-producer, credits-as-executive-producer

ascending:

True

default op:

‘~’

movies-as-producer - list of movie titles these people were in as this crew type.

variants:

len, num

aliases:

titles-as-producer, credits-as-producer

ascending:

True

default op:

‘~’

movies-as-stuntcast - list of movie titles these people were in as this crew type.

variants:

len, num

aliases:

titles-as-stuntcast, credits-as-stuntcast

ascending:

True

default op:

‘~’

movies-as-writer - list of movie titles these people were in as this crew type.

variants:

len, num

aliases:

titles-as-writer, credits-as-writer

ascending:

True

default op:

‘~’

name - list of every person’s name.

variants:

len, num

aliases:

names, person, people

ascending:

True

default op:

‘~’

origin-uid - list of every person’s UID in the source from which the data is fetched.

variants:

len, num

aliases:

origin-id, origin-guid, origin-identifier

ascending:

True

default op:

‘~’

oscar-noms - list of Oscar nominations received by these people.

variants:

len, num

aliases:

oscar-nominations, noms, nominations

ascending:

True

default op:

‘~’

oscar-wins - list of Oscars won by these people.

variants:

len, num

aliases:

oscars, awards

ascending:

True

default op:

‘~’

professions - list of crew types occupied by these people.

variants:

len, num

aliases:

jobs, expertise

ascending:

True

default op:

‘~’

top-genres - list of up to 3 genres these people appear in the most.

variants:

len, num

aliases:

top-genre

ascending:

True

default op:

‘~’

uid - the people’s UID in flam.

variants:

len, num

aliases:

id, guid, identifier

ascending:

True

default op:

‘~’

Role attributes

In addition to the below, all movie and people attributes are also valid role attributes!

characters - list of characters played by this role (mainly for actors).

variants:

len, num

aliases:

character

ascending:

True

default op:

‘~’

episodes-num - the number of episodes this role appeared in.

variants:

len, num

aliases:

episodes

ascending:

False

default op:

‘=’

is-star - list of every person’s star status in this movie - i.e. true or false based on if that person is starring.

variants:

len, num

aliases:

star

ascending:

False

default op:

‘=’

jobs - list of jobs performed by this role (for crew type ADDITIONAL).

variants:

len, num

aliases:

job

ascending:

True

default op:

‘~’

oscar-noms - list of Oscar nominations received by this role.

variants:

len, num

aliases:

oscar-nominations, noms, nominations

ascending:

True

default op:

‘~’

oscar-wins - list of Oscar nominations received by this role.

variants:

len, num

aliases:

oscars, awards

ascending:

True

default op:

‘~’

uid - the role’s UID in flam.

variants:

len, num

aliases:

id, guid, identifier

ascending:

True

default op:

‘~’