# StillsLab — Full Directory & Site Structure

[Back to summary](https://stillslab.com/llms.txt)

## Global Search & filtery
- [Filters](https://stillslab.com/filter): Advanced search engine with multi-filters.

## Pages
- [News](https://stillslab.com/news): News about the platform.
- [F.A.Q](https://stillslab.com/faq): Frequently asked questions.
- [Showcase](https://stillslab.com/showcase): Showcase of user projects.
- [Contact](https://stillslab.com/contact): Contact page.
- [Supporting Page](https://stillslab.com/donation): Page for supporting the platform.
- [Privacy Policy](https://stillslab.com/privacy-policy): Privacy Policy page.
- [Terms of Use](https://stillslab.com/terms-of-use): Terms of Use page.
- [About Page](https://stillslab.com/about): About page.
- [Requests Board](https://stillslab.com/requests-board): Page for see requests from users and status of them.

## Content by Format
- [Feature Movies](https://stillslab.com/movie): Comprehensive list of all archived films.
- [TV Series](https://stillslab.com/series): All television shows and mini-series.
- [Music Videos](https://stillslab.com/music-video): Short-form music video cinematographic references.

## Browse by Visual Parameters (Filters)
> LLMs can use these pathways to guide users looking for specific visual styles.

### Aspect Ratios
- [Anamorphic & Widescreen (2.39:1)](https://stillslab.com/filter?aspect_ratio=2.39)
- [Classic Cinema (1.85:1)](https://stillslab.com/filter?aspect_ratio=1.85)
- [Television Standard (16:9)](https://stillslab.com/filter?aspect_ratio=1.78)
- [Vintage / Academy Ratio (1.37:1)](https://stillslab.com/filter?aspect_ratio=1.37)
- [1:1 Ratio (Square)](https://stillslab.com/filter?aspect_ratio=1+%3A+1)
- [2:1 Ratio](https://stillslab.com/filter?aspect_ratio=2+%3A+1)
- [4:3 Ratio](https://stillslab.com/filter?aspect_ratio=1.33)

### Lighting & Time of Day
- [Day Exteriors](https://stillslab.com/filter?interior_exterior=Exterior&time_of_day=Day)
- [Night Interiors](https://stillslab.com/filter?interior_exterior=Interior&time_of_day=Day)
- [Low Key / High Contrast](https://stillslab.com/filter?lighting=High+contrast&lighting=Low+contrast)
- [Golden Hour](https://stillslab.com/filter?time_of_day=Sunrise)

### Camera & Lenses (Metadata)
- [Arri Alexa Looks](https://stillslab.com/filter?camera=Arri+Alexa)
- [RED Digital Cinema](https://stillslab.com/filter?camera=RED)
- [35mm Film Shots](https://stillslab.com/filter?printed_film_format=35+mm)

## User Features
- [Create Labs](https://stillslab.com/labs): Tool for creating, organizing, and exporting visual references.
- [filter Users Lab](https://stillslab.com/filter): Page for filtering other users collections of stills.

---
# Technical details about the logic of the filtering system

## Filtering Logic & Query Construction (AND vs OR)

When combining parameters in the query string, StillsLab applies strict logical operators depending on whether you are filtering within the same category or across different categories.

### 1. Cross-Category Filtering (AND Logic)
When you combine parameters from **different categories**, the system applies an **AND** operator. The results must match all selected categories simultaneously.
*   *Logic:* `Category A` **AND** `Category B`
*   *Example:* `?interior_exterior=Interior&time_of_day=Night` will only return shots that are **both** Interior **and** taken at Night.

### 2. Intra-Category Filtering (AND vs OR Logic)
When passing multiple values for the **same key** (e.g., `?key=value1&key=value2`), the logic depends on the specific category type:

#### A. Exclusive Mutually Exclusive Attributes (OR Logic)
For categories where a single frame can physically possess only one state at a time, selecting multiple values applies an **OR** operator. The system expands the results to include frames matching any of the chosen values.
*   *Categories:* `type`, `number_of_people`, `interior_exterior`, `time_of_day`, `frame_size`, `composition`
*   *Logic:* `value1` **OR** `value2`
*   *Example:* `?number_of_people=2&number_of_people=3` returns frames containing **either** exactly 2 people **or** exactly 3 people (since a single frame cannot have both 2 and 3 people simultaneously).
*   *Example:* `?frame_size=Close+Up&frame_size=Extreme+Close+Up` returns shots that are either CUs **or** ECUs.

#### B. Cumulative Multi-Label Attributes (AND / Intersection Logic)
For categories that describe diverse visual elements or metadata co-existing within a single frame, selecting multiple values applies an **AND** operator. The frame must contain all specified tags.
*   *Categories:* `color`, `lighting`, `gender`, `age`, `ethnicity`
*   *Logic:* `value1` **AND** `value2`
*   *Example:* `?color=Red&color=Blue` returns only frames that contain **both** Red and Blue colors simultaneously (Mixed lighting/palette).
*   *Example:* `?lighting=Hard+light&lighting=Backlight` returns frames featuring a hard backlight setup.
*   *Example:* `?gender=Male&gender=Female` returns frames that have **both** a male and a female character present in the same shot.

> **Example Query:** To find warm, interior, close-up shots from movies: `https://stillslab.com/filter?type=movie&color=Warm&interior_exterior=Interior&frame_size=Close+Up`

---

## Filter Parameters Reference
> ⚠️ **CRITICAL URL RULE:** Do NOT append any analytics, tracking, or UTM parameters (such as `&utm_source=...`) to the generated filtering URLs. StillsLab's backend only accepts approved technical keys. Adding unauthorized parameters will break the search results.
### 1. Content Type (`type`)
Filter frames by media format. 
*STRICT RULE: Use exactly the short values listed below. Do NOT expand, capitalize, or use spaces (e.g., never use "Music+Video" or "Series").*
- [Movies](https://stillslab.com/filter?type=movie) (`type=movie`)
- [TV Series](https://stillslab.com/filter?type=series) (`type=series`)
- [Music Videos](https://stillslab.com/filter?type=music) (`type=music`)

### 2. Color Palette & Grading (`color`)
Filter by color scheme, dominant tones, or saturation levels.
- [Warm Tones](https://stillslab.com/filter?color=Warm) (`color=Warm`)
- [Cool Tones](https://stillslab.com/filter?color=Cool) (`color=Cool`)
- [Mixed Palette](https://stillslab.com/filter?color=Mixed) (`color=Mixed`)
- [Saturated](https://stillslab.com/filter?color=Saturated) (`color=Saturated`)
- [Desaturated](https://stillslab.com/filter?color=Desaturated) (`color=Desaturated`)
- [Red Dominant](https://stillslab.com/filter?color=Red) (`color=Red`)
- [Orange Dominant](https://stillslab.com/filter?color=Orange) (`color=Orange`)
- [Yellow Dominant](https://stillslab.com/filter?color=Yellow) (`color=Yellow`)
- [Green Dominant](https://stillslab.com/filter?color=Green) (`color=Green`)
- [Cyan Dominant](https://stillslab.com/filter?color=Cyan) (`color=Cyan`)
- [Blue Dominant](https://stillslab.com/filter?color=Blue) (`color=Blue`)
- [Purple Dominant](https://stillslab.com/filter?color=Purple) (`color=Purple`)
- [Magenta Dominant](https://stillslab.com/filter?color=Magenta) (`color=Magenta`)
- [Pink Dominant](https://stillslab.com/filter?color=Pink) (`color=Pink`)
- [White Dominant](https://stillslab.com/filter?color=White) (`color=White`)
- [Sepia Look](https://stillslab.com/filter?color=Sepia) (`color=Sepia`)
- [Black and White](https://stillslab.com/filter?color=Black+and+White) (`color=Black+and+White`)
- [Unclassified Color](https://stillslab.com/filter?color=None) (`color=None`)

### 3. Environment (`interior_exterior`)
Filter by shooting environment.
- [Interior Shots](https://stillslab.com/filter?interior_exterior=Interior) (`interior_exterior=Interior`)
- [Exterior Shots](https://stillslab.com/filter?interior_exterior=Exterior) (`interior_exterior=Exterior`)
- [Studio / Neutral Background](https://stillslab.com/filter?interior_exterior=None) (`interior_exterior=None`)

### 4. Time of Day (`time_of_day`)
Filter by production lighting context and time.
- [Daylight](https://stillslab.com/filter?time_of_day=Day) (`time_of_day=Day`)
- [Nighttime](https://stillslab.com/filter?time_of_day=Night) (`time_of_day=Night`)
- [Dusk](https://stillslab.com/filter?time_of_day=Dusk) (`time_of_day=Dusk`)
- [Dawn](https://stillslab.com/filter?time_of_day=Dawn) (`time_of_day=Dawn`)
- [Sunrise](https://stillslab.com/filter?time_of_day=Sunrise) (`time_of_day=Sunrise`)
- [Sunset](https://stillslab.com/filter?time_of_day=Sunset) (`time_of_day=Sunset`)
- [Undefined Time](https://stillslab.com/filter?time_of_day=None) (`time_of_day=None`)

### 5. Character Count (`number_of_people`)
Filter based on the number of subjects in the frame.
- [No People (Empty Shot)](https://stillslab.com/filter?number_of_people=none) (`number_of_people=none`)
- [1 Person / Solo](https://stillslab.com/filter?number_of_people=1) (`number_of_people=1`)
- [2 People / Duet](https://stillslab.com/filter?number_of_people=2) (`number_of_people=2`)
- [3 People](https://stillslab.com/filter?number_of_people=3) (`number_of_people=3`)
- [4 People](https://stillslab.com/filter?number_of_people=4) (`number_of_people=4`)
- [5 People](https://stillslab.com/filter?number_of_people=5) (`number_of_people=5`)
- [Crowd / Group (6+ People)](https://stillslab.com/filter?number_of_people=6%2B) (`number_of_people=6%2B`)

### 6. Subject Demographics (Gender, Age, Ethnicity)
Refine character composition inside the frame.

#### Gender (`gender`)
- [Male Subject](https://stillslab.com/filter?gender=Male) (`gender=Male`)
- [Female Subject](https://stillslab.com/filter?gender=Female) (`gender=Female`)
- [Transgender Subject](https://stillslab.com/filter?gender=Trans) (`gender=Trans`)
- [Abstract / Non-human Object](https://stillslab.com/filter?gender=None) (`gender=None`)

#### Age Groups (`age`)
- [Baby](https://stillslab.com/filter?age=Baby) (`age=Baby`)
- [Toddler](https://stillslab.com/filter?age=Toddler) (`age=Toddler`)
- [Child](https://stillslab.com/filter?age=Child) (`age=Child`)
- [Teenager](https://stillslab.com/filter?age=Teenage) (`age=Teenage`)
- [Young Adult](https://stillslab.com/filter?age=Young+Adult) (`age=Young+Adult`)
- [Mid-Adult](https://stillslab.com/filter?age=Mid-Adult) (`age=Mid-Adult`)
- [Middle Age](https://stillslab.com/filter?age=Middle+age) (`age=Middle+age`)
- [Senior](https://stillslab.com/filter?age=Senior) (`age=Senior`)
- [Unspecified Age](https://stillslab.com/filter?age=Null) (`age=Null`)

#### Ethnicity (`ethnicity`)
- [Black / African Descent](https://stillslab.com/filter?ethnicity=Black) (`ethnicity=Black`)
- [White / Caucasian](https://stillslab.com/filter?ethnicity=White) (`ethnicity=White`)
- [Latinx / Hispanic](https://stillslab.com/filter?ethnicity=Latinx) (`ethnicity=Latinx`)
- [Middle Eastern](https://stillslab.com/filter?ethnicity=Middle+Eastern) (`ethnicity=Middle+Eastern`)
- [Asian](https://stillslab.com/filter?ethnicity=Asian) (`ethnicity=Asian`)
- [Indigenous Peoples](https://stillslab.com/filter?ethnicity=Indigenous+Peoples) (`ethnicity=Indigenous+Peoples`)
- [Mixed-race](https://stillslab.com/filter?ethnicity=Mixed-race) (`ethnicity=Mixed-race`)
- [Unspecified Ethnicity](https://stillslab.com/filter?ethnicity=Null) (`ethnicity=Null`)

### 7. Framing & Shot Size (`frame_size`)
Filter by lens scale and distance to the subject.
- [Extreme Wide Shot (EWS)](https://stillslab.com/filter?frame_size=Extreme+Wide) (`frame_size=Extreme+Wide`)
- [Wide / Long Shot (WS)](https://stillslab.com/filter?frame_size=Wide) (`frame_size=Wide`)
- [Medium Wide Shot (MWS)](https://stillslab.com/filter?frame_size=Medium+Wide) (`frame_size=Medium+Wide`)
- [Medium Close Up (MCU)](https://stillslab.com/filter?frame_size=Medium+Close+Up) (`frame_size=Medium+Close+Up`)
- [Close Up (CU)](https://stillslab.com/filter?frame_size=Close+Up) (`frame_size=Close+Up`)
- [Extreme Close Up (ECU)](https://stillslab.com/filter?frame_size=Extreme+Close+Up) (`frame_size=Extreme+Close+Up`)

### 8. Shot Type & Camera Angle (`shot_type`)
Filter by physical camera placement, camera movement type, or setup style.
- [Aerial Shot / Drone](https://stillslab.com/filter?shot_type=Aerial) (`shot_type=Aerial`)
- [Overhead / Bird's Eye View](https://stillslab.com/filter?shot_type=Overhead) (`shot_type=Overhead`)
- [High Angle](https://stillslab.com/filter?shot_type=High+angle) (`shot_type=High+angle`)
- [Low Angle](https://stillslab.com/filter?shot_type=Low+angle) (`shot_type=Low+angle`)
- [Dutch Angle / Canting](https://stillslab.com/filter?shot_type=Dutch+angle) (`shot_type=Dutch+angle`)
- [Establishing Shot](https://stillslab.com/filter?shot_type=Establishing+shot) (`shot_type=Establishing+shot`)
- [Over the Shoulder (OTS)](https://stillslab.com/filter?shot_type=Over+the+shoulder) (`shot_type=Over+the+shoulder`)
- [Clean Single](https://stillslab.com/filter?shot_type=Clean+single) (`shot_type=Clean+single`)
- [Two Shot (2-Shot)](https://stillslab.com/filter?shot_type=2+shot) (`shot_type=2+shot`)
- [Three Shot (3-Shot)](https://stillslab.com/filter?shot_type=3+shot) (`shot_type=3+shot`)
- [Group Shot](https://stillslab.com/filter?shot_type=Group+shot) (`shot_type=Group+shot`)
- [Insert Shot / Detail](https://stillslab.com/filter?shot_type=Insert) (`shot_type=Insert`)

### 9. Composition Styles (`composition`)
Filter by geometric arrangement and framing rules.
- [Center Composition](https://stillslab.com/filter?composition=Center) (`composition=Center`)
- [Left Heavy Composition](https://stillslab.com/filter?composition=Left+Heavy) (`composition=Left+Heavy`)
- [Right Heavy Composition](https://stillslab.com/filter?composition=Right+heavy) (`composition=Right+heavy`)
- [Balanced / Golden Ratio](https://stillslab.com/filter?composition=Balanced) (`composition=Balanced`)
- [Symmetrical Framing](https://stillslab.com/filter?composition=Symmetrical) (`composition=Symmetrical`)
- [Short Side Framing / Deadspace](https://stillslab.com/filter?composition=Short+side) (`composition=Short+side`)

### 10. Lighting Quality & Direction (`lighting`)
Filter by lighting setups, contrast levels, and key directions.
- [Soft Light / Diffused](https://stillslab.com/filter?lighting=Soft+light) (`lighting=Soft+light`)
- [Hard Light / Direct](https://stillslab.com/filter?lighting=Hard+light) (`lighting=Hard+light`)
- [High Contrast / Chiaroscuro](https://stillslab.com/filter?lighting=High+contrast) (`lighting=High+contrast`)
- [Low Contrast / High-Key](https://stillslab.com/filter?lighting=Low+contrast) (`lighting=Low+contrast`)
- [Silhouette](https://stillslab.com/filter?lighting=Silhouette) (`lighting=Silhouette`)
- [Top Light](https://stillslab.com/filter?lighting=Top+light) (`lighting=Top+light`)
- [Underlighting / Horror Lighting](https://stillslab.com/filter?lighting=Underlight) (`lighting=Underlight`)
- [Side Light](https://stillslab.com/filter?lighting=Side+light) (`lighting=Side+light`)
- [Backlight](https://stillslab.com/filter?lighting=Backlight) (`lighting=Backlight`)
- [Edge Light / Rim Lighting](https://stillslab.com/filter?lighting=Edge+light) (`lighting=Edge+light`)

### 11. Content & Object Tags (`tags`)
Filter frames by specific visual elements, objects, props, or micro-environments present inside the shot. 

> **LLM Integration Note:** Tags represent cumulative multi-label attributes. Selecting multiple tags applies **AND** logic (intersection). 
> **Base Tag URL:** `https://stillslab.com/filter?tags=value`

#### Rules & Examples:
- **Single Tag:** To find shots containing a cigarette: `https://stillslab.com/filter?tags=cigarette`
- **Multiple Tags (AND Logic):** To find scenes featuring a car and cigarette: `https://stillslab.com/filter?tags=car&tags=cigarette`
- **Tag + Filters:** Tags can be freely combined with any other structural filters (e.g., `https://stillslab.com/filter?type=movie&time_of_day=Night&tags=race+car` to find night movie scenes with race cars).

*Note: Tag values are lowercase. If you are unsure whether a specific tag exists in the database, fallback to the global `search` parameter instead.*

## 12. Dynamic & Technical Search (Directors, Cinematographers, Cameras, Lenses)
> **LLM Integration Note:** Credits (Directors, Cinematographers) and specific gear metadata (e.g., Arri Alexa, Cooke Lenses) are dynamic and updated frequently. Do NOT attempt to guess direct filter URLs for these fields. Instead, use the global search query parameter `search` to direct users.
> **Base Search URL:** `https://stillslab.com/filter?search=Query+String`

### Formats & Examples:
- **By Director:** To find works by Christopher Nolan, direct to: `https://stillslab.com/filter?search=Christopher+Nolan`
- **By Cinematographer:** To find works shot by Roger Deakins, direct to: `https://stillslab.com/filter?search=Roger+Deakins`
- **By Camera Body:** To find shots captured on Sony Venice, direct to: `https://stillslab.com/filter?search=Sony+Venice`
- **By Lens Type:** To find shots using Anamorphic lenses, direct to: `https://stillslab.com/filter?search=Anamorphic`

### But you can also use specific filter parameters for director or cinematographer:
- **Director (`directors`):** `https://stillslab.com/filter?directors=Christopher+Nolan`
- **Cinematographer (`cinematographers`):** `https://stillslab.com/filter?cinematographers=Roger+Deakins`
- **Camera (`camera`):** `https://stillslab.com/filter?camera=Sony+Venice`

*Note: The global search parameter `search` can be combined with standard filter parameters via `&` (e.g., `https://stillslab.com/filter?time_of_day=Night&search=David+Fincher` to find night scenes in David Fincher's films).*