mcpField
F
find-footage

find-footage

github.com/reelaryCreative & media1508 installsUpdated 6d ago
Repository

About find-footage

A skill for searching indexed Reelary footage and photos, then reporting matching files and time ranges. It guides visual queries and includes Pro workflows for finding dialogue, people, and places.

Key features

  1. 01Search footage by visual description
  2. 02Inspect image results with thumbnails
  3. 03Refine weak searches with rephrasing
  4. 04Find dialogue, people, and places with Pro

Use cases

  1. 01Locate a shot for an edit
  2. 02Find photos or video frames by subject
  3. 03Retrieve a spoken quote from footage
  4. 04Find clips featuring a person or place

MCP support

Uses Reelary MCP tools such as reelary_search and, for specialized searches, reelary_list_people and reelary_list_places. Without MCP, it describes using the Reelary CLI.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/reelary/skills --skill find-footage

After installing, type/find-footagein Claude Code to confirm it loaded.

Details

From the project README

Find footage

If the reelary_* tools are missing or nothing is indexed, use the reelary skill first. All searches go through reelary_search, which returns full paths with start and end seconds. Quote times as mm:ss.

Without MCP: npx -y reelary search "<query>" --json.

A shot

  1. Describe what is visible: subject, action, setting, light, camera ("close-up of hands kneading dough, warm light"). Use include_thumbnails: true when you need to check the picks yourself.
  2. If results are weak, try 2-3 rephrasings (synonyms, wider or tighter framing) before giving up.
  3. Report the top matches: full path, mm:ss-mm:ss, one line on why it fits. Offer reelary_open_in_app or a cut with rough-cut.

Photos

  1. Search with a visual description and include_thumbnails: true. Results with kind: "image" are photos.
  2. List the best photos with full paths; mention if only video frames matched.

A quote someone said (Pro)

  1. Search with the words or topic, close to how it would be spoken. Results with match=dialogue (CLI: a speech field) include the transcript line.
  2. Report each hit: path, mm:ss and the quoted line.
  3. If only visual matches come back and reelary_status shows the free plan, explain dialogue search is Pro and share the upgrade link once.

Transcripts are built in the background after indexing; very recent files may not be searchable yet.

A person (Pro)

  1. reelary_list_people to see recognised people (id, name, number of clips).
  2. If the person is unnamed, ask the user to name them in Reelary (reelary_open_in_app), or pick by id after showing covers.
  3. reelary_person_clips with the id; report paths and time ranges. Once named, searching the name also works.

Without MCP: open Reelary's People view (npx -y reelary open).

A place or drone footage (Pro)

  1. For a place name, search it ("Lisbon"); files shot there match by place name.
  2. For an overview, reelary_list_places and group by place.
  3. Report paths with place names. Offer a trip montage with rough-cut.

Files without GPS can be placed by hand in Reelary's map view. On pro_required, share the upgrade link once.

Comments

Markdown supported