usage: flam find [-h] [-s ATTRIBUTES] [-c ATTRIBUTES] [-l ATTRIBUTES]
[-C {always,auto,never}] [-d DELIM] [-v] [-r] [-S]
[-P {always,auto,never}] [-t]
FINDABLE [LISTDEF ...] [FILTER ...]
Explore "findables" (movies, people, or roles) in your movie lists, and query for specific ones which answer to some filter.
Found objects are printed in a nice table format, and you can customize what is printed and how it's sorted.
positional arguments:
FINDABLE Choose what to find: movies, people, or roles.
People and roles support limiting the search to a specific crew type with an optional group mode, or comma-delimited several types. Use 'crew' to catenate all types.
For roles, it looks like: 'cast', 'director:group', 'composer:separate,stuntcast', 'crew', etc.
For people, it looks like 'cast-people', 'director-people:group', etc.
Supported crew types: director, assistant-director, producer, executive-producer, composer, cinematographer, choreographer, editor, writer, cast, stuntcast, casting-director, art-director, additional, any
Read more about findables: https://verpous.github.io/film-flam/findables.html
LISTDEF Which lists to search in. They must've been previously fetched. By default searches in all lists configured with --default-find.
Read more about supported LISTDEFs: https://verpous.github.io/film-flam/lists.html.
FILTER Search only for findables which pass FILTER.
Read more about filters: https://verpous.github.io/film-flam/filters.html.
options:
-h, --help show this help message and exit
-s ATTRIBUTES, --sort ATTRIBUTES
Sort FINDABLEs according to ATTRIBUTES, which is a comma-delimited list of attributes to sort by, in decreasing priority.
Each findable type has its own default:
movies release-year,title
people crew-type,group-mode,num-movies,name
roles crew-type,group-mode,num-movies,name,release-year,title
For a full list of supported attributes: https://verpous.github.io/film-flam/attributes.html.
-c ATTRIBUTES, --columns ATTRIBUTES
Comma-delimited list of attributes of FINDABLE to print.
If ATTRIBUTES starts with a '+' then they will be printed in addition to the defaults instead of instead.
-l ATTRIBUTES, --split ATTRIBUTES
Comma-delimited list of attributes. If their type is a list, each element will be split into a separate entry.
-C {always,auto,never}, --color {always,auto,never}
Set whether columns should be colored. Defaults to auto.
-d DELIM, --dsv DELIM
Output in delimiter-separated values format (DSV). I.e. if DELIM is ',' then that is CSV format.
-v, --verbose Use verbose output, where long strings are not truncated and some attributes may be printed in longer format.
-r, --reverse Reverse the sort order. By default some sort keys are ascending and some descending based on what makes sense. This reverses those defaults.
-S, --spacious Add an empty line between entries.
-P {always,auto,never}, --paginate {always,auto,never}
Choose whether to paginate with `less`. Defaults to auto, which depends on the size of the output.
-t, --no-titles Don't print a row with the column titles.
Examples:
flam find movies
(Find movies in the default lists)
flam find cast shows -is-star true
(Find starring roles in the list 'shows')
flam find --sort height director-people:separate,writer-people:separate -height +160 -height -180
(Find directors and writers whose height is between 160 and 180 centimeters and sort them by their height)
flam find --columns +watch-date movies -metascore +70 -o -every-role [ writer director ] -gender female
(Find movies with a metascore above 70 or which were written and directed by women, and print their watch date alongside default columns)