Workflows
How to Use Advanced Search Operators to Find the Right Clip Faster
Basic keyword search gets you started. Exact phrases, @mentions, exclusions, and boolean operators get you to the specific clip you need in a library of thousands.
Typing a word into a search bar and scrolling through results works when your library is small. When you have a thousand clips, or ten thousand, scrolling stops being a strategy. You need to tell the search engine exactly what you mean.
FrameQuery supports a set of search operators that let you write precise queries. They are not complicated, but knowing they exist changes how quickly you can find the right clip.
Exact phrase search
By default, searching for multiple words finds clips that contain all of those words, but not necessarily together or in order. Searching for quarterly revenue will match a clip where someone says "the quarterly report showed strong revenue growth" as well as one where someone mentions "revenue" in one sentence and "quarterly" two minutes later.
Wrapping your search in quotes forces an exact phrase match. "quarterly revenue" only matches clips where those two words appear together in that order. This is the simplest and most frequently useful operator.
When to use it: any time you are looking for a specific phrase, title, name, or expression. "product launch" is almost always more useful than product launch when you know the exact words you are looking for.
@mention search
The @ operator finds clips featuring a specific person. Type @Sarah and FrameQuery returns every clip where Sarah appears on screen (via face recognition) or speaks (via speaker identification).
This works because FrameQuery identifies people across your footage during processing. Once a person is recognized, their name becomes searchable with the @ prefix.
The real power comes from combining @ with other search terms. @Sarah returns every clip Sarah appears in. @Sarah "product launch" returns only the clips where Sarah is present and the product launch is discussed. @Sarah @James returns clips where both Sarah and James appear.
When to use it: finding a specific person's appearances, finding conversations between specific people, or narrowing a topic search to a particular speaker.
Exclusion operator
The - prefix excludes clips matching a term. This is invaluable when your search returns results that are technically correct but not what you want.
interview -behind-the-scenes finds interviews but removes any clips tagged or described as behind-the-scenes content. "product demo" -rehearsal finds the actual demos and skips the practice runs. @CEO -town-hall finds CEO appearances outside of the regular town hall meetings.
Exclusions work with any term, including exact phrases and @mentions. -"work in progress" excludes clips containing that exact phrase. -@James excludes clips where James appears.
When to use it: any time your search returns a mix of results and you can identify a pattern in the ones you do not want. Rather than scrolling past unwanted clips, exclude them from the query.
Boolean OR
By default, multiple search terms are combined with AND logic. Every term must match. Sometimes you want either/or matching instead.
CEO OR director finds clips mentioning either title. "Q3 results" OR "third quarter results" catches both phrasings. @Sarah OR @James finds clips featuring either person.
OR must be capitalized. Lowercase or is treated as a regular search word.
When to use it: when the thing you are looking for might be described in different ways, when you want to combine related terms into a single search, or when you are looking for any of several people.
Combining operators
Each operator is useful on its own. Together, they let you write queries that would otherwise require manual filtering through dozens of results.
Here is a realistic example. You are looking for a specific clip: Sarah's presentation about Q3 results, not the rehearsal, from the London office.
Breaking it down:
@Sarah- find Sarah"Q3 results"- about this specific topic-rehearsal- not the practice run
Combined: @Sarah "Q3 results" -rehearsal
That query, which takes five seconds to type, replaces what might otherwise be ten minutes of scrolling through every clip Sarah appears in, trying to remember which one was the real presentation and which was the run-through.
Another example. You need b-roll of either the office or the warehouse, but not the construction footage from when the warehouse was being renovated.
office OR warehouse -construction
Or: you need every clip where the CEO or CFO discusses revenue, but not from the internal town hall recordings.
@CEO OR @CFO revenue -town-hall
Field-specific search
Beyond the operators above, FrameQuery lets you narrow your search to specific content modalities. Instead of searching across everything, you can search within:
- Transcripts only: Find clips based on what was said, ignoring visual content
- Scenes only: Find clips based on what was shown, ignoring spoken words
- Filenames only: Find clips based on their file or folder names
- Objects only: Find clips containing specific objects detected in the footage
This matters when a broad search returns too many false positives. If you search for "whiteboard" and get results from both transcripts (someone mentioned a whiteboard) and scenes (a whiteboard was visible), you can narrow to scene-only search to find clips where a whiteboard actually appears on screen.
Building effective queries
A few practical tips for getting better results:
Start broad, then refine. Run a simple keyword search first to see what comes back. If there are too many results, add operators to narrow. If there are too few, try OR to broaden, or remove a constraint.
Use quotes more than you think you need to. Exact phrase matching is almost always more precise than individual word matching. Default to quotes for any multi-word concept.
Use exclusions to remove known noise. If you know a certain category of results is cluttering your search, exclude it. This is faster than mentally filtering while scrolling.
Save queries you use repeatedly. FrameQuery's saved search feature stores your full query, including all operators. If you find yourself typing the same complex query regularly, save it for one-click reuse.
Find the right clip in seconds instead of minutes. Join the waitlist to try advanced search operators with your own footage.