PlanOpticon

planopticon / guide / single-video / index.html

Source Rendered

Blame History Raw 2290 lines

1
2	`<!doctype html>`
3	`<html lang="en" class="no-js">`
4	`<head>`
5
6	`<meta charset="utf-8">`
7	`<meta name="viewport" content="width=device-width,initial-scale=1">`
8
9	`<meta name="description" content="AI-powered video analysis and knowledge extraction">`
10
11
12	`<meta name="author" content="CONFLICT LLC">`
13
14
15	`<link rel="canonical" href="https://planopticon.dev/guide/single-video/">`
16
17
18	`<link rel="prev" href="../../getting-started/configuration/">`
19
20
21	`<link rel="next" href="../batch/">`
22
23
24
25
26
27	`<link rel="icon" href="../../assets/images/favicon.png">`
28	`<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.4">`
29
30
31
32	`<title>Single Video Analysis - PlanOpticon</title>`
33
34
35
36	`<link rel="stylesheet" href="../../assets/stylesheets/main.484c7ddc.min.css">`
37
38
39	`<link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.min.css">`
40
41
42
43
44
45
46
47
48
49
50
51
52	`<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>`
53	`<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">`
54	`<style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>`
55
56
57
58	`<link rel="stylesheet" href="../../assets/_mkdocstrings.css">`
59
60	`<link rel="stylesheet" href="../../assets/css/custom.css">`
61
62	`<script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>`
63
64
65
66
67
68	`</head>`
69
70
71
72
73
74
75
76
77
78	`<body dir="ltr" data-md-color-scheme="slate" data-md-color-primary="custom" data-md-color-accent="custom">`
79
80
81	`<input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">`
82	`<input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">`
83	`<label class="md-overlay" for="__drawer"></label>`
84	`<div data-md-component="skip">`
85
86
87	`<a href="#single-video-analysis" class="md-skip">`
88	`Skip to content`
89	`</a>`
90
91	`</div>`
92	`<div data-md-component="announce">`
93
94	`</div>`
95
96
97
98
99	`<header class="md-header" data-md-component="header">`
100	`<nav class="md-header__inner md-grid" aria-label="Header">`
101	`<a href="../.." title="PlanOpticon" class="md-header__button md-logo" aria-label="PlanOpticon" data-md-component="logo">`
102
103	`<img src="../../assets/images/conflict-logo.svg" alt="logo">`
104
105	`</a>`
106	`<label class="md-header__button md-icon" for="__drawer">`
107
108	`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg>`
109	`</label>`
110	`<div class="md-header__title" data-md-component="header-title">`
111	`<div class="md-header__ellipsis">`
112	`<div class="md-header__topic">`
113	`<span class="md-ellipsis">`
114	`PlanOpticon`
115	`</span>`
116	`</div>`
117	`<div class="md-header__topic" data-md-component="header-topic">`
118	`<span class="md-ellipsis">`
119
120	`Single Video Analysis`
121
122	`</span>`
123	`</div>`
124	`</div>`
125	`</div>`
126
127
128	`<form class="md-header__option" data-md-component="palette">`
129
130
131
132
133	`<input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="custom" data-md-color-accent="custom" aria-label="Switch to light mode" type="radio" name="__palette" id="__palette_0">`
134
135	`<label class="md-header__button md-icon" title="Switch to light mode" for="__palette_1" hidden>`
136	`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12s-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>`
137	`</label>`
138
139
140
141
142
143	`<input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="custom" data-md-color-accent="custom" aria-label="Switch to dark mode" type="radio" name="__palette" id="__palette_1">`
144
145	`<label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_0" hidden>`
146	`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>`
147	`</label>`
148
149
150	`</form>`
151
152
153
154	<script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
155
156
157
158
159
160	`<label class="md-header__button md-icon" for="__search">`
161
162	`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>`
163	`</label>`
164	`<div class="md-search" data-md-component="search" role="dialog">`
165	`<label class="md-search__overlay" for="__search"></label>`
166	`<div class="md-search__inner" role="search">`
167	`<form class="md-search__form" name="search">`
168	`<input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>`
169	`<label class="md-search__icon md-icon" for="__search">`
170
171	`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>`
172
173	`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg>`
174	`</label>`
175	`<nav class="md-search__options" aria-label="Search">`
176
177	`<button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">`
178
179	`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>`
180	`</button>`
181	`</nav>`
182
183	`<div class="md-search__suggest" data-md-component="search-suggest"></div>`
184
185	`</form>`
186	`<div class="md-search__output">`
187	`<div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>`
188	`<div class="md-search-result" data-md-component="search-result">`
189	`<div class="md-search-result__meta">`
190	`Initializing search`
191	`</div>`
192	`<ol class="md-search-result__list" role="presentation"></ol>`
193	`</div>`
194	`</div>`
195	`</div>`
196	`</div>`
197	`</div>`
198
199
200
201	`<div class="md-header__source">`
202	`<a href="https://github.com/ConflictHQ/PlanOpticon" title="Go to repository" class="md-source" data-md-component="source">`
203	`<div class="md-source__icon md-icon">`
204
205	<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
206	`</div>`
207	`<div class="md-source__repository">`
208	`ConflictHQ/PlanOpticon`
209	`</div>`
210	`</a>`
211	`</div>`
212
213	`</nav>`
214
215	`</header>`
216
217	`<div class="md-container" data-md-component="container">`
218
219
220
221
222
223	`<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">`
224	`<div class="md-grid">`
225	`<ul class="md-tabs__list">`
226
227
228
229
230
231
232	`<li class="md-tabs__item">`
233	`<a href="../.." class="md-tabs__link">`
234
235
236
237
238
239	`Home`
240
241	`</a>`
242	`</li>`
243
244
245
246
247
248
249
250
251
252
253	`<li class="md-tabs__item">`
254	`<a href="../../getting-started/installation/" class="md-tabs__link">`
255
256
257
258	`Getting Started`
259
260	`</a>`
261	`</li>`
262
263
264
265
266
267
268
269
270
271
272
273
274
275	`<li class="md-tabs__item md-tabs__item--active">`
276	`<a href="./" class="md-tabs__link">`
277
278
279
280	`User Guide`
281
282	`</a>`
283	`</li>`
284
285
286
287
288
289
290
291
292
293	`<li class="md-tabs__item">`
294	`<a href="../../use-cases/" class="md-tabs__link">`
295
296
297
298
299
300	`Use Cases`
301
302	`</a>`
303	`</li>`
304
305
306
307
308
309
310
311
312	`<li class="md-tabs__item">`
313	`<a href="../../cli-reference/" class="md-tabs__link">`
314
315
316
317
318
319	`CLI Reference`
320
321	`</a>`
322	`</li>`
323
324
325
326
327
328
329
330
331
332
333	`<li class="md-tabs__item">`
334	`<a href="../../architecture/overview/" class="md-tabs__link">`
335
336
337
338	`Architecture`
339
340	`</a>`
341	`</li>`
342
343
344
345
346
347
348
349
350
351
352
353	`<li class="md-tabs__item">`
354	`<a href="../../api/models/" class="md-tabs__link">`
355
356
357
358	`API Reference`
359
360	`</a>`
361	`</li>`
362
363
364
365
366
367
368
369
370
371	`<li class="md-tabs__item">`
372	`<a href="../../faq/" class="md-tabs__link">`
373
374
375
376
377
378	`FAQ & Troubleshooting`
379
380	`</a>`
381	`</li>`
382
383
384
385
386
387
388
389
390	`<li class="md-tabs__item">`
391	`<a href="../../contributing/" class="md-tabs__link">`
392
393
394
395
396
397	`Contributing`
398
399	`</a>`
400	`</li>`
401
402
403
404	`</ul>`
405	`</div>`
406	`</nav>`
407
408
409
410	`<main class="md-main" data-md-component="main">`
411	`<div class="md-main__inner md-grid">`
412
413
414
415	`<div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >`
416	`<div class="md-sidebar__scrollwrap">`
417	`<div class="md-sidebar__inner">`
418
419
420
421
422
423
424	`<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">`
425	`<label class="md-nav__title" for="__drawer">`
426	`<a href="../.." title="PlanOpticon" class="md-nav__button md-logo" aria-label="PlanOpticon" data-md-component="logo">`
427
428	`<img src="../../assets/images/conflict-logo.svg" alt="logo">`
429
430	`</a>`
431	`PlanOpticon`
432	`</label>`
433
434	`<div class="md-nav__source">`
435	`<a href="https://github.com/ConflictHQ/PlanOpticon" title="Go to repository" class="md-source" data-md-component="source">`
436	`<div class="md-source__icon md-icon">`
437
438	<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
439	`</div>`
440	`<div class="md-source__repository">`
441	`ConflictHQ/PlanOpticon`
442	`</div>`
443	`</a>`
444	`</div>`
445
446	`<ul class="md-nav__list" data-md-scrollfix>`
447
448
449
450
451
452
453
454	`<li class="md-nav__item">`
455	`<a href="../.." class="md-nav__link">`
456
457
458
459	`<span class="md-ellipsis">`
460
461
462	`Home`
463
464
465
466	`</span>`
467
468
469
470	`</a>`
471	`</li>`
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491	`<li class="md-nav__item md-nav__item--nested">`
492
493
494
495
496
497	`<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2" >`
498
499
500	`<label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">`
501
502
503
504	`<span class="md-ellipsis">`
505
506
507	`Getting Started`
508
509
510
511	`</span>`
512
513
514
515	`<span class="md-nav__icon md-icon"></span>`
516	`</label>`
517
518	`<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">`
519	`<label class="md-nav__title" for="__nav_2">`
520	`<span class="md-nav__icon md-icon"></span>`
521
522
523	`Getting Started`
524
525
526	`</label>`
527	`<ul class="md-nav__list" data-md-scrollfix>`
528
529
530
531
532
533
534
535	`<li class="md-nav__item">`
536	`<a href="../../getting-started/installation/" class="md-nav__link">`
537
538
539
540	`<span class="md-ellipsis">`
541
542
543	`Installation`
544
545
546
547	`</span>`
548
549
550
551	`</a>`
552	`</li>`
553
554
555
556
557
558
559
560
561
562
563	`<li class="md-nav__item">`
564	`<a href="../../getting-started/quickstart/" class="md-nav__link">`
565
566
567
568	`<span class="md-ellipsis">`
569
570
571	`Quick Start`
572
573
574
575	`</span>`
576
577
578
579	`</a>`
580	`</li>`
581
582
583
584
585
586
587
588
589
590
591	`<li class="md-nav__item">`
592	`<a href="../../getting-started/configuration/" class="md-nav__link">`
593
594
595
596	`<span class="md-ellipsis">`
597
598
599	`Configuration`
600
601
602
603	`</span>`
604
605
606
607	`</a>`
608	`</li>`
609
610
611
612
613	`</ul>`
614	`</nav>`
615
616	`</li>`
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641	`<li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">`
642
643
644
645	`<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" checked>`
646
647
648	`<label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">`
649
650
651
652	`<span class="md-ellipsis">`
653
654
655	`User Guide`
656
657
658
659	`</span>`
660
661
662
663	`<span class="md-nav__icon md-icon"></span>`
664	`</label>`
665
666	`<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="true">`
667	`<label class="md-nav__title" for="__nav_3">`
668	`<span class="md-nav__icon md-icon"></span>`
669
670
671	`User Guide`
672
673
674	`</label>`
675	`<ul class="md-nav__list" data-md-scrollfix>`
676
677
678
679
680
681
682
683
684
685	`<li class="md-nav__item md-nav__item--active">`
686
687	`<input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">`
688
689
690
691
692
693	`<label class="md-nav__link md-nav__link--active" for="__toc">`
694
695
696
697	`<span class="md-ellipsis">`
698
699
700	`Single Video Analysis`
701
702
703
704	`</span>`
705
706
707
708	`<span class="md-nav__icon md-icon"></span>`
709	`</label>`
710
711	`<a href="./" class="md-nav__link md-nav__link--active">`
712
713
714
715	`<span class="md-ellipsis">`
716
717
718	`Single Video Analysis`
719
720
721
722	`</span>`
723
724
725
726	`</a>`
727
728
729
730	`<nav class="md-nav md-nav--secondary" aria-label="Table of contents">`
731
732
733
734
735
736
737	`<label class="md-nav__title" for="__toc">`
738	`<span class="md-nav__icon md-icon"></span>`
739	`Table of contents`
740	`</label>`
741	`<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>`
742
743	`<li class="md-nav__item">`
744	`<a href="#basic-usage" class="md-nav__link">`
745	`<span class="md-ellipsis">`
746
747	`Basic usage`
748
749	`</span>`
750	`</a>`
751
752	`</li>`
753
754	`<li class="md-nav__item">`
755	`<a href="#what-happens" class="md-nav__link">`
756	`<span class="md-ellipsis">`
757
758	`What happens`
759
760	`</span>`
761	`</a>`
762
763	`</li>`
764
765	`<li class="md-nav__item">`
766	`<a href="#processing-depth" class="md-nav__link">`
767	`<span class="md-ellipsis">`
768
769	`Processing depth`
770
771	`</span>`
772	`</a>`
773
774	`<nav class="md-nav" aria-label="Processing depth">`
775	`<ul class="md-nav__list">`
776
777	`<li class="md-nav__item">`
778	`<a href="#basic" class="md-nav__link">`
779	`<span class="md-ellipsis">`
780
781	`basic`
782
783	`</span>`
784	`</a>`
785
786	`</li>`
787
788	`<li class="md-nav__item">`
789	`<a href="#standard-default" class="md-nav__link">`
790	`<span class="md-ellipsis">`
791
792	`standard (default)`
793
794	`</span>`
795	`</a>`
796
797	`</li>`
798
799	`<li class="md-nav__item">`
800	`<a href="#comprehensive" class="md-nav__link">`
801	`<span class="md-ellipsis">`
802
803	`comprehensive`
804
805	`</span>`
806	`</a>`
807
808	`</li>`
809
810	`</ul>`
811	`</nav>`
812
813	`</li>`
814
815	`<li class="md-nav__item">`
816	`<a href="#command-line-options" class="md-nav__link">`
817	`<span class="md-ellipsis">`
818
819	`Command-line options`
820
821	`</span>`
822	`</a>`
823
824	`<nav class="md-nav" aria-label="Command-line options">`
825	`<ul class="md-nav__list">`
826
827	`<li class="md-nav__item">`
828	`<a href="#provider-and-model-selection" class="md-nav__link">`
829	`<span class="md-ellipsis">`
830
831	`Provider and model selection`
832
833	`</span>`
834	`</a>`
835
836	`</li>`
837
838	`<li class="md-nav__item">`
839	`<a href="#speaker-diarization-hints" class="md-nav__link">`
840	`<span class="md-ellipsis">`
841
842	`Speaker diarization hints`
843
844	`</span>`
845	`</a>`
846
847	`</li>`
848
849	`<li class="md-nav__item">`
850	`<a href="#custom-prompt-templates" class="md-nav__link">`
851	`<span class="md-ellipsis">`
852
853	`Custom prompt templates`
854
855	`</span>`
856	`</a>`
857
858	`</li>`
859
860	`<li class="md-nav__item">`
861	`<a href="#output-format" class="md-nav__link">`
862	`<span class="md-ellipsis">`
863
864	`Output format`
865
866	`</span>`
867	`</a>`
868
869	`</li>`
870
871	`<li class="md-nav__item">`
872	`<a href="#frame-extraction-tuning" class="md-nav__link">`
873	`<span class="md-ellipsis">`
874
875	`Frame extraction tuning`
876
877	`</span>`
878	`</a>`
879
880	`</li>`
881
882	`</ul>`
883	`</nav>`
884
885	`</li>`
886
887	`<li class="md-nav__item">`
888	`<a href="#output-structure" class="md-nav__link">`
889	`<span class="md-ellipsis">`
890
891	`Output structure`
892
893	`</span>`
894	`</a>`
895
896	`</li>`
897
898	`<li class="md-nav__item">`
899	`<a href="#output-manifest" class="md-nav__link">`
900	`<span class="md-ellipsis">`
901
902	`Output manifest`
903
904	`</span>`
905	`</a>`
906
907	`</li>`
908
909	`<li class="md-nav__item">`
910	`<a href="#checkpoint-and-resume" class="md-nav__link">`
911	`<span class="md-ellipsis">`
912
913	`Checkpoint and resume`
914
915	`</span>`
916	`</a>`
917
918	`</li>`
919
920	`<li class="md-nav__item">`
921	`<a href="#using-results-after-analysis" class="md-nav__link">`
922	`<span class="md-ellipsis">`
923
924	`Using results after analysis`
925
926	`</span>`
927	`</a>`
928
929	`<nav class="md-nav" aria-label="Using results after analysis">`
930	`<ul class="md-nav__list">`
931
932	`<li class="md-nav__item">`
933	`<a href="#query-the-knowledge-graph" class="md-nav__link">`
934	`<span class="md-ellipsis">`
935
936	`Query the knowledge graph`
937
938	`</span>`
939	`</a>`
940
941	`</li>`
942
943	`<li class="md-nav__item">`
944	`<a href="#classify-entities-for-planning" class="md-nav__link">`
945	`<span class="md-ellipsis">`
946
947	`Classify entities for planning`
948
949	`</span>`
950	`</a>`
951
952	`</li>`
953
954	`<li class="md-nav__item">`
955	`<a href="#export-to-other-formats" class="md-nav__link">`
956	`<span class="md-ellipsis">`
957
958	`Export to other formats`
959
960	`</span>`
961	`</a>`
962
963	`</li>`
964
965	`<li class="md-nav__item">`
966	`<a href="#use-with-the-planning-agent" class="md-nav__link">`
967	`<span class="md-ellipsis">`
968
969	`Use with the planning agent`
970
971	`</span>`
972	`</a>`
973
974	`</li>`
975
976	`</ul>`
977	`</nav>`
978
979	`</li>`
980
981	`</ul>`
982
983	`</nav>`
984
985	`</li>`
986
987
988
989
990
991
992
993
994
995
996	`<li class="md-nav__item">`
997	`<a href="../batch/" class="md-nav__link">`
998
999
1000
1001	`<span class="md-ellipsis">`
1002
1003
1004	`Batch Processing`
1005
1006
1007
1008	`</span>`
1009
1010
1011
1012	`</a>`
1013	`</li>`
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024	`<li class="md-nav__item">`
1025	`<a href="../document-ingestion/" class="md-nav__link">`
1026
1027
1028
1029	`<span class="md-ellipsis">`
1030
1031
1032	`Document Ingestion`
1033
1034
1035
1036	`</span>`
1037
1038
1039
1040	`</a>`
1041	`</li>`
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052	`<li class="md-nav__item">`
1053	`<a href="../cloud-sources/" class="md-nav__link">`
1054
1055
1056
1057	`<span class="md-ellipsis">`
1058
1059
1060	`Cloud Sources`
1061
1062
1063
1064	`</span>`
1065
1066
1067
1068	`</a>`
1069	`</li>`
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080	`<li class="md-nav__item">`
1081	`<a href="../knowledge-graphs/" class="md-nav__link">`
1082
1083
1084
1085	`<span class="md-ellipsis">`
1086
1087
1088	`Knowledge Graphs`
1089
1090
1091
1092	`</span>`
1093
1094
1095
1096	`</a>`
1097	`</li>`
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108	`<li class="md-nav__item">`
1109	`<a href="../companion/" class="md-nav__link">`
1110
1111
1112
1113	`<span class="md-ellipsis">`
1114
1115
1116	`Interactive Companion`
1117
1118
1119
1120	`</span>`
1121
1122
1123
1124	`</a>`
1125	`</li>`
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136	`<li class="md-nav__item">`
1137	`<a href="../planning-agent/" class="md-nav__link">`
1138
1139
1140
1141	`<span class="md-ellipsis">`
1142
1143
1144	`Planning Agent`
1145
1146
1147
1148	`</span>`
1149
1150
1151
1152	`</a>`
1153	`</li>`
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164	`<li class="md-nav__item">`
1165	`<a href="../authentication/" class="md-nav__link">`
1166
1167
1168
1169	`<span class="md-ellipsis">`
1170
1171
1172	`Authentication`
1173
1174
1175
1176	`</span>`
1177
1178
1179
1180	`</a>`
1181	`</li>`
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192	`<li class="md-nav__item">`
1193	`<a href="../export/" class="md-nav__link">`
1194
1195
1196
1197	`<span class="md-ellipsis">`
1198
1199
1200	`Export & Documents`
1201
1202
1203
1204	`</span>`
1205
1206
1207
1208	`</a>`
1209	`</li>`
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220	`<li class="md-nav__item">`
1221	`<a href="../output-formats/" class="md-nav__link">`
1222
1223
1224
1225	`<span class="md-ellipsis">`
1226
1227
1228	`Output Formats`
1229
1230
1231
1232	`</span>`
1233
1234
1235
1236	`</a>`
1237	`</li>`
1238
1239
1240
1241
1242	`</ul>`
1243	`</nav>`
1244
1245	`</li>`
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255	`<li class="md-nav__item">`
1256	`<a href="../../use-cases/" class="md-nav__link">`
1257
1258
1259
1260	`<span class="md-ellipsis">`
1261
1262
1263	`Use Cases`
1264
1265
1266
1267	`</span>`
1268
1269
1270
1271	`</a>`
1272	`</li>`
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282	`<li class="md-nav__item">`
1283	`<a href="../../cli-reference/" class="md-nav__link">`
1284
1285
1286
1287	`<span class="md-ellipsis">`
1288
1289
1290	`CLI Reference`
1291
1292
1293
1294	`</span>`
1295
1296
1297
1298	`</a>`
1299	`</li>`
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319	`<li class="md-nav__item md-nav__item--nested">`
1320
1321
1322
1323
1324
1325	`<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6" >`
1326
1327
1328	`<label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">`
1329
1330
1331
1332	`<span class="md-ellipsis">`
1333
1334
1335	`Architecture`
1336
1337
1338
1339	`</span>`
1340
1341
1342
1343	`<span class="md-nav__icon md-icon"></span>`
1344	`</label>`
1345
1346	`<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">`
1347	`<label class="md-nav__title" for="__nav_6">`
1348	`<span class="md-nav__icon md-icon"></span>`
1349
1350
1351	`Architecture`
1352
1353
1354	`</label>`
1355	`<ul class="md-nav__list" data-md-scrollfix>`
1356
1357
1358
1359
1360
1361
1362
1363	`<li class="md-nav__item">`
1364	`<a href="../../architecture/overview/" class="md-nav__link">`
1365
1366
1367
1368	`<span class="md-ellipsis">`
1369
1370
1371	`Overview`
1372
1373
1374
1375	`</span>`
1376
1377
1378
1379	`</a>`
1380	`</li>`
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391	`<li class="md-nav__item">`
1392	`<a href="../../architecture/providers/" class="md-nav__link">`
1393
1394
1395
1396	`<span class="md-ellipsis">`
1397
1398
1399	`Provider System`
1400
1401
1402
1403	`</span>`
1404
1405
1406
1407	`</a>`
1408	`</li>`
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419	`<li class="md-nav__item">`
1420	`<a href="../../architecture/pipeline/" class="md-nav__link">`
1421
1422
1423
1424	`<span class="md-ellipsis">`
1425
1426
1427	`Processing Pipeline`
1428
1429
1430
1431	`</span>`
1432
1433
1434
1435	`</a>`
1436	`</li>`
1437
1438
1439
1440
1441	`</ul>`
1442	`</nav>`
1443
1444	`</li>`
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464	`<li class="md-nav__item md-nav__item--nested">`
1465
1466
1467
1468
1469
1470	`<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_7" >`
1471
1472
1473	`<label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">`
1474
1475
1476
1477	`<span class="md-ellipsis">`
1478
1479
1480	`API Reference`
1481
1482
1483
1484	`</span>`
1485
1486
1487
1488	`<span class="md-nav__icon md-icon"></span>`
1489	`</label>`
1490
1491	`<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">`
1492	`<label class="md-nav__title" for="__nav_7">`
1493	`<span class="md-nav__icon md-icon"></span>`
1494
1495
1496	`API Reference`
1497
1498
1499	`</label>`
1500	`<ul class="md-nav__list" data-md-scrollfix>`
1501
1502
1503
1504
1505
1506
1507
1508	`<li class="md-nav__item">`
1509	`<a href="../../api/models/" class="md-nav__link">`
1510
1511
1512
1513	`<span class="md-ellipsis">`
1514
1515
1516	`Models`
1517
1518
1519
1520	`</span>`
1521
1522
1523
1524	`</a>`
1525	`</li>`
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536	`<li class="md-nav__item">`
1537	`<a href="../../api/providers/" class="md-nav__link">`
1538
1539
1540
1541	`<span class="md-ellipsis">`
1542
1543
1544	`Providers`
1545
1546
1547
1548	`</span>`
1549
1550
1551
1552	`</a>`
1553	`</li>`
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564	`<li class="md-nav__item">`
1565	`<a href="../../api/analyzers/" class="md-nav__link">`
1566
1567
1568
1569	`<span class="md-ellipsis">`
1570
1571
1572	`Analyzers`
1573
1574
1575
1576	`</span>`
1577
1578
1579
1580	`</a>`
1581	`</li>`
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592	`<li class="md-nav__item">`
1593	`<a href="../../api/agent/" class="md-nav__link">`
1594
1595
1596
1597	`<span class="md-ellipsis">`
1598
1599
1600	`Agent & Skills`
1601
1602
1603
1604	`</span>`
1605
1606
1607
1608	`</a>`
1609	`</li>`
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620	`<li class="md-nav__item">`
1621	`<a href="../../api/sources/" class="md-nav__link">`
1622
1623
1624
1625	`<span class="md-ellipsis">`
1626
1627
1628	`Sources`
1629
1630
1631
1632	`</span>`
1633
1634
1635
1636	`</a>`
1637	`</li>`
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648	`<li class="md-nav__item">`
1649	`<a href="../../api/auth/" class="md-nav__link">`
1650
1651
1652
1653	`<span class="md-ellipsis">`
1654
1655
1656	`Authentication`
1657
1658
1659
1660	`</span>`
1661
1662
1663
1664	`</a>`
1665	`</li>`
1666
1667
1668
1669
1670	`</ul>`
1671	`</nav>`
1672
1673	`</li>`
1674
1675
1676
1677
1678
1679
1680
1681
1682
1683	`<li class="md-nav__item">`
1684	`<a href="../../faq/" class="md-nav__link">`
1685
1686
1687
1688	`<span class="md-ellipsis">`
1689
1690
1691	`FAQ & Troubleshooting`
1692
1693
1694
1695	`</span>`
1696
1697
1698
1699	`</a>`
1700	`</li>`
1701
1702
1703
1704
1705
1706
1707
1708
1709
1710	`<li class="md-nav__item">`
1711	`<a href="../../contributing/" class="md-nav__link">`
1712
1713
1714
1715	`<span class="md-ellipsis">`
1716
1717
1718	`Contributing`
1719
1720
1721
1722	`</span>`
1723
1724
1725
1726	`</a>`
1727	`</li>`
1728
1729
1730
1731	`</ul>`
1732	`</nav>`
1733	`</div>`
1734	`</div>`
1735	`</div>`
1736
1737
1738
1739	`<div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >`
1740	`<div class="md-sidebar__scrollwrap">`
1741	`<div class="md-sidebar__inner">`
1742
1743
1744	`<nav class="md-nav md-nav--secondary" aria-label="Table of contents">`
1745
1746
1747
1748
1749
1750
1751	`<label class="md-nav__title" for="__toc">`
1752	`<span class="md-nav__icon md-icon"></span>`
1753	`Table of contents`
1754	`</label>`
1755	`<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>`
1756
1757	`<li class="md-nav__item">`
1758	`<a href="#basic-usage" class="md-nav__link">`
1759	`<span class="md-ellipsis">`
1760
1761	`Basic usage`
1762
1763	`</span>`
1764	`</a>`
1765
1766	`</li>`
1767
1768	`<li class="md-nav__item">`
1769	`<a href="#what-happens" class="md-nav__link">`
1770	`<span class="md-ellipsis">`
1771
1772	`What happens`
1773
1774	`</span>`
1775	`</a>`
1776
1777	`</li>`
1778
1779	`<li class="md-nav__item">`
1780	`<a href="#processing-depth" class="md-nav__link">`
1781	`<span class="md-ellipsis">`
1782
1783	`Processing depth`
1784
1785	`</span>`
1786	`</a>`
1787
1788	`<nav class="md-nav" aria-label="Processing depth">`
1789	`<ul class="md-nav__list">`
1790
1791	`<li class="md-nav__item">`
1792	`<a href="#basic" class="md-nav__link">`
1793	`<span class="md-ellipsis">`
1794
1795	`basic`
1796
1797	`</span>`
1798	`</a>`
1799
1800	`</li>`
1801
1802	`<li class="md-nav__item">`
1803	`<a href="#standard-default" class="md-nav__link">`
1804	`<span class="md-ellipsis">`
1805
1806	`standard (default)`
1807
1808	`</span>`
1809	`</a>`
1810
1811	`</li>`
1812
1813	`<li class="md-nav__item">`
1814	`<a href="#comprehensive" class="md-nav__link">`
1815	`<span class="md-ellipsis">`
1816
1817	`comprehensive`
1818
1819	`</span>`
1820	`</a>`
1821
1822	`</li>`
1823
1824	`</ul>`
1825	`</nav>`
1826
1827	`</li>`
1828
1829	`<li class="md-nav__item">`
1830	`<a href="#command-line-options" class="md-nav__link">`
1831	`<span class="md-ellipsis">`
1832
1833	`Command-line options`
1834
1835	`</span>`
1836	`</a>`
1837
1838	`<nav class="md-nav" aria-label="Command-line options">`
1839	`<ul class="md-nav__list">`
1840
1841	`<li class="md-nav__item">`
1842	`<a href="#provider-and-model-selection" class="md-nav__link">`
1843	`<span class="md-ellipsis">`
1844
1845	`Provider and model selection`
1846
1847	`</span>`
1848	`</a>`
1849
1850	`</li>`
1851
1852	`<li class="md-nav__item">`
1853	`<a href="#speaker-diarization-hints" class="md-nav__link">`
1854	`<span class="md-ellipsis">`
1855
1856	`Speaker diarization hints`
1857
1858	`</span>`
1859	`</a>`
1860
1861	`</li>`
1862
1863	`<li class="md-nav__item">`
1864	`<a href="#custom-prompt-templates" class="md-nav__link">`
1865	`<span class="md-ellipsis">`
1866
1867	`Custom prompt templates`
1868
1869	`</span>`
1870	`</a>`
1871
1872	`</li>`
1873
1874	`<li class="md-nav__item">`
1875	`<a href="#output-format" class="md-nav__link">`
1876	`<span class="md-ellipsis">`
1877
1878	`Output format`
1879
1880	`</span>`
1881	`</a>`
1882
1883	`</li>`
1884
1885	`<li class="md-nav__item">`
1886	`<a href="#frame-extraction-tuning" class="md-nav__link">`
1887	`<span class="md-ellipsis">`
1888
1889	`Frame extraction tuning`
1890
1891	`</span>`
1892	`</a>`
1893
1894	`</li>`
1895
1896	`</ul>`
1897	`</nav>`
1898
1899	`</li>`
1900
1901	`<li class="md-nav__item">`
1902	`<a href="#output-structure" class="md-nav__link">`
1903	`<span class="md-ellipsis">`
1904
1905	`Output structure`
1906
1907	`</span>`
1908	`</a>`
1909
1910	`</li>`
1911
1912	`<li class="md-nav__item">`
1913	`<a href="#output-manifest" class="md-nav__link">`
1914	`<span class="md-ellipsis">`
1915
1916	`Output manifest`
1917
1918	`</span>`
1919	`</a>`
1920
1921	`</li>`
1922
1923	`<li class="md-nav__item">`
1924	`<a href="#checkpoint-and-resume" class="md-nav__link">`
1925	`<span class="md-ellipsis">`
1926
1927	`Checkpoint and resume`
1928
1929	`</span>`
1930	`</a>`
1931
1932	`</li>`
1933
1934	`<li class="md-nav__item">`
1935	`<a href="#using-results-after-analysis" class="md-nav__link">`
1936	`<span class="md-ellipsis">`
1937
1938	`Using results after analysis`
1939
1940	`</span>`
1941	`</a>`
1942
1943	`<nav class="md-nav" aria-label="Using results after analysis">`
1944	`<ul class="md-nav__list">`
1945
1946	`<li class="md-nav__item">`
1947	`<a href="#query-the-knowledge-graph" class="md-nav__link">`
1948	`<span class="md-ellipsis">`
1949
1950	`Query the knowledge graph`
1951
1952	`</span>`
1953	`</a>`
1954
1955	`</li>`
1956
1957	`<li class="md-nav__item">`
1958	`<a href="#classify-entities-for-planning" class="md-nav__link">`
1959	`<span class="md-ellipsis">`
1960
1961	`Classify entities for planning`
1962
1963	`</span>`
1964	`</a>`
1965
1966	`</li>`
1967
1968	`<li class="md-nav__item">`
1969	`<a href="#export-to-other-formats" class="md-nav__link">`
1970	`<span class="md-ellipsis">`
1971
1972	`Export to other formats`
1973
1974	`</span>`
1975	`</a>`
1976
1977	`</li>`
1978
1979	`<li class="md-nav__item">`
1980	`<a href="#use-with-the-planning-agent" class="md-nav__link">`
1981	`<span class="md-ellipsis">`
1982
1983	`Use with the planning agent`
1984
1985	`</span>`
1986	`</a>`
1987
1988	`</li>`
1989
1990	`</ul>`
1991	`</nav>`
1992
1993	`</li>`
1994
1995	`</ul>`
1996
1997	`</nav>`
1998	`</div>`
1999	`</div>`
2000	`</div>`
2001
2002
2003
2004	`<div class="md-content" data-md-component="content">`
2005
2006	`<article class="md-content__inner md-typeset">`
2007
2008
2009
2010
2011
2012
2013
2014
2015	`<h1 id="single-video-analysis">Single Video Analysis<a class="headerlink" href="#single-video-analysis" title="Permanent link">¶</a></h1>`
2016	`<h2 id="basic-usage">Basic usage<a class="headerlink" href="#basic-usage" title="Permanent link">¶</a></h2>`
2017	`<div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>planopticon<span class="w"> </span>analyze<span class="w"> </span>-i<span class="w"> </span>recording.mp4<span class="w"> </span>-o<span class="w"> </span>./output`
2018	`</code></pre></div>`
2019	`<h2 id="what-happens">What happens<a class="headerlink" href="#what-happens" title="Permanent link">¶</a></h2>`
2020	`<p>The pipeline runs these steps in order:</p>`
2021	`<ol>`
2022	`<li><strong>Frame extraction</strong> -- Samples frames using change detection for transitions plus periodic capture (every 30s) for slow-evolving content like document scrolling</li>`
2023	`<li><strong>People frame filtering</strong> -- OpenCV face detection automatically removes webcam/video conference frames, keeping only shared content (slides, documents, screen shares)</li>`
2024	`<li><strong>Audio extraction</strong> -- Extracts audio track to WAV</li>`
2025	`<li><strong>Transcription</strong> -- Sends audio to speech-to-text (Whisper or Gemini). If <code>--speakers</code> is provided, speaker diarization hints are passed to the provider.</li>`
2026	`<li><strong>Diagram detection</strong> -- Vision model classifies each frame as diagram/chart/whiteboard/screenshot/none</li>`
2027	`<li><strong>Diagram analysis</strong> -- High-confidence diagrams get full extraction (description, text, mermaid, chart data)</li>`
2028	`<li><strong>Screengrab fallback</strong> -- Medium-confidence frames are saved as captioned screenshots</li>`
2029	`<li><strong>Knowledge graph</strong> -- Extracts entities and relationships from transcript + diagrams, stored in both <code>knowledge_graph.db</code> (SQLite, primary) and <code>knowledge_graph.json</code> (export)</li>`
2030	`<li><strong>Key points</strong> -- LLM extracts main points and topics</li>`
2031	`<li><strong>Action items</strong> -- LLM finds tasks, commitments, and follow-ups</li>`
2032	`<li><strong>Reports</strong> -- Generates markdown, HTML, and PDF</li>`
2033	`<li><strong>Export</strong> -- Renders mermaid diagrams to SVG/PNG, reproduces charts</li>`
2034	`</ol>`
2035	`<p>After analysis, you can optionally run planning taxonomy classification on the knowledge graph to categorize entities for use with the planning agent:</p>`
2036	`<div class="highlight"><pre><span></span><code><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>planopticon<span class="w"> </span>kg<span class="w"> </span>classify<span class="w"> </span>results/knowledge_graph.db`
2037	`</code></pre></div>`
2038	`<h2 id="processing-depth">Processing depth<a class="headerlink" href="#processing-depth" title="Permanent link">¶</a></h2>`
2039	`<h3 id="basic"><code>basic</code><a class="headerlink" href="#basic" title="Permanent link">¶</a></h3>`
2040	`<ul>`
2041	`<li>Transcription only</li>`
2042	`<li>Key points and action items</li>`
2043	`<li>No diagram extraction</li>`
2044	`</ul>`
2045	`<h3 id="standard-default"><code>standard</code> (default)<a class="headerlink" href="#standard-default" title="Permanent link">¶</a></h3>`
2046	`<ul>`
2047	`<li>Everything in basic</li>`
2048	`<li>Diagram extraction (up to 10 frames, evenly sampled)</li>`
2049	`<li>Knowledge graph</li>`
2050	`<li>Full report generation</li>`
2051	`</ul>`
2052	`<h3 id="comprehensive"><code>comprehensive</code><a class="headerlink" href="#comprehensive" title="Permanent link">¶</a></h3>`
2053	`<ul>`
2054	`<li>Everything in standard</li>`
2055	`<li>More frames analyzed (up to 20)</li>`
2056	`<li>Deeper analysis</li>`
2057	`</ul>`
2058	`<h2 id="command-line-options">Command-line options<a class="headerlink" href="#command-line-options" title="Permanent link">¶</a></h2>`
2059	`<h3 id="provider-and-model-selection">Provider and model selection<a class="headerlink" href="#provider-and-model-selection" title="Permanent link">¶</a></h3>`
2060	`<div class="highlight"><pre><span></span><code><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="c1"># Use a specific provider</span>`
2061	`<a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a>planopticon<span class="w"> </span>analyze<span class="w"> </span>-i<span class="w"> </span>video.mp4<span class="w"> </span>-o<span class="w"> </span>./output<span class="w"> </span>--provider<span class="w"> </span>anthropic`
2062	`<a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a>`
2063	`<a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="c1"># Override vision and chat models separately</span>`
2064	`<a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a>planopticon<span class="w"> </span>analyze<span class="w"> </span>-i<span class="w"> </span>video.mp4<span class="w"> </span>-o<span class="w"> </span>./output<span class="w"> </span>--vision-model<span class="w"> </span>gpt-4o<span class="w"> </span>--chat-model<span class="w"> </span>claude-sonnet-4-20250514`
2065	`</code></pre></div>`
2066	`<h3 id="speaker-diarization-hints">Speaker diarization hints<a class="headerlink" href="#speaker-diarization-hints" title="Permanent link">¶</a></h3>`
2067	`<p>Use <code>--speakers</code> to provide speaker names as comma-separated hints. These are passed to the transcription provider to improve speaker identification in the transcript segments.</p>`
2068	`<div class="highlight"><pre><span></span><code><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>planopticon<span class="w"> </span>analyze<span class="w"> </span>-i<span class="w"> </span>video.mp4<span class="w"> </span>-o<span class="w"> </span>./output<span class="w"> </span>--speakers<span class="w"> </span><span class="s2">"Alice,Bob,Carol"</span>`
2069	`</code></pre></div>`
2070	`<h3 id="custom-prompt-templates">Custom prompt templates<a class="headerlink" href="#custom-prompt-templates" title="Permanent link">¶</a></h3>`
2071	`<p>Use <code>--templates-dir</code> to point to a directory of custom <code>.txt</code> prompt template files. These override the built-in prompts used for diagram analysis, key point extraction, action item extraction, and other LLM-driven steps.</p>`
2072	`<div class="highlight"><pre><span></span><code><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>planopticon<span class="w"> </span>analyze<span class="w"> </span>-i<span class="w"> </span>video.mp4<span class="w"> </span>-o<span class="w"> </span>./output<span class="w"> </span>--templates-dir<span class="w"> </span>./my-prompts`
2073	`</code></pre></div>`
2074	`<p>Template files should be named to match the built-in template names (e.g., <code>key_points.txt</code>, <code>action_items.txt</code>). See the <code>video_processor/utils/prompt_templates.py</code> module for the full list of template names.</p>`
2075	`<h3 id="output-format">Output format<a class="headerlink" href="#output-format" title="Permanent link">¶</a></h3>`
2076	`<p>Use <code>--output-format json</code> to emit the complete <code>VideoManifest</code> as structured JSON to stdout, in addition to writing all output files to disk. This is useful for scripting, CI/CD integration, or piping results into other tools.</p>`
2077	`<div class="highlight"><pre><span></span><code><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a><span class="c1"># Standard output (files + console summary)</span>`
2078	`<a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a>planopticon<span class="w"> </span>analyze<span class="w"> </span>-i<span class="w"> </span>video.mp4<span class="w"> </span>-o<span class="w"> </span>./output`
2079	`<a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a>`
2080	`<a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a><span class="c1"># JSON manifest to stdout</span>`
2081	`<a id="__codelineno-5-5" name="__codelineno-5-5" href="#__codelineno-5-5"></a>planopticon<span class="w"> </span>analyze<span class="w"> </span>-i<span class="w"> </span>video.mp4<span class="w"> </span>-o<span class="w"> </span>./output<span class="w"> </span>--output-format<span class="w"> </span>json`
2082	`</code></pre></div>`
2083	`<h3 id="frame-extraction-tuning">Frame extraction tuning<a class="headerlink" href="#frame-extraction-tuning" title="Permanent link">¶</a></h3>`
2084	`<div class="highlight"><pre><span></span><code><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a><span class="c1"># Adjust sampling rate (frames per second to consider)</span>`
2085	`<a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a>planopticon<span class="w"> </span>analyze<span class="w"> </span>-i<span class="w"> </span>video.mp4<span class="w"> </span>-o<span class="w"> </span>./output<span class="w"> </span>--sampling-rate<span class="w"> </span><span class="m">1</span>.0`
2086	`<a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a>`
2087	`<a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a><span class="c1"># Adjust change detection threshold (lower = more sensitive)</span>`
2088	`<a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a>planopticon<span class="w"> </span>analyze<span class="w"> </span>-i<span class="w"> </span>video.mp4<span class="w"> </span>-o<span class="w"> </span>./output<span class="w"> </span>--change-threshold<span class="w"> </span><span class="m">0</span>.10`
2089	`<a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a>`
2090	`<a id="__codelineno-6-7" name="__codelineno-6-7" href="#__codelineno-6-7"></a><span class="c1"># Adjust periodic capture interval</span>`
2091	`<a id="__codelineno-6-8" name="__codelineno-6-8" href="#__codelineno-6-8"></a>planopticon<span class="w"> </span>analyze<span class="w"> </span>-i<span class="w"> </span>video.mp4<span class="w"> </span>-o<span class="w"> </span>./output<span class="w"> </span>--periodic-capture<span class="w"> </span><span class="m">60</span>`
2092	`<a id="__codelineno-6-9" name="__codelineno-6-9" href="#__codelineno-6-9"></a>`
2093	`<a id="__codelineno-6-10" name="__codelineno-6-10" href="#__codelineno-6-10"></a><span class="c1"># Enable GPU acceleration for frame extraction</span>`
2094	`<a id="__codelineno-6-11" name="__codelineno-6-11" href="#__codelineno-6-11"></a>planopticon<span class="w"> </span>analyze<span class="w"> </span>-i<span class="w"> </span>video.mp4<span class="w"> </span>-o<span class="w"> </span>./output<span class="w"> </span>--use-gpu`
2095	`</code></pre></div>`
2096	`<h2 id="output-structure">Output structure<a class="headerlink" href="#output-structure" title="Permanent link">¶</a></h2>`
2097	`<p>Every run produces a standardized directory structure:</p>`
2098	`<div class="highlight"><pre><span></span><code><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>output/`
2099	`<a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a>├── manifest.json # Run manifest (source of truth)`
2100	`<a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a>├── transcript/`
2101	`<a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a>│ ├── transcript.json # Full transcript with segments + speakers`
2102	`<a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a>│ ├── transcript.txt # Plain text`
2103	`<a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a>│ └── transcript.srt # Subtitles`
2104	`<a id="__codelineno-7-7" name="__codelineno-7-7" href="#__codelineno-7-7"></a>├── frames/`
2105	`<a id="__codelineno-7-8" name="__codelineno-7-8" href="#__codelineno-7-8"></a>│ ├── frame_0000.jpg`
2106	`<a id="__codelineno-7-9" name="__codelineno-7-9" href="#__codelineno-7-9"></a>│ └── ...`
2107	`<a id="__codelineno-7-10" name="__codelineno-7-10" href="#__codelineno-7-10"></a>├── diagrams/`
2108	`<a id="__codelineno-7-11" name="__codelineno-7-11" href="#__codelineno-7-11"></a>│ ├── diagram_0.jpg # Original frame`
2109	`<a id="__codelineno-7-12" name="__codelineno-7-12" href="#__codelineno-7-12"></a>│ ├── diagram_0.mermaid # Mermaid source`
2110	`<a id="__codelineno-7-13" name="__codelineno-7-13" href="#__codelineno-7-13"></a>│ ├── diagram_0.svg # Vector rendering`
2111	`<a id="__codelineno-7-14" name="__codelineno-7-14" href="#__codelineno-7-14"></a>│ ├── diagram_0.png # Raster rendering`
2112	`<a id="__codelineno-7-15" name="__codelineno-7-15" href="#__codelineno-7-15"></a>│ ├── diagram_0.json # Analysis data`
2113	`<a id="__codelineno-7-16" name="__codelineno-7-16" href="#__codelineno-7-16"></a>│ └── ...`
2114	`<a id="__codelineno-7-17" name="__codelineno-7-17" href="#__codelineno-7-17"></a>├── captures/`
2115	`<a id="__codelineno-7-18" name="__codelineno-7-18" href="#__codelineno-7-18"></a>│ ├── capture_0.jpg # Medium-confidence screenshots`
2116	`<a id="__codelineno-7-19" name="__codelineno-7-19" href="#__codelineno-7-19"></a>│ ├── capture_0.json`
2117	`<a id="__codelineno-7-20" name="__codelineno-7-20" href="#__codelineno-7-20"></a>│ └── ...`
2118	`<a id="__codelineno-7-21" name="__codelineno-7-21" href="#__codelineno-7-21"></a>└── results/`
2119	`<a id="__codelineno-7-22" name="__codelineno-7-22" href="#__codelineno-7-22"></a> ├── analysis.md # Markdown report`
2120	`<a id="__codelineno-7-23" name="__codelineno-7-23" href="#__codelineno-7-23"></a> ├── analysis.html # HTML report`
2121	`<a id="__codelineno-7-24" name="__codelineno-7-24" href="#__codelineno-7-24"></a> ├── analysis.pdf # PDF (if planopticon[pdf] installed)`
2122	`<a id="__codelineno-7-25" name="__codelineno-7-25" href="#__codelineno-7-25"></a> ├── knowledge_graph.db # Knowledge graph (SQLite, primary)`
2123	`<a id="__codelineno-7-26" name="__codelineno-7-26" href="#__codelineno-7-26"></a> ├── knowledge_graph.json # Knowledge graph (JSON export)`
2124	`<a id="__codelineno-7-27" name="__codelineno-7-27" href="#__codelineno-7-27"></a> ├── key_points.json # Extracted key points`
2125	`<a id="__codelineno-7-28" name="__codelineno-7-28" href="#__codelineno-7-28"></a> └── action_items.json # Action items`
2126	`</code></pre></div>`
2127	`<h2 id="output-manifest">Output manifest<a class="headerlink" href="#output-manifest" title="Permanent link">¶</a></h2>`
2128	`<p>Every run produces a <code>manifest.json</code> that is the single source of truth:</p>`
2129	`<div class="highlight"><pre><span></span><code><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a><span class="p">{</span>`
2130	`<a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="w"> </span><span class="nt">"version"</span><span class="p">:</span><span class="w"> </span><span class="s2">"1.0"</span><span class="p">,</span>`
2131	`<a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a><span class="w"> </span><span class="nt">"video"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>`
2132	`<a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a><span class="w"> </span><span class="nt">"title"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Analysis of recording"</span><span class="p">,</span>`
2133	`<a id="__codelineno-8-5" name="__codelineno-8-5" href="#__codelineno-8-5"></a><span class="w"> </span><span class="nt">"source_path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/path/to/recording.mp4"</span><span class="p">,</span>`
2134	`<a id="__codelineno-8-6" name="__codelineno-8-6" href="#__codelineno-8-6"></a><span class="w"> </span><span class="nt">"duration_seconds"</span><span class="p">:</span><span class="w"> </span><span class="mf">3600.0</span>`
2135	`<a id="__codelineno-8-7" name="__codelineno-8-7" href="#__codelineno-8-7"></a><span class="w"> </span><span class="p">},</span>`
2136	`<a id="__codelineno-8-8" name="__codelineno-8-8" href="#__codelineno-8-8"></a><span class="w"> </span><span class="nt">"stats"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>`
2137	`<a id="__codelineno-8-9" name="__codelineno-8-9" href="#__codelineno-8-9"></a><span class="w"> </span><span class="nt">"duration_seconds"</span><span class="p">:</span><span class="w"> </span><span class="mf">45.2</span><span class="p">,</span>`
2138	`<a id="__codelineno-8-10" name="__codelineno-8-10" href="#__codelineno-8-10"></a><span class="w"> </span><span class="nt">"frames_extracted"</span><span class="p">:</span><span class="w"> </span><span class="mi">42</span><span class="p">,</span>`
2139	`<a id="__codelineno-8-11" name="__codelineno-8-11" href="#__codelineno-8-11"></a><span class="w"> </span><span class="nt">"people_frames_filtered"</span><span class="p">:</span><span class="w"> </span><span class="mi">11</span><span class="p">,</span>`
2140	`<a id="__codelineno-8-12" name="__codelineno-8-12" href="#__codelineno-8-12"></a><span class="w"> </span><span class="nt">"diagrams_detected"</span><span class="p">:</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span>`
2141	`<a id="__codelineno-8-13" name="__codelineno-8-13" href="#__codelineno-8-13"></a><span class="w"> </span><span class="nt">"screen_captures"</span><span class="p">:</span><span class="w"> </span><span class="mi">5</span><span class="p">,</span>`
2142	`<a id="__codelineno-8-14" name="__codelineno-8-14" href="#__codelineno-8-14"></a><span class="w"> </span><span class="nt">"models_used"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>`
2143	`<a id="__codelineno-8-15" name="__codelineno-8-15" href="#__codelineno-8-15"></a><span class="w"> </span><span class="nt">"vision"</span><span class="p">:</span><span class="w"> </span><span class="s2">"gpt-4o"</span><span class="p">,</span>`
2144	`<a id="__codelineno-8-16" name="__codelineno-8-16" href="#__codelineno-8-16"></a><span class="w"> </span><span class="nt">"chat"</span><span class="p">:</span><span class="w"> </span><span class="s2">"gpt-4o"</span>`
2145	`<a id="__codelineno-8-17" name="__codelineno-8-17" href="#__codelineno-8-17"></a><span class="w"> </span><span class="p">}</span>`
2146	`<a id="__codelineno-8-18" name="__codelineno-8-18" href="#__codelineno-8-18"></a><span class="w"> </span><span class="p">},</span>`
2147	`<a id="__codelineno-8-19" name="__codelineno-8-19" href="#__codelineno-8-19"></a><span class="w"> </span><span class="nt">"transcript_json"</span><span class="p">:</span><span class="w"> </span><span class="s2">"transcript/transcript.json"</span><span class="p">,</span>`
2148	`<a id="__codelineno-8-20" name="__codelineno-8-20" href="#__codelineno-8-20"></a><span class="w"> </span><span class="nt">"transcript_txt"</span><span class="p">:</span><span class="w"> </span><span class="s2">"transcript/transcript.txt"</span><span class="p">,</span>`
2149	`<a id="__codelineno-8-21" name="__codelineno-8-21" href="#__codelineno-8-21"></a><span class="w"> </span><span class="nt">"transcript_srt"</span><span class="p">:</span><span class="w"> </span><span class="s2">"transcript/transcript.srt"</span><span class="p">,</span>`
2150	`<a id="__codelineno-8-22" name="__codelineno-8-22" href="#__codelineno-8-22"></a><span class="w"> </span><span class="nt">"analysis_md"</span><span class="p">:</span><span class="w"> </span><span class="s2">"results/analysis.md"</span><span class="p">,</span>`
2151	`<a id="__codelineno-8-23" name="__codelineno-8-23" href="#__codelineno-8-23"></a><span class="w"> </span><span class="nt">"knowledge_graph_json"</span><span class="p">:</span><span class="w"> </span><span class="s2">"results/knowledge_graph.json"</span><span class="p">,</span>`
2152	`<a id="__codelineno-8-24" name="__codelineno-8-24" href="#__codelineno-8-24"></a><span class="w"> </span><span class="nt">"knowledge_graph_db"</span><span class="p">:</span><span class="w"> </span><span class="s2">"results/knowledge_graph.db"</span><span class="p">,</span>`
2153	`<a id="__codelineno-8-25" name="__codelineno-8-25" href="#__codelineno-8-25"></a><span class="w"> </span><span class="nt">"key_points_json"</span><span class="p">:</span><span class="w"> </span><span class="s2">"results/key_points.json"</span><span class="p">,</span>`
2154	`<a id="__codelineno-8-26" name="__codelineno-8-26" href="#__codelineno-8-26"></a><span class="w"> </span><span class="nt">"action_items_json"</span><span class="p">:</span><span class="w"> </span><span class="s2">"results/action_items.json"</span><span class="p">,</span>`
2155	`<a id="__codelineno-8-27" name="__codelineno-8-27" href="#__codelineno-8-27"></a><span class="w"> </span><span class="nt">"key_points"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="err">...</span><span class="p">],</span>`
2156	`<a id="__codelineno-8-28" name="__codelineno-8-28" href="#__codelineno-8-28"></a><span class="w"> </span><span class="nt">"action_items"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="err">...</span><span class="p">],</span>`
2157	`<a id="__codelineno-8-29" name="__codelineno-8-29" href="#__codelineno-8-29"></a><span class="w"> </span><span class="nt">"diagrams"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="err">...</span><span class="p">],</span>`
2158	`<a id="__codelineno-8-30" name="__codelineno-8-30" href="#__codelineno-8-30"></a><span class="w"> </span><span class="nt">"screen_captures"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="err">...</span><span class="p">]</span>`
2159	`<a id="__codelineno-8-31" name="__codelineno-8-31" href="#__codelineno-8-31"></a><span class="p">}</span>`
2160	`</code></pre></div>`
2161	`<h2 id="checkpoint-and-resume">Checkpoint and resume<a class="headerlink" href="#checkpoint-and-resume" title="Permanent link">¶</a></h2>`
2162	`<p>The pipeline supports checkpoint/resume. If a step's output files already exist on disk, that step is skipped on re-run. This means you can safely re-run an interrupted analysis and it will pick up where it left off:</p>`
2163	`<div class="highlight"><pre><span></span><code><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a><span class="c1"># First run (interrupted at step 6)</span>`
2164	`<a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a>planopticon<span class="w"> </span>analyze<span class="w"> </span>-i<span class="w"> </span>video.mp4<span class="w"> </span>-o<span class="w"> </span>./output`
2165	`<a id="__codelineno-9-3" name="__codelineno-9-3" href="#__codelineno-9-3"></a>`
2166	`<a id="__codelineno-9-4" name="__codelineno-9-4" href="#__codelineno-9-4"></a><span class="c1"># Second run (resumes from step 6)</span>`
2167	`<a id="__codelineno-9-5" name="__codelineno-9-5" href="#__codelineno-9-5"></a>planopticon<span class="w"> </span>analyze<span class="w"> </span>-i<span class="w"> </span>video.mp4<span class="w"> </span>-o<span class="w"> </span>./output`
2168	`</code></pre></div>`
2169	`<h2 id="using-results-after-analysis">Using results after analysis<a class="headerlink" href="#using-results-after-analysis" title="Permanent link">¶</a></h2>`
2170	`<h3 id="query-the-knowledge-graph">Query the knowledge graph<a class="headerlink" href="#query-the-knowledge-graph" title="Permanent link">¶</a></h3>`
2171	`<p>After analysis completes, you can query the knowledge graph directly:</p>`
2172	`<div class="highlight"><pre><span></span><code><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a><span class="c1"># Show graph stats</span>`
2173	`<a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a>planopticon<span class="w"> </span>query<span class="w"> </span>--db<span class="w"> </span>results/knowledge_graph.db`
2174	`<a id="__codelineno-10-3" name="__codelineno-10-3" href="#__codelineno-10-3"></a>`
2175	`<a id="__codelineno-10-4" name="__codelineno-10-4" href="#__codelineno-10-4"></a><span class="c1"># List entities by type</span>`
2176	`<a id="__codelineno-10-5" name="__codelineno-10-5" href="#__codelineno-10-5"></a>planopticon<span class="w"> </span>query<span class="w"> </span>--db<span class="w"> </span>results/knowledge_graph.db<span class="w"> </span><span class="s2">"entities --type technology"</span>`
2177	`<a id="__codelineno-10-6" name="__codelineno-10-6" href="#__codelineno-10-6"></a>`
2178	`<a id="__codelineno-10-7" name="__codelineno-10-7" href="#__codelineno-10-7"></a><span class="c1"># Find neighbors of an entity</span>`
2179	`<a id="__codelineno-10-8" name="__codelineno-10-8" href="#__codelineno-10-8"></a>planopticon<span class="w"> </span>query<span class="w"> </span>--db<span class="w"> </span>results/knowledge_graph.db<span class="w"> </span><span class="s2">"neighbors Kubernetes"</span>`
2180	`<a id="__codelineno-10-9" name="__codelineno-10-9" href="#__codelineno-10-9"></a>`
2181	`<a id="__codelineno-10-10" name="__codelineno-10-10" href="#__codelineno-10-10"></a><span class="c1"># Ask natural language questions (requires API key)</span>`
2182	`<a id="__codelineno-10-11" name="__codelineno-10-11" href="#__codelineno-10-11"></a>planopticon<span class="w"> </span>query<span class="w"> </span>--db<span class="w"> </span>results/knowledge_graph.db<span class="w"> </span><span class="s2">"What technologies were discussed?"</span>`
2183	`</code></pre></div>`
2184	`<h3 id="classify-entities-for-planning">Classify entities for planning<a class="headerlink" href="#classify-entities-for-planning" title="Permanent link">¶</a></h3>`
2185	`<p>Run taxonomy classification to categorize entities into planning types (goal, milestone, risk, dependency, etc.):</p>`
2186	`<div class="highlight"><pre><span></span><code><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>planopticon<span class="w"> </span>kg<span class="w"> </span>classify<span class="w"> </span>results/knowledge_graph.db`
2187	`<a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a>planopticon<span class="w"> </span>kg<span class="w"> </span>classify<span class="w"> </span>results/knowledge_graph.db<span class="w"> </span>--format<span class="w"> </span>json`
2188	`</code></pre></div>`
2189	`<h3 id="export-to-other-formats">Export to other formats<a class="headerlink" href="#export-to-other-formats" title="Permanent link">¶</a></h3>`
2190	`<div class="highlight"><pre><span></span><code><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a><span class="c1"># Generate markdown documents</span>`
2191	`<a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a>planopticon<span class="w"> </span><span class="nb">export</span><span class="w"> </span>markdown<span class="w"> </span>results/knowledge_graph.db<span class="w"> </span>-o<span class="w"> </span>./docs`
2192	`<a id="__codelineno-12-3" name="__codelineno-12-3" href="#__codelineno-12-3"></a>`
2193	`<a id="__codelineno-12-4" name="__codelineno-12-4" href="#__codelineno-12-4"></a><span class="c1"># Export as Obsidian vault</span>`
2194	`<a id="__codelineno-12-5" name="__codelineno-12-5" href="#__codelineno-12-5"></a>planopticon<span class="w"> </span><span class="nb">export</span><span class="w"> </span>obsidian<span class="w"> </span>results/knowledge_graph.db<span class="w"> </span>-o<span class="w"> </span>./vault`
2195	`<a id="__codelineno-12-6" name="__codelineno-12-6" href="#__codelineno-12-6"></a>`
2196	`<a id="__codelineno-12-7" name="__codelineno-12-7" href="#__codelineno-12-7"></a><span class="c1"># Export as PlanOpticonExchange</span>`
2197	`<a id="__codelineno-12-8" name="__codelineno-12-8" href="#__codelineno-12-8"></a>planopticon<span class="w"> </span><span class="nb">export</span><span class="w"> </span>exchange<span class="w"> </span>results/knowledge_graph.db<span class="w"> </span>-o<span class="w"> </span>exchange.json`
2198	`<a id="__codelineno-12-9" name="__codelineno-12-9" href="#__codelineno-12-9"></a>`
2199	`<a id="__codelineno-12-10" name="__codelineno-12-10" href="#__codelineno-12-10"></a><span class="c1"># Generate GitHub wiki</span>`
2200	`<a id="__codelineno-12-11" name="__codelineno-12-11" href="#__codelineno-12-11"></a>planopticon<span class="w"> </span>wiki<span class="w"> </span>generate<span class="w"> </span>results/knowledge_graph.db<span class="w"> </span>-o<span class="w"> </span>./wiki`
2201	`</code></pre></div>`
2202	`<h3 id="use-with-the-planning-agent">Use with the planning agent<a class="headerlink" href="#use-with-the-planning-agent" title="Permanent link">¶</a></h3>`
2203	`<p>The planning agent can consume the knowledge graph to generate project plans, PRDs, roadmaps, and other planning artifacts:</p>`
2204	`<div class="highlight"><pre><span></span><code><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>planopticon<span class="w"> </span>agent<span class="w"> </span>--db<span class="w"> </span>results/knowledge_graph.db`
2205	`</code></pre></div>`
2206
2207
2208
2209
2210
2211
2212
2213
2214
2215
2216
2217
2218
2219	`</article>`
2220	`</div>`
2221
2222
2223	`<script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>`
2224
2225	`<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>`
2226	`</div>`
2227
2228	`<button type="button" class="md-top md-icon" data-md-component="top" hidden>`
2229
2230	`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8z"/></svg>`
2231	`Back to top`
2232	`</button>`
2233
2234	`</main>`
2235
2236	`<footer class="md-footer">`
2237
2238	`<div class="md-footer-meta md-typeset">`
2239	`<div class="md-footer-meta__inner md-grid">`
2240	`<div class="md-copyright">`
2241
2242	`<div class="md-copyright__highlight">`
2243	`Copyright © 2026 CONFLICT LLC`
2244	`</div>`
2245
2246
2247	`Made with`
2248	`<a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">`
2249	`Material for MkDocs`
2250	`</a>`
2251
2252	`</div>`
2253
2254
2255	`<div class="md-social">`
2256
2257
2258
2259
2260
2261
2262
2263
2264	`<a href="https://github.com/ConflictHQ/PlanOpticon" target="_blank" rel="noopener" title="github.com" class="md-social__link">`
2265	<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
2266	`</a>`
2267
2268	`</div>`
2269
2270	`</div>`
2271	`</div>`
2272	`</footer>`
2273
2274	`</div>`
2275	`<div class="md-dialog" data-md-component="dialog">`
2276	`<div class="md-dialog__inner md-typeset"></div>`
2277	`</div>`
2278
2279
2280
2281
2282
2283	<script id="__config" type="application/json">{"annotate": null, "base": "../..", "features": ["navigation.instant", "navigation.tabs", "navigation.sections", "navigation.expand", "navigation.top", "search.suggest", "search.highlight", "content.code.copy", "content.tabs.link", "header.autohide"], "search": "../../assets/javascripts/workers/search.2c215733.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
2284
2285
2286	`<script src="../../assets/javascripts/bundle.79ae519e.min.js"></script>`
2287
2288
2289	`</body>`
2290	`</html>`

PlanOpticon

Keyboard Shortcuts