PlanOpticon

planopticon / api / sources / index.html

Source Rendered

Blame History Raw 3113 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/api/sources/">`
16
17
18	`<link rel="prev" href="../agent/">`
19
20
21	`<link rel="next" href="../auth/">`
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>Sources - 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="#sources-api-reference" 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	`Sources`
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	`<li class="md-tabs__item">`
274	`<a href="../../guide/single-video/" class="md-tabs__link">`
275
276
277
278	`User Guide`
279
280	`</a>`
281	`</li>`
282
283
284
285
286
287
288
289
290
291	`<li class="md-tabs__item">`
292	`<a href="../../use-cases/" class="md-tabs__link">`
293
294
295
296
297
298	`Use Cases`
299
300	`</a>`
301	`</li>`
302
303
304
305
306
307
308
309
310	`<li class="md-tabs__item">`
311	`<a href="../../cli-reference/" class="md-tabs__link">`
312
313
314
315
316
317	`CLI Reference`
318
319	`</a>`
320	`</li>`
321
322
323
324
325
326
327
328
329
330
331	`<li class="md-tabs__item">`
332	`<a href="../../architecture/overview/" class="md-tabs__link">`
333
334
335
336	`Architecture`
337
338	`</a>`
339	`</li>`
340
341
342
343
344
345
346
347
348
349
350
351
352
353	`<li class="md-tabs__item md-tabs__item--active">`
354	`<a href="../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	`<li class="md-nav__item md-nav__item--nested">`
637
638
639
640
641
642	`<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3" >`
643
644
645	`<label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">`
646
647
648
649	`<span class="md-ellipsis">`
650
651
652	`User Guide`
653
654
655
656	`</span>`
657
658
659
660	`<span class="md-nav__icon md-icon"></span>`
661	`</label>`
662
663	`<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">`
664	`<label class="md-nav__title" for="__nav_3">`
665	`<span class="md-nav__icon md-icon"></span>`
666
667
668	`User Guide`
669
670
671	`</label>`
672	`<ul class="md-nav__list" data-md-scrollfix>`
673
674
675
676
677
678
679
680	`<li class="md-nav__item">`
681	`<a href="../../guide/single-video/" class="md-nav__link">`
682
683
684
685	`<span class="md-ellipsis">`
686
687
688	`Single Video Analysis`
689
690
691
692	`</span>`
693
694
695
696	`</a>`
697	`</li>`
698
699
700
701
702
703
704
705
706
707
708	`<li class="md-nav__item">`
709	`<a href="../../guide/batch/" class="md-nav__link">`
710
711
712
713	`<span class="md-ellipsis">`
714
715
716	`Batch Processing`
717
718
719
720	`</span>`
721
722
723
724	`</a>`
725	`</li>`
726
727
728
729
730
731
732
733
734
735
736	`<li class="md-nav__item">`
737	`<a href="../../guide/document-ingestion/" class="md-nav__link">`
738
739
740
741	`<span class="md-ellipsis">`
742
743
744	`Document Ingestion`
745
746
747
748	`</span>`
749
750
751
752	`</a>`
753	`</li>`
754
755
756
757
758
759
760
761
762
763
764	`<li class="md-nav__item">`
765	`<a href="../../guide/cloud-sources/" class="md-nav__link">`
766
767
768
769	`<span class="md-ellipsis">`
770
771
772	`Cloud Sources`
773
774
775
776	`</span>`
777
778
779
780	`</a>`
781	`</li>`
782
783
784
785
786
787
788
789
790
791
792	`<li class="md-nav__item">`
793	`<a href="../../guide/knowledge-graphs/" class="md-nav__link">`
794
795
796
797	`<span class="md-ellipsis">`
798
799
800	`Knowledge Graphs`
801
802
803
804	`</span>`
805
806
807
808	`</a>`
809	`</li>`
810
811
812
813
814
815
816
817
818
819
820	`<li class="md-nav__item">`
821	`<a href="../../guide/companion/" class="md-nav__link">`
822
823
824
825	`<span class="md-ellipsis">`
826
827
828	`Interactive Companion`
829
830
831
832	`</span>`
833
834
835
836	`</a>`
837	`</li>`
838
839
840
841
842
843
844
845
846
847
848	`<li class="md-nav__item">`
849	`<a href="../../guide/planning-agent/" class="md-nav__link">`
850
851
852
853	`<span class="md-ellipsis">`
854
855
856	`Planning Agent`
857
858
859
860	`</span>`
861
862
863
864	`</a>`
865	`</li>`
866
867
868
869
870
871
872
873
874
875
876	`<li class="md-nav__item">`
877	`<a href="../../guide/authentication/" class="md-nav__link">`
878
879
880
881	`<span class="md-ellipsis">`
882
883
884	`Authentication`
885
886
887
888	`</span>`
889
890
891
892	`</a>`
893	`</li>`
894
895
896
897
898
899
900
901
902
903
904	`<li class="md-nav__item">`
905	`<a href="../../guide/export/" class="md-nav__link">`
906
907
908
909	`<span class="md-ellipsis">`
910
911
912	`Export & Documents`
913
914
915
916	`</span>`
917
918
919
920	`</a>`
921	`</li>`
922
923
924
925
926
927
928
929
930
931
932	`<li class="md-nav__item">`
933	`<a href="../../guide/output-formats/" class="md-nav__link">`
934
935
936
937	`<span class="md-ellipsis">`
938
939
940	`Output Formats`
941
942
943
944	`</span>`
945
946
947
948	`</a>`
949	`</li>`
950
951
952
953
954	`</ul>`
955	`</nav>`
956
957	`</li>`
958
959
960
961
962
963
964
965
966
967	`<li class="md-nav__item">`
968	`<a href="../../use-cases/" class="md-nav__link">`
969
970
971
972	`<span class="md-ellipsis">`
973
974
975	`Use Cases`
976
977
978
979	`</span>`
980
981
982
983	`</a>`
984	`</li>`
985
986
987
988
989
990
991
992
993
994	`<li class="md-nav__item">`
995	`<a href="../../cli-reference/" class="md-nav__link">`
996
997
998
999	`<span class="md-ellipsis">`
1000
1001
1002	`CLI Reference`
1003
1004
1005
1006	`</span>`
1007
1008
1009
1010	`</a>`
1011	`</li>`
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031	`<li class="md-nav__item md-nav__item--nested">`
1032
1033
1034
1035
1036
1037	`<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6" >`
1038
1039
1040	`<label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">`
1041
1042
1043
1044	`<span class="md-ellipsis">`
1045
1046
1047	`Architecture`
1048
1049
1050
1051	`</span>`
1052
1053
1054
1055	`<span class="md-nav__icon md-icon"></span>`
1056	`</label>`
1057
1058	`<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">`
1059	`<label class="md-nav__title" for="__nav_6">`
1060	`<span class="md-nav__icon md-icon"></span>`
1061
1062
1063	`Architecture`
1064
1065
1066	`</label>`
1067	`<ul class="md-nav__list" data-md-scrollfix>`
1068
1069
1070
1071
1072
1073
1074
1075	`<li class="md-nav__item">`
1076	`<a href="../../architecture/overview/" class="md-nav__link">`
1077
1078
1079
1080	`<span class="md-ellipsis">`
1081
1082
1083	`Overview`
1084
1085
1086
1087	`</span>`
1088
1089
1090
1091	`</a>`
1092	`</li>`
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103	`<li class="md-nav__item">`
1104	`<a href="../../architecture/providers/" class="md-nav__link">`
1105
1106
1107
1108	`<span class="md-ellipsis">`
1109
1110
1111	`Provider System`
1112
1113
1114
1115	`</span>`
1116
1117
1118
1119	`</a>`
1120	`</li>`
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131	`<li class="md-nav__item">`
1132	`<a href="../../architecture/pipeline/" class="md-nav__link">`
1133
1134
1135
1136	`<span class="md-ellipsis">`
1137
1138
1139	`Processing Pipeline`
1140
1141
1142
1143	`</span>`
1144
1145
1146
1147	`</a>`
1148	`</li>`
1149
1150
1151
1152
1153	`</ul>`
1154	`</nav>`
1155
1156	`</li>`
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181	`<li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">`
1182
1183
1184
1185	`<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" checked>`
1186
1187
1188	`<label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="">`
1189
1190
1191
1192	`<span class="md-ellipsis">`
1193
1194
1195	`API Reference`
1196
1197
1198
1199	`</span>`
1200
1201
1202
1203	`<span class="md-nav__icon md-icon"></span>`
1204	`</label>`
1205
1206	`<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="true">`
1207	`<label class="md-nav__title" for="__nav_7">`
1208	`<span class="md-nav__icon md-icon"></span>`
1209
1210
1211	`API Reference`
1212
1213
1214	`</label>`
1215	`<ul class="md-nav__list" data-md-scrollfix>`
1216
1217
1218
1219
1220
1221
1222
1223	`<li class="md-nav__item">`
1224	`<a href="../models/" class="md-nav__link">`
1225
1226
1227
1228	`<span class="md-ellipsis">`
1229
1230
1231	`Models`
1232
1233
1234
1235	`</span>`
1236
1237
1238
1239	`</a>`
1240	`</li>`
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251	`<li class="md-nav__item">`
1252	`<a href="../providers/" class="md-nav__link">`
1253
1254
1255
1256	`<span class="md-ellipsis">`
1257
1258
1259	`Providers`
1260
1261
1262
1263	`</span>`
1264
1265
1266
1267	`</a>`
1268	`</li>`
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279	`<li class="md-nav__item">`
1280	`<a href="../analyzers/" class="md-nav__link">`
1281
1282
1283
1284	`<span class="md-ellipsis">`
1285
1286
1287	`Analyzers`
1288
1289
1290
1291	`</span>`
1292
1293
1294
1295	`</a>`
1296	`</li>`
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307	`<li class="md-nav__item">`
1308	`<a href="../agent/" class="md-nav__link">`
1309
1310
1311
1312	`<span class="md-ellipsis">`
1313
1314
1315	`Agent & Skills`
1316
1317
1318
1319	`</span>`
1320
1321
1322
1323	`</a>`
1324	`</li>`
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337	`<li class="md-nav__item md-nav__item--active">`
1338
1339	`<input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">`
1340
1341
1342
1343
1344
1345	`<label class="md-nav__link md-nav__link--active" for="__toc">`
1346
1347
1348
1349	`<span class="md-ellipsis">`
1350
1351
1352	`Sources`
1353
1354
1355
1356	`</span>`
1357
1358
1359
1360	`<span class="md-nav__icon md-icon"></span>`
1361	`</label>`
1362
1363	`<a href="./" class="md-nav__link md-nav__link--active">`
1364
1365
1366
1367	`<span class="md-ellipsis">`
1368
1369
1370	`Sources`
1371
1372
1373
1374	`</span>`
1375
1376
1377
1378	`</a>`
1379
1380
1381
1382	`<nav class="md-nav md-nav--secondary" aria-label="Table of contents">`
1383
1384
1385
1386
1387
1388
1389	`<label class="md-nav__title" for="__toc">`
1390	`<span class="md-nav__icon md-icon"></span>`
1391	`Table of contents`
1392	`</label>`
1393	`<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>`
1394
1395	`<li class="md-nav__item">`
1396	`<a href="#video_processor.sources.base" class="md-nav__link">`
1397	`<span class="md-ellipsis">`
1398
1399	`base`
1400
1401	`</span>`
1402	`</a>`
1403
1404	`<nav class="md-nav" aria-label="base">`
1405	`<ul class="md-nav__list">`
1406
1407	`<li class="md-nav__item">`
1408	`<a href="#video_processor.sources.base.BaseSource" class="md-nav__link">`
1409	`<span class="md-ellipsis">`
1410
1411	`BaseSource`
1412
1413	`</span>`
1414	`</a>`
1415
1416	`<nav class="md-nav" aria-label="BaseSource">`
1417	`<ul class="md-nav__list">`
1418
1419	`<li class="md-nav__item">`
1420	`<a href="#video_processor.sources.base.BaseSource.authenticate" class="md-nav__link">`
1421	`<span class="md-ellipsis">`
1422
1423	`authenticate`
1424
1425	`</span>`
1426	`</a>`
1427
1428	`</li>`
1429
1430	`<li class="md-nav__item">`
1431	`<a href="#video_processor.sources.base.BaseSource.download" class="md-nav__link">`
1432	`<span class="md-ellipsis">`
1433
1434	`download`
1435
1436	`</span>`
1437	`</a>`
1438
1439	`</li>`
1440
1441	`<li class="md-nav__item">`
1442	`<a href="#video_processor.sources.base.BaseSource.download_all" class="md-nav__link">`
1443	`<span class="md-ellipsis">`
1444
1445	`download_all`
1446
1447	`</span>`
1448	`</a>`
1449
1450	`</li>`
1451
1452	`<li class="md-nav__item">`
1453	`<a href="#video_processor.sources.base.BaseSource.list_videos" class="md-nav__link">`
1454	`<span class="md-ellipsis">`
1455
1456	`list_videos`
1457
1458	`</span>`
1459	`</a>`
1460
1461	`</li>`
1462
1463	`</ul>`
1464	`</nav>`
1465
1466	`</li>`
1467
1468	`<li class="md-nav__item">`
1469	`<a href="#video_processor.sources.base.SourceFile" class="md-nav__link">`
1470	`<span class="md-ellipsis">`
1471
1472	`SourceFile`
1473
1474	`</span>`
1475	`</a>`
1476
1477	`</li>`
1478
1479	`</ul>`
1480	`</nav>`
1481
1482	`</li>`
1483
1484	`<li class="md-nav__item">`
1485	`<a href="#overview" class="md-nav__link">`
1486	`<span class="md-ellipsis">`
1487
1488	`Overview`
1489
1490	`</span>`
1491	`</a>`
1492
1493	`</li>`
1494
1495	`<li class="md-nav__item">`
1496	`<a href="#basesource-abc" class="md-nav__link">`
1497	`<span class="md-ellipsis">`
1498
1499	`BaseSource (ABC)`
1500
1501	`</span>`
1502	`</a>`
1503
1504	`<nav class="md-nav" aria-label="BaseSource (ABC)">`
1505	`<ul class="md-nav__list">`
1506
1507	`<li class="md-nav__item">`
1508	`<a href="#authenticate" class="md-nav__link">`
1509	`<span class="md-ellipsis">`
1510
1511	`authenticate()`
1512
1513	`</span>`
1514	`</a>`
1515
1516	`</li>`
1517
1518	`<li class="md-nav__item">`
1519	`<a href="#list_videos" class="md-nav__link">`
1520	`<span class="md-ellipsis">`
1521
1522	`list_videos()`
1523
1524	`</span>`
1525	`</a>`
1526
1527	`</li>`
1528
1529	`<li class="md-nav__item">`
1530	`<a href="#download" class="md-nav__link">`
1531	`<span class="md-ellipsis">`
1532
1533	`download()`
1534
1535	`</span>`
1536	`</a>`
1537
1538	`</li>`
1539
1540	`<li class="md-nav__item">`
1541	`<a href="#download_all" class="md-nav__link">`
1542	`<span class="md-ellipsis">`
1543
1544	`download_all()`
1545
1546	`</span>`
1547	`</a>`
1548
1549	`</li>`
1550
1551	`</ul>`
1552	`</nav>`
1553
1554	`</li>`
1555
1556	`<li class="md-nav__item">`
1557	`<a href="#sourcefile" class="md-nav__link">`
1558	`<span class="md-ellipsis">`
1559
1560	`SourceFile`
1561
1562	`</span>`
1563	`</a>`
1564
1565	`</li>`
1566
1567	`<li class="md-nav__item">`
1568	`<a href="#lazy-loading-pattern" class="md-nav__link">`
1569	`<span class="md-ellipsis">`
1570
1571	`Lazy Loading Pattern`
1572
1573	`</span>`
1574	`</a>`
1575
1576	`</li>`
1577
1578	`<li class="md-nav__item">`
1579	`<a href="#available-sources" class="md-nav__link">`
1580	`<span class="md-ellipsis">`
1581
1582	`Available Sources`
1583
1584	`</span>`
1585	`</a>`
1586
1587	`<nav class="md-nav" aria-label="Available Sources">`
1588	`<ul class="md-nav__list">`
1589
1590	`<li class="md-nav__item">`
1591	`<a href="#cloud-recordings" class="md-nav__link">`
1592	`<span class="md-ellipsis">`
1593
1594	`Cloud Recordings`
1595
1596	`</span>`
1597	`</a>`
1598
1599	`</li>`
1600
1601	`<li class="md-nav__item">`
1602	`<a href="#cloud-storage-and-workspace" class="md-nav__link">`
1603	`<span class="md-ellipsis">`
1604
1605	`Cloud Storage and Workspace`
1606
1607	`</span>`
1608	`</a>`
1609
1610	`</li>`
1611
1612	`<li class="md-nav__item">`
1613	`<a href="#notes-applications" class="md-nav__link">`
1614	`<span class="md-ellipsis">`
1615
1616	`Notes Applications`
1617
1618	`</span>`
1619	`</a>`
1620
1621	`</li>`
1622
1623	`<li class="md-nav__item">`
1624	`<a href="#web-and-content" class="md-nav__link">`
1625	`<span class="md-ellipsis">`
1626
1627	`Web and Content`
1628
1629	`</span>`
1630	`</a>`
1631
1632	`</li>`
1633
1634	`</ul>`
1635	`</nav>`
1636
1637	`</li>`
1638
1639	`<li class="md-nav__item">`
1640	`<a href="#auth-integration" class="md-nav__link">`
1641	`<span class="md-ellipsis">`
1642
1643	`Auth Integration`
1644
1645	`</span>`
1646	`</a>`
1647
1648	`</li>`
1649
1650	`<li class="md-nav__item">`
1651	`<a href="#usage-examples" class="md-nav__link">`
1652	`<span class="md-ellipsis">`
1653
1654	`Usage Examples`
1655
1656	`</span>`
1657	`</a>`
1658
1659	`<nav class="md-nav" aria-label="Usage Examples">`
1660	`<ul class="md-nav__list">`
1661
1662	`<li class="md-nav__item">`
1663	`<a href="#listing-and-downloading-zoom-recordings" class="md-nav__link">`
1664	`<span class="md-ellipsis">`
1665
1666	`Listing and downloading Zoom recordings`
1667
1668	`</span>`
1669	`</a>`
1670
1671	`</li>`
1672
1673	`<li class="md-nav__item">`
1674	`<a href="#fetching-from-multiple-sources" class="md-nav__link">`
1675	`<span class="md-ellipsis">`
1676
1677	`Fetching from multiple sources`
1678
1679	`</span>`
1680	`</a>`
1681
1682	`</li>`
1683
1684	`<li class="md-nav__item">`
1685	`<a href="#youtube-content" class="md-nav__link">`
1686	`<span class="md-ellipsis">`
1687
1688	`YouTube content`
1689
1690	`</span>`
1691	`</a>`
1692
1693	`</li>`
1694
1695	`</ul>`
1696	`</nav>`
1697
1698	`</li>`
1699
1700	`</ul>`
1701
1702	`</nav>`
1703
1704	`</li>`
1705
1706
1707
1708
1709
1710
1711
1712
1713
1714
1715	`<li class="md-nav__item">`
1716	`<a href="../auth/" class="md-nav__link">`
1717
1718
1719
1720	`<span class="md-ellipsis">`
1721
1722
1723	`Authentication`
1724
1725
1726
1727	`</span>`
1728
1729
1730
1731	`</a>`
1732	`</li>`
1733
1734
1735
1736
1737	`</ul>`
1738	`</nav>`
1739
1740	`</li>`
1741
1742
1743
1744
1745
1746
1747
1748
1749
1750	`<li class="md-nav__item">`
1751	`<a href="../../faq/" class="md-nav__link">`
1752
1753
1754
1755	`<span class="md-ellipsis">`
1756
1757
1758	`FAQ & Troubleshooting`
1759
1760
1761
1762	`</span>`
1763
1764
1765
1766	`</a>`
1767	`</li>`
1768
1769
1770
1771
1772
1773
1774
1775
1776
1777	`<li class="md-nav__item">`
1778	`<a href="../../contributing/" class="md-nav__link">`
1779
1780
1781
1782	`<span class="md-ellipsis">`
1783
1784
1785	`Contributing`
1786
1787
1788
1789	`</span>`
1790
1791
1792
1793	`</a>`
1794	`</li>`
1795
1796
1797
1798	`</ul>`
1799	`</nav>`
1800	`</div>`
1801	`</div>`
1802	`</div>`
1803
1804
1805
1806	`<div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >`
1807	`<div class="md-sidebar__scrollwrap">`
1808	`<div class="md-sidebar__inner">`
1809
1810
1811	`<nav class="md-nav md-nav--secondary" aria-label="Table of contents">`
1812
1813
1814
1815
1816
1817
1818	`<label class="md-nav__title" for="__toc">`
1819	`<span class="md-nav__icon md-icon"></span>`
1820	`Table of contents`
1821	`</label>`
1822	`<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>`
1823
1824	`<li class="md-nav__item">`
1825	`<a href="#video_processor.sources.base" class="md-nav__link">`
1826	`<span class="md-ellipsis">`
1827
1828	`base`
1829
1830	`</span>`
1831	`</a>`
1832
1833	`<nav class="md-nav" aria-label="base">`
1834	`<ul class="md-nav__list">`
1835
1836	`<li class="md-nav__item">`
1837	`<a href="#video_processor.sources.base.BaseSource" class="md-nav__link">`
1838	`<span class="md-ellipsis">`
1839
1840	`BaseSource`
1841
1842	`</span>`
1843	`</a>`
1844
1845	`<nav class="md-nav" aria-label="BaseSource">`
1846	`<ul class="md-nav__list">`
1847
1848	`<li class="md-nav__item">`
1849	`<a href="#video_processor.sources.base.BaseSource.authenticate" class="md-nav__link">`
1850	`<span class="md-ellipsis">`
1851
1852	`authenticate`
1853
1854	`</span>`
1855	`</a>`
1856
1857	`</li>`
1858
1859	`<li class="md-nav__item">`
1860	`<a href="#video_processor.sources.base.BaseSource.download" class="md-nav__link">`
1861	`<span class="md-ellipsis">`
1862
1863	`download`
1864
1865	`</span>`
1866	`</a>`
1867
1868	`</li>`
1869
1870	`<li class="md-nav__item">`
1871	`<a href="#video_processor.sources.base.BaseSource.download_all" class="md-nav__link">`
1872	`<span class="md-ellipsis">`
1873
1874	`download_all`
1875
1876	`</span>`
1877	`</a>`
1878
1879	`</li>`
1880
1881	`<li class="md-nav__item">`
1882	`<a href="#video_processor.sources.base.BaseSource.list_videos" class="md-nav__link">`
1883	`<span class="md-ellipsis">`
1884
1885	`list_videos`
1886
1887	`</span>`
1888	`</a>`
1889
1890	`</li>`
1891
1892	`</ul>`
1893	`</nav>`
1894
1895	`</li>`
1896
1897	`<li class="md-nav__item">`
1898	`<a href="#video_processor.sources.base.SourceFile" class="md-nav__link">`
1899	`<span class="md-ellipsis">`
1900
1901	`SourceFile`
1902
1903	`</span>`
1904	`</a>`
1905
1906	`</li>`
1907
1908	`</ul>`
1909	`</nav>`
1910
1911	`</li>`
1912
1913	`<li class="md-nav__item">`
1914	`<a href="#overview" class="md-nav__link">`
1915	`<span class="md-ellipsis">`
1916
1917	`Overview`
1918
1919	`</span>`
1920	`</a>`
1921
1922	`</li>`
1923
1924	`<li class="md-nav__item">`
1925	`<a href="#basesource-abc" class="md-nav__link">`
1926	`<span class="md-ellipsis">`
1927
1928	`BaseSource (ABC)`
1929
1930	`</span>`
1931	`</a>`
1932
1933	`<nav class="md-nav" aria-label="BaseSource (ABC)">`
1934	`<ul class="md-nav__list">`
1935
1936	`<li class="md-nav__item">`
1937	`<a href="#authenticate" class="md-nav__link">`
1938	`<span class="md-ellipsis">`
1939
1940	`authenticate()`
1941
1942	`</span>`
1943	`</a>`
1944
1945	`</li>`
1946
1947	`<li class="md-nav__item">`
1948	`<a href="#list_videos" class="md-nav__link">`
1949	`<span class="md-ellipsis">`
1950
1951	`list_videos()`
1952
1953	`</span>`
1954	`</a>`
1955
1956	`</li>`
1957
1958	`<li class="md-nav__item">`
1959	`<a href="#download" class="md-nav__link">`
1960	`<span class="md-ellipsis">`
1961
1962	`download()`
1963
1964	`</span>`
1965	`</a>`
1966
1967	`</li>`
1968
1969	`<li class="md-nav__item">`
1970	`<a href="#download_all" class="md-nav__link">`
1971	`<span class="md-ellipsis">`
1972
1973	`download_all()`
1974
1975	`</span>`
1976	`</a>`
1977
1978	`</li>`
1979
1980	`</ul>`
1981	`</nav>`
1982
1983	`</li>`
1984
1985	`<li class="md-nav__item">`
1986	`<a href="#sourcefile" class="md-nav__link">`
1987	`<span class="md-ellipsis">`
1988
1989	`SourceFile`
1990
1991	`</span>`
1992	`</a>`
1993
1994	`</li>`
1995
1996	`<li class="md-nav__item">`
1997	`<a href="#lazy-loading-pattern" class="md-nav__link">`
1998	`<span class="md-ellipsis">`
1999
2000	`Lazy Loading Pattern`
2001
2002	`</span>`
2003	`</a>`
2004
2005	`</li>`
2006
2007	`<li class="md-nav__item">`
2008	`<a href="#available-sources" class="md-nav__link">`
2009	`<span class="md-ellipsis">`
2010
2011	`Available Sources`
2012
2013	`</span>`
2014	`</a>`
2015
2016	`<nav class="md-nav" aria-label="Available Sources">`
2017	`<ul class="md-nav__list">`
2018
2019	`<li class="md-nav__item">`
2020	`<a href="#cloud-recordings" class="md-nav__link">`
2021	`<span class="md-ellipsis">`
2022
2023	`Cloud Recordings`
2024
2025	`</span>`
2026	`</a>`
2027
2028	`</li>`
2029
2030	`<li class="md-nav__item">`
2031	`<a href="#cloud-storage-and-workspace" class="md-nav__link">`
2032	`<span class="md-ellipsis">`
2033
2034	`Cloud Storage and Workspace`
2035
2036	`</span>`
2037	`</a>`
2038
2039	`</li>`
2040
2041	`<li class="md-nav__item">`
2042	`<a href="#notes-applications" class="md-nav__link">`
2043	`<span class="md-ellipsis">`
2044
2045	`Notes Applications`
2046
2047	`</span>`
2048	`</a>`
2049
2050	`</li>`
2051
2052	`<li class="md-nav__item">`
2053	`<a href="#web-and-content" class="md-nav__link">`
2054	`<span class="md-ellipsis">`
2055
2056	`Web and Content`
2057
2058	`</span>`
2059	`</a>`
2060
2061	`</li>`
2062
2063	`</ul>`
2064	`</nav>`
2065
2066	`</li>`
2067
2068	`<li class="md-nav__item">`
2069	`<a href="#auth-integration" class="md-nav__link">`
2070	`<span class="md-ellipsis">`
2071
2072	`Auth Integration`
2073
2074	`</span>`
2075	`</a>`
2076
2077	`</li>`
2078
2079	`<li class="md-nav__item">`
2080	`<a href="#usage-examples" class="md-nav__link">`
2081	`<span class="md-ellipsis">`
2082
2083	`Usage Examples`
2084
2085	`</span>`
2086	`</a>`
2087
2088	`<nav class="md-nav" aria-label="Usage Examples">`
2089	`<ul class="md-nav__list">`
2090
2091	`<li class="md-nav__item">`
2092	`<a href="#listing-and-downloading-zoom-recordings" class="md-nav__link">`
2093	`<span class="md-ellipsis">`
2094
2095	`Listing and downloading Zoom recordings`
2096
2097	`</span>`
2098	`</a>`
2099
2100	`</li>`
2101
2102	`<li class="md-nav__item">`
2103	`<a href="#fetching-from-multiple-sources" class="md-nav__link">`
2104	`<span class="md-ellipsis">`
2105
2106	`Fetching from multiple sources`
2107
2108	`</span>`
2109	`</a>`
2110
2111	`</li>`
2112
2113	`<li class="md-nav__item">`
2114	`<a href="#youtube-content" class="md-nav__link">`
2115	`<span class="md-ellipsis">`
2116
2117	`YouTube content`
2118
2119	`</span>`
2120	`</a>`
2121
2122	`</li>`
2123
2124	`</ul>`
2125	`</nav>`
2126
2127	`</li>`
2128
2129	`</ul>`
2130
2131	`</nav>`
2132	`</div>`
2133	`</div>`
2134	`</div>`
2135
2136
2137
2138	`<div class="md-content" data-md-component="content">`
2139
2140	`<article class="md-content__inner md-typeset">`
2141
2142
2143
2144
2145
2146
2147
2148
2149	`<h1 id="sources-api-reference">Sources API Reference<a class="headerlink" href="#sources-api-reference" title="Permanent link">¶</a></h1>`
2150
2151
2152	`<div class="doc doc-object doc-module">`
2153
2154
2155
2156	`<h2 id="video_processor.sources.base" class="doc doc-heading">`
2157	`<code>video_processor.sources.base</code>`
2158
2159
2160	`<a href="#video_processor.sources.base" class="headerlink" title="Permanent link">¶</a></h2>`
2161
2162	`<div class="doc doc-contents first">`
2163
2164	`<p>Base interface for cloud source integrations.</p>`
2165
2166
2167
2168
2169
2170
2171
2172
2173
2174
2175	`<div class="doc doc-children">`
2176
2177
2178
2179
2180
2181
2182
2183
2184
2185	`<div class="doc doc-object doc-class">`
2186
2187
2188
2189	`<h3 id="video_processor.sources.base.BaseSource" class="doc doc-heading">`
2190	`<code>BaseSource</code>`
2191
2192
2193	`<a href="#video_processor.sources.base.BaseSource" class="headerlink" title="Permanent link">¶</a></h3>`
2194
2195
2196	`<div class="doc doc-contents ">`
2197	`<p class="doc doc-class-bases">`
2198	`Bases: <code><span title="abc.ABC">ABC</span></code></p>`
2199
2200
2201
2202	`<p>Abstract base class for cloud source integrations.</p>`
2203
2204
2205
2206
2207
2208
2209
2210
2211	`<details class="mkdocstrings-source">`
2212	`<summary>Source code in <code>video_processor/sources/base.py</code></summary>`
2213	`<div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-24">24</a></span>`
2214	`<span class="normal"><a href="#__codelineno-0-25">25</a></span>`
2215	`<span class="normal"><a href="#__codelineno-0-26">26</a></span>`
2216	`<span class="normal"><a href="#__codelineno-0-27">27</a></span>`
2217	`<span class="normal"><a href="#__codelineno-0-28">28</a></span>`
2218	`<span class="normal"><a href="#__codelineno-0-29">29</a></span>`
2219	`<span class="normal"><a href="#__codelineno-0-30">30</a></span>`
2220	`<span class="normal"><a href="#__codelineno-0-31">31</a></span>`
2221	`<span class="normal"><a href="#__codelineno-0-32">32</a></span>`
2222	`<span class="normal"><a href="#__codelineno-0-33">33</a></span>`
2223	`<span class="normal"><a href="#__codelineno-0-34">34</a></span>`
2224	`<span class="normal"><a href="#__codelineno-0-35">35</a></span>`
2225	`<span class="normal"><a href="#__codelineno-0-36">36</a></span>`
2226	`<span class="normal"><a href="#__codelineno-0-37">37</a></span>`
2227	`<span class="normal"><a href="#__codelineno-0-38">38</a></span>`
2228	`<span class="normal"><a href="#__codelineno-0-39">39</a></span>`
2229	`<span class="normal"><a href="#__codelineno-0-40">40</a></span>`
2230	`<span class="normal"><a href="#__codelineno-0-41">41</a></span>`
2231	`<span class="normal"><a href="#__codelineno-0-42">42</a></span>`
2232	`<span class="normal"><a href="#__codelineno-0-43">43</a></span>`
2233	`<span class="normal"><a href="#__codelineno-0-44">44</a></span>`
2234	`<span class="normal"><a href="#__codelineno-0-45">45</a></span>`
2235	`<span class="normal"><a href="#__codelineno-0-46">46</a></span>`
2236	`<span class="normal"><a href="#__codelineno-0-47">47</a></span>`
2237	`<span class="normal"><a href="#__codelineno-0-48">48</a></span>`
2238	`<span class="normal"><a href="#__codelineno-0-49">49</a></span>`
2239	`<span class="normal"><a href="#__codelineno-0-50">50</a></span>`
2240	`<span class="normal"><a href="#__codelineno-0-51">51</a></span>`
2241	`<span class="normal"><a href="#__codelineno-0-52">52</a></span>`
2242	`<span class="normal"><a href="#__codelineno-0-53">53</a></span>`
2243	`<span class="normal"><a href="#__codelineno-0-54">54</a></span>`
2244	`<span class="normal"><a href="#__codelineno-0-55">55</a></span>`
2245	`<span class="normal"><a href="#__codelineno-0-56">56</a></span>`
2246	`<span class="normal"><a href="#__codelineno-0-57">57</a></span>`
2247	`<span class="normal"><a href="#__codelineno-0-58">58</a></span>`
2248	`<span class="normal"><a href="#__codelineno-0-59">59</a></span>`
2249	`<span class="normal"><a href="#__codelineno-0-60">60</a></span>`
2250	`<span class="normal"><a href="#__codelineno-0-61">61</a></span>`
2251	`<span class="normal"><a href="#__codelineno-0-62">62</a></span>`
2252	`<span class="normal"><a href="#__codelineno-0-63">63</a></span>`
2253	`<span class="normal"><a href="#__codelineno-0-64">64</a></span>`
2254	`<span class="normal"><a href="#__codelineno-0-65">65</a></span>`
2255	`<span class="normal"><a href="#__codelineno-0-66">66</a></span>`
2256	`<span class="normal"><a href="#__codelineno-0-67">67</a></span>`
2257	`<span class="normal"><a href="#__codelineno-0-68">68</a></span>`
2258	`<span class="normal"><a href="#__codelineno-0-69">69</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-24" name="__codelineno-0-24"></a><span class="k">class</span><span class="w"> </span><span class="nc">BaseSource</span><span class="p">(</span><span class="n">ABC</span><span class="p">):</span>`
2259	`<a id="__codelineno-0-25" name="__codelineno-0-25"></a><span class="w"> </span><span class="sd">"""Abstract base class for cloud source integrations."""</span>`
2260	`<a id="__codelineno-0-26" name="__codelineno-0-26"></a>`
2261	`<a id="__codelineno-0-27" name="__codelineno-0-27"></a> <span class="nd">@abstractmethod</span>`
2262	`<a id="__codelineno-0-28" name="__codelineno-0-28"></a> <span class="k">def</span><span class="w"> </span><span class="nf">authenticate</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="nb">bool</span><span class="p">:</span>`
2263	`<a id="__codelineno-0-29" name="__codelineno-0-29"></a><span class="w"> </span><span class="sd">"""Authenticate with the cloud provider. Returns True on success."""</span>`
2264	`<a id="__codelineno-0-30" name="__codelineno-0-30"></a> <span class="o">...</span>`
2265	`<a id="__codelineno-0-31" name="__codelineno-0-31"></a>`
2266	`<a id="__codelineno-0-32" name="__codelineno-0-32"></a> <span class="nd">@abstractmethod</span>`
2267	`<a id="__codelineno-0-33" name="__codelineno-0-33"></a> <span class="k">def</span><span class="w"> </span><span class="nf">list_videos</span><span class="p">(</span>`
2268	`<a id="__codelineno-0-34" name="__codelineno-0-34"></a> <span class="bp">self</span><span class="p">,</span>`
2269	`<a id="__codelineno-0-35" name="__codelineno-0-35"></a> <span class="n">folder_id</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>`
2270	`<a id="__codelineno-0-36" name="__codelineno-0-36"></a> <span class="n">folder_path</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>`
2271	`<a id="__codelineno-0-37" name="__codelineno-0-37"></a> <span class="n">patterns</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>`
2272	`<a id="__codelineno-0-38" name="__codelineno-0-38"></a> <span class="p">)</span> <span class="o">-></span> <span class="n">List</span><span class="p">[</span><span class="n">SourceFile</span><span class="p">]:</span>`
2273	`<a id="__codelineno-0-39" name="__codelineno-0-39"></a><span class="w"> </span><span class="sd">"""List video files in a folder."""</span>`
2274	`<a id="__codelineno-0-40" name="__codelineno-0-40"></a> <span class="o">...</span>`
2275	`<a id="__codelineno-0-41" name="__codelineno-0-41"></a>`
2276	`<a id="__codelineno-0-42" name="__codelineno-0-42"></a> <span class="nd">@abstractmethod</span>`
2277	`<a id="__codelineno-0-43" name="__codelineno-0-43"></a> <span class="k">def</span><span class="w"> </span><span class="nf">download</span><span class="p">(</span>`
2278	`<a id="__codelineno-0-44" name="__codelineno-0-44"></a> <span class="bp">self</span><span class="p">,</span>`
2279	`<a id="__codelineno-0-45" name="__codelineno-0-45"></a> <span class="n">file</span><span class="p">:</span> <span class="n">SourceFile</span><span class="p">,</span>`
2280	`<a id="__codelineno-0-46" name="__codelineno-0-46"></a> <span class="n">destination</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span>`
2281	`<a id="__codelineno-0-47" name="__codelineno-0-47"></a> <span class="p">)</span> <span class="o">-></span> <span class="n">Path</span><span class="p">:</span>`
2282	`<a id="__codelineno-0-48" name="__codelineno-0-48"></a><span class="w"> </span><span class="sd">"""Download a file to a local path. Returns the local path."""</span>`
2283	`<a id="__codelineno-0-49" name="__codelineno-0-49"></a> <span class="o">...</span>`
2284	`<a id="__codelineno-0-50" name="__codelineno-0-50"></a>`
2285	`<a id="__codelineno-0-51" name="__codelineno-0-51"></a> <span class="k">def</span><span class="w"> </span><span class="nf">download_all</span><span class="p">(</span>`
2286	`<a id="__codelineno-0-52" name="__codelineno-0-52"></a> <span class="bp">self</span><span class="p">,</span>`
2287	`<a id="__codelineno-0-53" name="__codelineno-0-53"></a> <span class="n">files</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="n">SourceFile</span><span class="p">],</span>`
2288	`<a id="__codelineno-0-54" name="__codelineno-0-54"></a> <span class="n">destination_dir</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span>`
2289	`<a id="__codelineno-0-55" name="__codelineno-0-55"></a> <span class="p">)</span> <span class="o">-></span> <span class="n">List</span><span class="p">[</span><span class="n">Path</span><span class="p">]:</span>`
2290	`<a id="__codelineno-0-56" name="__codelineno-0-56"></a><span class="w"> </span><span class="sd">"""Download multiple files to a directory, preserving subfolder structure."""</span>`
2291	`<a id="__codelineno-0-57" name="__codelineno-0-57"></a> <span class="n">destination_dir</span><span class="o">.</span><span class="n">mkdir</span><span class="p">(</span><span class="n">parents</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">exist_ok</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>`
2292	`<a id="__codelineno-0-58" name="__codelineno-0-58"></a> <span class="n">paths</span> <span class="o">=</span> <span class="p">[]</span>`
2293	`<a id="__codelineno-0-59" name="__codelineno-0-59"></a> <span class="k">for</span> <span class="n">f</span> <span class="ow">in</span> <span class="n">files</span><span class="p">:</span>`
2294	`<a id="__codelineno-0-60" name="__codelineno-0-60"></a> <span class="c1"># Use path (with subfolder) if available, otherwise just name</span>`
2295	`<a id="__codelineno-0-61" name="__codelineno-0-61"></a> <span class="n">relative</span> <span class="o">=</span> <span class="n">f</span><span class="o">.</span><span class="n">path</span> <span class="k">if</span> <span class="n">f</span><span class="o">.</span><span class="n">path</span> <span class="k">else</span> <span class="n">f</span><span class="o">.</span><span class="n">name</span>`
2296	`<a id="__codelineno-0-62" name="__codelineno-0-62"></a> <span class="n">dest</span> <span class="o">=</span> <span class="n">destination_dir</span> <span class="o">/</span> <span class="n">relative</span>`
2297	`<a id="__codelineno-0-63" name="__codelineno-0-63"></a> <span class="k">try</span><span class="p">:</span>`
2298	`<a id="__codelineno-0-64" name="__codelineno-0-64"></a> <span class="n">local_path</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">download</span><span class="p">(</span><span class="n">f</span><span class="p">,</span> <span class="n">dest</span><span class="p">)</span>`
2299	`<a id="__codelineno-0-65" name="__codelineno-0-65"></a> <span class="n">paths</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">local_path</span><span class="p">)</span>`
2300	`<a id="__codelineno-0-66" name="__codelineno-0-66"></a> <span class="n">logger</span><span class="o">.</span><span class="n">info</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Downloaded: </span><span class="si">{</span><span class="n">relative</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span>`
2301	`<a id="__codelineno-0-67" name="__codelineno-0-67"></a> <span class="k">except</span> <span class="ne">Exception</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>`
2302	`<a id="__codelineno-0-68" name="__codelineno-0-68"></a> <span class="n">logger</span><span class="o">.</span><span class="n">error</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Failed to download </span><span class="si">{</span><span class="n">relative</span><span class="si">}</span><span class="s2">: </span><span class="si">{</span><span class="n">e</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span>`
2303	`<a id="__codelineno-0-69" name="__codelineno-0-69"></a> <span class="k">return</span> <span class="n">paths</span>`
2304	`</code></pre></div></td></tr></table></div>`
2305	`</details>`
2306
2307
2308
2309	`<div class="doc doc-children">`
2310
2311
2312
2313
2314
2315
2316
2317
2318
2319
2320	`<div class="doc doc-object doc-function">`
2321
2322
2323	`<h4 id="video_processor.sources.base.BaseSource.authenticate" class="doc doc-heading">`
2324	`<code class="highlight language-python"><span class="n">authenticate</span><span class="p">()</span></code>`
2325
2326	`<span class="doc doc-labels">`
2327	`<small class="doc doc-label doc-label-abstractmethod"><code>abstractmethod</code></small>`
2328	`</span>`
2329
2330	`<a href="#video_processor.sources.base.BaseSource.authenticate" class="headerlink" title="Permanent link">¶</a></h4>`
2331
2332
2333	`<div class="doc doc-contents ">`
2334
2335	`<p>Authenticate with the cloud provider. Returns True on success.</p>`
2336
2337
2338	`<details class="mkdocstrings-source">`
2339	`<summary>Source code in <code>video_processor/sources/base.py</code></summary>`
2340	`<div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-27">27</a></span>`
2341	`<span class="normal"><a href="#__codelineno-0-28">28</a></span>`
2342	`<span class="normal"><a href="#__codelineno-0-29">29</a></span>`
2343	`<span class="normal"><a href="#__codelineno-0-30">30</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-27" name="__codelineno-0-27"></a><span class="nd">@abstractmethod</span>`
2344	`<a id="__codelineno-0-28" name="__codelineno-0-28"></a><span class="k">def</span><span class="w"> </span><span class="nf">authenticate</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="nb">bool</span><span class="p">:</span>`
2345	`<a id="__codelineno-0-29" name="__codelineno-0-29"></a><span class="w"> </span><span class="sd">"""Authenticate with the cloud provider. Returns True on success."""</span>`
2346	`<a id="__codelineno-0-30" name="__codelineno-0-30"></a> <span class="o">...</span>`
2347	`</code></pre></div></td></tr></table></div>`
2348	`</details>`
2349	`</div>`
2350
2351	`</div>`
2352
2353	`<div class="doc doc-object doc-function">`
2354
2355
2356	`<h4 id="video_processor.sources.base.BaseSource.download" class="doc doc-heading">`
2357	`<code class="highlight language-python"><span class="n">download</span><span class="p">(</span><span class="n">file</span><span class="p">,</span> <span class="n">destination</span><span class="p">)</span></code>`
2358
2359	`<span class="doc doc-labels">`
2360	`<small class="doc doc-label doc-label-abstractmethod"><code>abstractmethod</code></small>`
2361	`</span>`
2362
2363	`<a href="#video_processor.sources.base.BaseSource.download" class="headerlink" title="Permanent link">¶</a></h4>`
2364
2365
2366	`<div class="doc doc-contents ">`
2367
2368	`<p>Download a file to a local path. Returns the local path.</p>`
2369
2370
2371	`<details class="mkdocstrings-source">`
2372	`<summary>Source code in <code>video_processor/sources/base.py</code></summary>`
2373	`<div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-42">42</a></span>`
2374	`<span class="normal"><a href="#__codelineno-0-43">43</a></span>`
2375	`<span class="normal"><a href="#__codelineno-0-44">44</a></span>`
2376	`<span class="normal"><a href="#__codelineno-0-45">45</a></span>`
2377	`<span class="normal"><a href="#__codelineno-0-46">46</a></span>`
2378	`<span class="normal"><a href="#__codelineno-0-47">47</a></span>`
2379	`<span class="normal"><a href="#__codelineno-0-48">48</a></span>`
2380	`<span class="normal"><a href="#__codelineno-0-49">49</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-42" name="__codelineno-0-42"></a><span class="nd">@abstractmethod</span>`
2381	`<a id="__codelineno-0-43" name="__codelineno-0-43"></a><span class="k">def</span><span class="w"> </span><span class="nf">download</span><span class="p">(</span>`
2382	`<a id="__codelineno-0-44" name="__codelineno-0-44"></a> <span class="bp">self</span><span class="p">,</span>`
2383	`<a id="__codelineno-0-45" name="__codelineno-0-45"></a> <span class="n">file</span><span class="p">:</span> <span class="n">SourceFile</span><span class="p">,</span>`
2384	`<a id="__codelineno-0-46" name="__codelineno-0-46"></a> <span class="n">destination</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span>`
2385	`<a id="__codelineno-0-47" name="__codelineno-0-47"></a><span class="p">)</span> <span class="o">-></span> <span class="n">Path</span><span class="p">:</span>`
2386	`<a id="__codelineno-0-48" name="__codelineno-0-48"></a><span class="w"> </span><span class="sd">"""Download a file to a local path. Returns the local path."""</span>`
2387	`<a id="__codelineno-0-49" name="__codelineno-0-49"></a> <span class="o">...</span>`
2388	`</code></pre></div></td></tr></table></div>`
2389	`</details>`
2390	`</div>`
2391
2392	`</div>`
2393
2394	`<div class="doc doc-object doc-function">`
2395
2396
2397	`<h4 id="video_processor.sources.base.BaseSource.download_all" class="doc doc-heading">`
2398	`<code class="highlight language-python"><span class="n">download_all</span><span class="p">(</span><span class="n">files</span><span class="p">,</span> <span class="n">destination_dir</span><span class="p">)</span></code>`
2399
2400	`<a href="#video_processor.sources.base.BaseSource.download_all" class="headerlink" title="Permanent link">¶</a></h4>`
2401
2402
2403	`<div class="doc doc-contents ">`
2404
2405	`<p>Download multiple files to a directory, preserving subfolder structure.</p>`
2406
2407
2408	`<details class="mkdocstrings-source">`
2409	`<summary>Source code in <code>video_processor/sources/base.py</code></summary>`
2410	`<div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-51">51</a></span>`
2411	`<span class="normal"><a href="#__codelineno-0-52">52</a></span>`
2412	`<span class="normal"><a href="#__codelineno-0-53">53</a></span>`
2413	`<span class="normal"><a href="#__codelineno-0-54">54</a></span>`
2414	`<span class="normal"><a href="#__codelineno-0-55">55</a></span>`
2415	`<span class="normal"><a href="#__codelineno-0-56">56</a></span>`
2416	`<span class="normal"><a href="#__codelineno-0-57">57</a></span>`
2417	`<span class="normal"><a href="#__codelineno-0-58">58</a></span>`
2418	`<span class="normal"><a href="#__codelineno-0-59">59</a></span>`
2419	`<span class="normal"><a href="#__codelineno-0-60">60</a></span>`
2420	`<span class="normal"><a href="#__codelineno-0-61">61</a></span>`
2421	`<span class="normal"><a href="#__codelineno-0-62">62</a></span>`
2422	`<span class="normal"><a href="#__codelineno-0-63">63</a></span>`
2423	`<span class="normal"><a href="#__codelineno-0-64">64</a></span>`
2424	`<span class="normal"><a href="#__codelineno-0-65">65</a></span>`
2425	`<span class="normal"><a href="#__codelineno-0-66">66</a></span>`
2426	`<span class="normal"><a href="#__codelineno-0-67">67</a></span>`
2427	`<span class="normal"><a href="#__codelineno-0-68">68</a></span>`
2428	`<span class="normal"><a href="#__codelineno-0-69">69</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-51" name="__codelineno-0-51"></a><span class="k">def</span><span class="w"> </span><span class="nf">download_all</span><span class="p">(</span>`
2429	`<a id="__codelineno-0-52" name="__codelineno-0-52"></a> <span class="bp">self</span><span class="p">,</span>`
2430	`<a id="__codelineno-0-53" name="__codelineno-0-53"></a> <span class="n">files</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="n">SourceFile</span><span class="p">],</span>`
2431	`<a id="__codelineno-0-54" name="__codelineno-0-54"></a> <span class="n">destination_dir</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span>`
2432	`<a id="__codelineno-0-55" name="__codelineno-0-55"></a><span class="p">)</span> <span class="o">-></span> <span class="n">List</span><span class="p">[</span><span class="n">Path</span><span class="p">]:</span>`
2433	`<a id="__codelineno-0-56" name="__codelineno-0-56"></a><span class="w"> </span><span class="sd">"""Download multiple files to a directory, preserving subfolder structure."""</span>`
2434	`<a id="__codelineno-0-57" name="__codelineno-0-57"></a> <span class="n">destination_dir</span><span class="o">.</span><span class="n">mkdir</span><span class="p">(</span><span class="n">parents</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">exist_ok</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>`
2435	`<a id="__codelineno-0-58" name="__codelineno-0-58"></a> <span class="n">paths</span> <span class="o">=</span> <span class="p">[]</span>`
2436	`<a id="__codelineno-0-59" name="__codelineno-0-59"></a> <span class="k">for</span> <span class="n">f</span> <span class="ow">in</span> <span class="n">files</span><span class="p">:</span>`
2437	`<a id="__codelineno-0-60" name="__codelineno-0-60"></a> <span class="c1"># Use path (with subfolder) if available, otherwise just name</span>`
2438	`<a id="__codelineno-0-61" name="__codelineno-0-61"></a> <span class="n">relative</span> <span class="o">=</span> <span class="n">f</span><span class="o">.</span><span class="n">path</span> <span class="k">if</span> <span class="n">f</span><span class="o">.</span><span class="n">path</span> <span class="k">else</span> <span class="n">f</span><span class="o">.</span><span class="n">name</span>`
2439	`<a id="__codelineno-0-62" name="__codelineno-0-62"></a> <span class="n">dest</span> <span class="o">=</span> <span class="n">destination_dir</span> <span class="o">/</span> <span class="n">relative</span>`
2440	`<a id="__codelineno-0-63" name="__codelineno-0-63"></a> <span class="k">try</span><span class="p">:</span>`
2441	`<a id="__codelineno-0-64" name="__codelineno-0-64"></a> <span class="n">local_path</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">download</span><span class="p">(</span><span class="n">f</span><span class="p">,</span> <span class="n">dest</span><span class="p">)</span>`
2442	`<a id="__codelineno-0-65" name="__codelineno-0-65"></a> <span class="n">paths</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">local_path</span><span class="p">)</span>`
2443	`<a id="__codelineno-0-66" name="__codelineno-0-66"></a> <span class="n">logger</span><span class="o">.</span><span class="n">info</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Downloaded: </span><span class="si">{</span><span class="n">relative</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span>`
2444	`<a id="__codelineno-0-67" name="__codelineno-0-67"></a> <span class="k">except</span> <span class="ne">Exception</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>`
2445	`<a id="__codelineno-0-68" name="__codelineno-0-68"></a> <span class="n">logger</span><span class="o">.</span><span class="n">error</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Failed to download </span><span class="si">{</span><span class="n">relative</span><span class="si">}</span><span class="s2">: </span><span class="si">{</span><span class="n">e</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span>`
2446	`<a id="__codelineno-0-69" name="__codelineno-0-69"></a> <span class="k">return</span> <span class="n">paths</span>`
2447	`</code></pre></div></td></tr></table></div>`
2448	`</details>`
2449	`</div>`
2450
2451	`</div>`
2452
2453	`<div class="doc doc-object doc-function">`
2454
2455
2456	`<h4 id="video_processor.sources.base.BaseSource.list_videos" class="doc doc-heading">`
2457	`<code class="highlight language-python"><span class="n">list_videos</span><span class="p">(</span><span class="n">folder_id</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">folder_path</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">patterns</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>`
2458
2459	`<span class="doc doc-labels">`
2460	`<small class="doc doc-label doc-label-abstractmethod"><code>abstractmethod</code></small>`
2461	`</span>`
2462
2463	`<a href="#video_processor.sources.base.BaseSource.list_videos" class="headerlink" title="Permanent link">¶</a></h4>`
2464
2465
2466	`<div class="doc doc-contents ">`
2467
2468	`<p>List video files in a folder.</p>`
2469
2470
2471	`<details class="mkdocstrings-source">`
2472	`<summary>Source code in <code>video_processor/sources/base.py</code></summary>`
2473	`<div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-32">32</a></span>`
2474	`<span class="normal"><a href="#__codelineno-0-33">33</a></span>`
2475	`<span class="normal"><a href="#__codelineno-0-34">34</a></span>`
2476	`<span class="normal"><a href="#__codelineno-0-35">35</a></span>`
2477	`<span class="normal"><a href="#__codelineno-0-36">36</a></span>`
2478	`<span class="normal"><a href="#__codelineno-0-37">37</a></span>`
2479	`<span class="normal"><a href="#__codelineno-0-38">38</a></span>`
2480	`<span class="normal"><a href="#__codelineno-0-39">39</a></span>`
2481	`<span class="normal"><a href="#__codelineno-0-40">40</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-32" name="__codelineno-0-32"></a><span class="nd">@abstractmethod</span>`
2482	`<a id="__codelineno-0-33" name="__codelineno-0-33"></a><span class="k">def</span><span class="w"> </span><span class="nf">list_videos</span><span class="p">(</span>`
2483	`<a id="__codelineno-0-34" name="__codelineno-0-34"></a> <span class="bp">self</span><span class="p">,</span>`
2484	`<a id="__codelineno-0-35" name="__codelineno-0-35"></a> <span class="n">folder_id</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>`
2485	`<a id="__codelineno-0-36" name="__codelineno-0-36"></a> <span class="n">folder_path</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>`
2486	`<a id="__codelineno-0-37" name="__codelineno-0-37"></a> <span class="n">patterns</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>`
2487	`<a id="__codelineno-0-38" name="__codelineno-0-38"></a><span class="p">)</span> <span class="o">-></span> <span class="n">List</span><span class="p">[</span><span class="n">SourceFile</span><span class="p">]:</span>`
2488	`<a id="__codelineno-0-39" name="__codelineno-0-39"></a><span class="w"> </span><span class="sd">"""List video files in a folder."""</span>`
2489	`<a id="__codelineno-0-40" name="__codelineno-0-40"></a> <span class="o">...</span>`
2490	`</code></pre></div></td></tr></table></div>`
2491	`</details>`
2492	`</div>`
2493
2494	`</div>`
2495
2496
2497
2498	`</div>`
2499
2500	`</div>`
2501
2502	`</div>`
2503
2504	`<div class="doc doc-object doc-class">`
2505
2506
2507
2508	`<h3 id="video_processor.sources.base.SourceFile" class="doc doc-heading">`
2509	`<code>SourceFile</code>`
2510
2511
2512	`<a href="#video_processor.sources.base.SourceFile" class="headerlink" title="Permanent link">¶</a></h3>`
2513
2514
2515	`<div class="doc doc-contents ">`
2516	`<p class="doc doc-class-bases">`
2517	`Bases: <code><span title="pydantic.BaseModel">BaseModel</span></code></p>`
2518
2519
2520
2521	`<p>A file available in a cloud source.</p>`
2522
2523
2524
2525
2526
2527
2528
2529
2530	`<details class="mkdocstrings-source">`
2531	`<summary>Source code in <code>video_processor/sources/base.py</code></summary>`
2532	`<div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-13">13</a></span>`
2533	`<span class="normal"><a href="#__codelineno-0-14">14</a></span>`
2534	`<span class="normal"><a href="#__codelineno-0-15">15</a></span>`
2535	`<span class="normal"><a href="#__codelineno-0-16">16</a></span>`
2536	`<span class="normal"><a href="#__codelineno-0-17">17</a></span>`
2537	`<span class="normal"><a href="#__codelineno-0-18">18</a></span>`
2538	`<span class="normal"><a href="#__codelineno-0-19">19</a></span>`
2539	`<span class="normal"><a href="#__codelineno-0-20">20</a></span>`
2540	`<span class="normal"><a href="#__codelineno-0-21">21</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-13" name="__codelineno-0-13"></a><span class="k">class</span><span class="w"> </span><span class="nc">SourceFile</span><span class="p">(</span><span class="n">BaseModel</span><span class="p">):</span>`
2541	`<a id="__codelineno-0-14" name="__codelineno-0-14"></a><span class="w"> </span><span class="sd">"""A file available in a cloud source."""</span>`
2542	`<a id="__codelineno-0-15" name="__codelineno-0-15"></a>`
2543	`<a id="__codelineno-0-16" name="__codelineno-0-16"></a> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="n">Field</span><span class="p">(</span><span class="n">description</span><span class="o">=</span><span class="s2">"File name"</span><span class="p">)</span>`
2544	`<a id="__codelineno-0-17" name="__codelineno-0-17"></a> <span class="nb">id</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="n">Field</span><span class="p">(</span><span class="n">description</span><span class="o">=</span><span class="s2">"Provider-specific file identifier"</span><span class="p">)</span>`
2545	<a id="__codelineno-0-18" name="__codelineno-0-18"></a> <span class="n">size_bytes</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span> <span class="o">=</span> <span class="n">Field</span><span class="p">(</span><span class="n">default</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">description</span><span class="o">=</span><span class="s2">"File size in bytes"</span><span class="p">)</span>
2546	<a id="__codelineno-0-19" name="__codelineno-0-19"></a> <span class="n">mime_type</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="n">Field</span><span class="p">(</span><span class="n">default</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">description</span><span class="o">=</span><span class="s2">"MIME type"</span><span class="p">)</span>
2547	<a id="__codelineno-0-20" name="__codelineno-0-20"></a> <span class="n">modified_at</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="n">Field</span><span class="p">(</span><span class="n">default</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">description</span><span class="o">=</span><span class="s2">"Last modified timestamp"</span><span class="p">)</span>
2548	<a id="__codelineno-0-21" name="__codelineno-0-21"></a> <span class="n">path</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="n">Field</span><span class="p">(</span><span class="n">default</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">description</span><span class="o">=</span><span class="s2">"Path within the source folder"</span><span class="p">)</span>
2549	`</code></pre></div></td></tr></table></div>`
2550	`</details>`
2551
2552
2553
2554	`<div class="doc doc-children">`
2555
2556
2557
2558
2559
2560
2561
2562
2563
2564
2565
2566
2567	`</div>`
2568
2569	`</div>`
2570
2571	`</div>`
2572
2573
2574
2575
2576	`</div>`
2577
2578	`</div>`
2579
2580	`</div><hr />`
2581	`<h2 id="overview">Overview<a class="headerlink" href="#overview" title="Permanent link">¶</a></h2>`
2582	`<p>The sources module provides a unified interface for fetching content from cloud services, local applications, and the web. All sources implement the <code>BaseSource</code> abstract class, providing consistent <code>authenticate()</code>, <code>list_videos()</code>, and <code>download()</code> methods.</p>`
2583	`<p>Sources are lazy-loaded to avoid pulling in optional dependencies at import time. You can import any source directly from <code>video_processor.sources</code> and the correct module will be loaded on demand.</p>`
2584	`<hr />`
2585	`<h2 id="basesource-abc">BaseSource (ABC)<a class="headerlink" href="#basesource-abc" title="Permanent link">¶</a></h2>`
2586	`<div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="kn">from</span><span class="w"> </span><span class="nn">video_processor.sources</span><span class="w"> </span><span class="kn">import</span> <span class="n">BaseSource</span>`
2587	`</code></pre></div>`
2588	`<p>Abstract base class that all source integrations implement. Defines the standard three-step workflow: authenticate, list, download.</p>`
2589	`<h3 id="authenticate">authenticate()<a class="headerlink" href="#authenticate" title="Permanent link">¶</a></h3>`
2590	`<div class="highlight"><pre><span></span><code><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="nd">@abstractmethod</span>`
2591	`<a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="k">def</span><span class="w"> </span><span class="nf">authenticate</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="nb">bool</span>`
2592	`</code></pre></div>`
2593	`<p>Authenticate with the cloud provider or service. Uses the auth strategy defined for the source (OAuth, API key, local access, etc.).</p>`
2594	`<p><strong>Returns:</strong> <code>bool</code> -- <code>True</code> on successful authentication, <code>False</code> on failure.</p>`
2595	`<h3 id="list_videos">list_videos()<a class="headerlink" href="#list_videos" title="Permanent link">¶</a></h3>`
2596	`<div class="highlight"><pre><span></span><code><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="nd">@abstractmethod</span>`
2597	`<a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="k">def</span><span class="w"> </span><span class="nf">list_videos</span><span class="p">(</span>`
2598	`<a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a> <span class="bp">self</span><span class="p">,</span>`
2599	`<a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a> <span class="n">folder_id</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>`
2600	`<a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a> <span class="n">folder_path</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>`
2601	`<a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a> <span class="n">patterns</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>`
2602	`<a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="p">)</span> <span class="o">-></span> <span class="n">List</span><span class="p">[</span><span class="n">SourceFile</span><span class="p">]</span>`
2603	`</code></pre></div>`
2604	`<p>List available video files (or other content, depending on the source).</p>`
2605	`<p><strong>Parameters:</strong></p>`
2606	`<table>`
2607	`<thead>`
2608	`<tr>`
2609	`<th>Parameter</th>`
2610	`<th>Type</th>`
2611	`<th>Default</th>`
2612	`<th>Description</th>`
2613	`</tr>`
2614	`</thead>`
2615	`<tbody>`
2616	`<tr>`
2617	`<td><code>folder_id</code></td>`
2618	`<td><code>Optional[str]</code></td>`
2619	`<td><code>None</code></td>`
2620	`<td>Provider-specific folder/container identifier</td>`
2621	`</tr>`
2622	`<tr>`
2623	`<td><code>folder_path</code></td>`
2624	`<td><code>Optional[str]</code></td>`
2625	`<td><code>None</code></td>`
2626	`<td>Path within the source (e.g., folder name)</td>`
2627	`</tr>`
2628	`<tr>`
2629	`<td><code>patterns</code></td>`
2630	`<td><code>Optional[List[str]]</code></td>`
2631	`<td><code>None</code></td>`
2632	`<td>File name glob patterns to filter results</td>`
2633	`</tr>`
2634	`</tbody>`
2635	`</table>`
2636	`<p><strong>Returns:</strong> <code>List[SourceFile]</code> -- available files matching the criteria.</p>`
2637	`<h3 id="download">download()<a class="headerlink" href="#download" title="Permanent link">¶</a></h3>`
2638	`<div class="highlight"><pre><span></span><code><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a><span class="nd">@abstractmethod</span>`
2639	`<a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="k">def</span><span class="w"> </span><span class="nf">download</span><span class="p">(</span>`
2640	`<a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a> <span class="bp">self</span><span class="p">,</span>`
2641	`<a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a> <span class="n">file</span><span class="p">:</span> <span class="n">SourceFile</span><span class="p">,</span>`
2642	`<a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a> <span class="n">destination</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span>`
2643	`<a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a><span class="p">)</span> <span class="o">-></span> <span class="n">Path</span>`
2644	`</code></pre></div>`
2645	`<p>Download a single file to a local path.</p>`
2646	`<p><strong>Parameters:</strong></p>`
2647	`<table>`
2648	`<thead>`
2649	`<tr>`
2650	`<th>Parameter</th>`
2651	`<th>Type</th>`
2652	`<th>Description</th>`
2653	`</tr>`
2654	`</thead>`
2655	`<tbody>`
2656	`<tr>`
2657	`<td><code>file</code></td>`
2658	`<td><code>SourceFile</code></td>`
2659	`<td>File descriptor from <code>list_videos()</code></td>`
2660	`</tr>`
2661	`<tr>`
2662	`<td><code>destination</code></td>`
2663	`<td><code>Path</code></td>`
2664	`<td>Local destination path</td>`
2665	`</tr>`
2666	`</tbody>`
2667	`</table>`
2668	`<p><strong>Returns:</strong> <code>Path</code> -- the local path where the file was saved.</p>`
2669	`<h3 id="download_all">download_all()<a class="headerlink" href="#download_all" title="Permanent link">¶</a></h3>`
2670	`<div class="highlight"><pre><span></span><code><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a><span class="k">def</span><span class="w"> </span><span class="nf">download_all</span><span class="p">(</span>`
2671	`<a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a> <span class="bp">self</span><span class="p">,</span>`
2672	`<a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a> <span class="n">files</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="n">SourceFile</span><span class="p">],</span>`
2673	`<a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a> <span class="n">destination_dir</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span>`
2674	`<a id="__codelineno-4-5" name="__codelineno-4-5" href="#__codelineno-4-5"></a><span class="p">)</span> <span class="o">-></span> <span class="n">List</span><span class="p">[</span><span class="n">Path</span><span class="p">]</span>`
2675	`</code></pre></div>`
2676	`<p>Download multiple files to a directory, preserving subfolder structure from <code>SourceFile.path</code>. This is a concrete method provided by the base class.</p>`
2677	`<p><strong>Parameters:</strong></p>`
2678	`<table>`
2679	`<thead>`
2680	`<tr>`
2681	`<th>Parameter</th>`
2682	`<th>Type</th>`
2683	`<th>Description</th>`
2684	`</tr>`
2685	`</thead>`
2686	`<tbody>`
2687	`<tr>`
2688	`<td><code>files</code></td>`
2689	`<td><code>List[SourceFile]</code></td>`
2690	`<td>Files to download</td>`
2691	`</tr>`
2692	`<tr>`
2693	`<td><code>destination_dir</code></td>`
2694	`<td><code>Path</code></td>`
2695	`<td>Base directory for downloads (created if needed)</td>`
2696	`</tr>`
2697	`</tbody>`
2698	`</table>`
2699	`<p><strong>Returns:</strong> <code>List[Path]</code> -- local paths of successfully downloaded files. Failed downloads are logged and skipped.</p>`
2700	`<hr />`
2701	`<h2 id="sourcefile">SourceFile<a class="headerlink" href="#sourcefile" title="Permanent link">¶</a></h2>`
2702	`<div class="highlight"><pre><span></span><code><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a><span class="kn">from</span><span class="w"> </span><span class="nn">video_processor.sources</span><span class="w"> </span><span class="kn">import</span> <span class="n">SourceFile</span>`
2703	`</code></pre></div>`
2704	`<p>Pydantic model describing a file available in a cloud source.</p>`
2705	`<table>`
2706	`<thead>`
2707	`<tr>`
2708	`<th>Field</th>`
2709	`<th>Type</th>`
2710	`<th>Default</th>`
2711	`<th>Description</th>`
2712	`</tr>`
2713	`</thead>`
2714	`<tbody>`
2715	`<tr>`
2716	`<td><code>name</code></td>`
2717	`<td><code>str</code></td>`
2718	`<td><em>required</em></td>`
2719	`<td>File name</td>`
2720	`</tr>`
2721	`<tr>`
2722	`<td><code>id</code></td>`
2723	`<td><code>str</code></td>`
2724	`<td><em>required</em></td>`
2725	`<td>Provider-specific file identifier</td>`
2726	`</tr>`
2727	`<tr>`
2728	`<td><code>size_bytes</code></td>`
2729	`<td><code>Optional[int]</code></td>`
2730	`<td><code>None</code></td>`
2731	`<td>File size in bytes</td>`
2732	`</tr>`
2733	`<tr>`
2734	`<td><code>mime_type</code></td>`
2735	`<td><code>Optional[str]</code></td>`
2736	`<td><code>None</code></td>`
2737	`<td>MIME type (e.g., <code>"video/mp4"</code>)</td>`
2738	`</tr>`
2739	`<tr>`
2740	`<td><code>modified_at</code></td>`
2741	`<td><code>Optional[str]</code></td>`
2742	`<td><code>None</code></td>`
2743	`<td>Last modified timestamp</td>`
2744	`</tr>`
2745	`<tr>`
2746	`<td><code>path</code></td>`
2747	`<td><code>Optional[str]</code></td>`
2748	`<td><code>None</code></td>`
2749	`<td>Path within the source folder (used for subfolder structure in <code>download_all</code>)</td>`
2750	`</tr>`
2751	`</tbody>`
2752	`</table>`
2753	`<div class="highlight"><pre><span></span><code><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a><span class="p">{</span>`
2754	`<a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a><span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"sprint-review-2026-03-01.mp4"</span><span class="p">,</span>`
2755	`<a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"abc123def456"</span><span class="p">,</span>`
2756	`<a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a><span class="w"> </span><span class="nt">"size_bytes"</span><span class="p">:</span><span class="w"> </span><span class="mi">524288000</span><span class="p">,</span>`
2757	`<a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a><span class="w"> </span><span class="nt">"mime_type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"video/mp4"</span><span class="p">,</span>`
2758	`<a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a><span class="w"> </span><span class="nt">"modified_at"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2026-03-01T14:30:00Z"</span><span class="p">,</span>`
2759	`<a id="__codelineno-6-7" name="__codelineno-6-7" href="#__codelineno-6-7"></a><span class="w"> </span><span class="nt">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"recordings/march/sprint-review-2026-03-01.mp4"</span>`
2760	`<a id="__codelineno-6-8" name="__codelineno-6-8" href="#__codelineno-6-8"></a><span class="p">}</span>`
2761	`</code></pre></div>`
2762	`<hr />`
2763	`<h2 id="lazy-loading-pattern">Lazy Loading Pattern<a class="headerlink" href="#lazy-loading-pattern" title="Permanent link">¶</a></h2>`
2764	`<p>All sources are lazy-loaded via <code>__getattr__</code> in the package <code>__init__.py</code>. This means importing <code>video_processor.sources</code> does not pull in any external dependencies (e.g., <code>google-auth</code>, <code>msal</code>, <code>notion-client</code>). The actual module is loaded only when you access the class.</p>`
2765	`<div class="highlight"><pre><span></span><code><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a><span class="c1"># This import is instant -- no dependencies loaded</span>`
2766	`<a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="kn">from</span><span class="w"> </span><span class="nn">video_processor.sources</span><span class="w"> </span><span class="kn">import</span> <span class="n">ZoomSource</span>`
2767	`<a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a>`
2768	`<a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a><span class="c1"># The zoom_source module (and its dependencies) are loaded here</span>`
2769	`<a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a><span class="n">source</span> <span class="o">=</span> <span class="n">ZoomSource</span><span class="p">()</span>`
2770	`</code></pre></div>`
2771	`<hr />`
2772	`<h2 id="available-sources">Available Sources<a class="headerlink" href="#available-sources" title="Permanent link">¶</a></h2>`
2773	`<h3 id="cloud-recordings">Cloud Recordings<a class="headerlink" href="#cloud-recordings" title="Permanent link">¶</a></h3>`
2774	`<p>Sources for fetching recorded meetings from video conferencing platforms.</p>`
2775	`<table>`
2776	`<thead>`
2777	`<tr>`
2778	`<th>Source</th>`
2779	`<th>Class</th>`
2780	`<th>Auth Method</th>`
2781	`<th>Description</th>`
2782	`</tr>`
2783	`</thead>`
2784	`<tbody>`
2785	`<tr>`
2786	`<td>Zoom</td>`
2787	`<td><code>ZoomSource</code></td>`
2788	`<td>OAuth / Server-to-Server</td>`
2789	`<td>List and download Zoom cloud recordings</td>`
2790	`</tr>`
2791	`<tr>`
2792	`<td>Google Meet</td>`
2793	`<td><code>MeetRecordingSource</code></td>`
2794	`<td>OAuth (Google)</td>`
2795	`<td>List and download Google Meet recordings from Drive</td>`
2796	`</tr>`
2797	`<tr>`
2798	`<td>Microsoft Teams</td>`
2799	`<td><code>TeamsRecordingSource</code></td>`
2800	`<td>OAuth (Microsoft)</td>`
2801	`<td>List and download Teams meeting recordings</td>`
2802	`</tr>`
2803	`</tbody>`
2804	`</table>`
2805	`<h3 id="cloud-storage-and-workspace">Cloud Storage and Workspace<a class="headerlink" href="#cloud-storage-and-workspace" title="Permanent link">¶</a></h3>`
2806	`<p>Sources for accessing files stored in cloud platforms.</p>`
2807	`<table>`
2808	`<thead>`
2809	`<tr>`
2810	`<th>Source</th>`
2811	`<th>Class</th>`
2812	`<th>Auth Method</th>`
2813	`<th>Description</th>`
2814	`</tr>`
2815	`</thead>`
2816	`<tbody>`
2817	`<tr>`
2818	`<td>Google Drive</td>`
2819	`<td><code>GoogleDriveSource</code></td>`
2820	`<td>OAuth (Google)</td>`
2821	`<td>Files from Google Drive</td>`
2822	`</tr>`
2823	`<tr>`
2824	`<td>Google Workspace</td>`
2825	`<td><code>GWSSource</code></td>`
2826	`<td>OAuth (Google)</td>`
2827	`<td>Google Docs, Sheets, Slides</td>`
2828	`</tr>`
2829	`<tr>`
2830	`<td>Microsoft 365</td>`
2831	`<td><code>M365Source</code></td>`
2832	`<td>OAuth (Microsoft)</td>`
2833	`<td>OneDrive, SharePoint files</td>`
2834	`</tr>`
2835	`<tr>`
2836	`<td>Notion</td>`
2837	`<td><code>NotionSource</code></td>`
2838	`<td>OAuth / API key</td>`
2839	`<td>Notion pages and databases</td>`
2840	`</tr>`
2841	`<tr>`
2842	`<td>GitHub</td>`
2843	`<td><code>GitHubSource</code></td>`
2844	`<td>OAuth / API token</td>`
2845	`<td>Repository files, issues, discussions</td>`
2846	`</tr>`
2847	`<tr>`
2848	`<td>Dropbox</td>`
2849	`<td><code>DropboxSource</code></td>`
2850	`<td>OAuth / access token</td>`
2851	`<td><em>(via auth config)</em></td>`
2852	`</tr>`
2853	`</tbody>`
2854	`</table>`
2855	`<h3 id="notes-applications">Notes Applications<a class="headerlink" href="#notes-applications" title="Permanent link">¶</a></h3>`
2856	`<p>Sources for local and cloud-based note-taking apps.</p>`
2857	`<table>`
2858	`<thead>`
2859	`<tr>`
2860	`<th>Source</th>`
2861	`<th>Class</th>`
2862	`<th>Auth Method</th>`
2863	`<th>Description</th>`
2864	`</tr>`
2865	`</thead>`
2866	`<tbody>`
2867	`<tr>`
2868	`<td>Apple Notes</td>`
2869	`<td><code>AppleNotesSource</code></td>`
2870	`<td>Local (macOS)</td>`
2871	`<td>Notes from Apple Notes.app</td>`
2872	`</tr>`
2873	`<tr>`
2874	`<td>Obsidian</td>`
2875	`<td><code>ObsidianSource</code></td>`
2876	`<td>Local filesystem</td>`
2877	`<td>Markdown files from Obsidian vaults</td>`
2878	`</tr>`
2879	`<tr>`
2880	`<td>Logseq</td>`
2881	`<td><code>LogseqSource</code></td>`
2882	`<td>Local filesystem</td>`
2883	`<td>Pages from Logseq graphs</td>`
2884	`</tr>`
2885	`<tr>`
2886	`<td>OneNote</td>`
2887	`<td><code>OneNoteSource</code></td>`
2888	`<td>OAuth (Microsoft)</td>`
2889	`<td>Microsoft OneNote notebooks</td>`
2890	`</tr>`
2891	`<tr>`
2892	`<td>Google Keep</td>`
2893	`<td><code>GoogleKeepSource</code></td>`
2894	`<td>OAuth (Google)</td>`
2895	`<td>Google Keep notes</td>`
2896	`</tr>`
2897	`</tbody>`
2898	`</table>`
2899	`<h3 id="web-and-content">Web and Content<a class="headerlink" href="#web-and-content" title="Permanent link">¶</a></h3>`
2900	`<p>Sources for fetching content from the web.</p>`
2901	`<table>`
2902	`<thead>`
2903	`<tr>`
2904	`<th>Source</th>`
2905	`<th>Class</th>`
2906	`<th>Auth Method</th>`
2907	`<th>Description</th>`
2908	`</tr>`
2909	`</thead>`
2910	`<tbody>`
2911	`<tr>`
2912	`<td>YouTube</td>`
2913	`<td><code>YouTubeSource</code></td>`
2914	`<td>API key / OAuth</td>`
2915	`<td>YouTube video metadata and transcripts</td>`
2916	`</tr>`
2917	`<tr>`
2918	`<td>Web</td>`
2919	`<td><code>WebSource</code></td>`
2920	`<td>None</td>`
2921	`<td>General web page content extraction</td>`
2922	`</tr>`
2923	`<tr>`
2924	`<td>RSS</td>`
2925	`<td><code>RSSSource</code></td>`
2926	`<td>None</td>`
2927	`<td>RSS/Atom feed entries</td>`
2928	`</tr>`
2929	`<tr>`
2930	`<td>Podcast</td>`
2931	`<td><code>PodcastSource</code></td>`
2932	`<td>None</td>`
2933	`<td>Podcast episodes from RSS feeds</td>`
2934	`</tr>`
2935	`<tr>`
2936	`<td>arXiv</td>`
2937	`<td><code>ArxivSource</code></td>`
2938	`<td>None</td>`
2939	`<td>Academic papers from arXiv</td>`
2940	`</tr>`
2941	`<tr>`
2942	`<td>Hacker News</td>`
2943	`<td><code>HackerNewsSource</code></td>`
2944	`<td>None</td>`
2945	`<td>Hacker News posts and comments</td>`
2946	`</tr>`
2947	`<tr>`
2948	`<td>Reddit</td>`
2949	`<td><code>RedditSource</code></td>`
2950	`<td>API credentials</td>`
2951	`<td>Reddit posts and comments</td>`
2952	`</tr>`
2953	`<tr>`
2954	`<td>Twitter/X</td>`
2955	`<td><code>TwitterSource</code></td>`
2956	`<td>API credentials</td>`
2957	`<td>Tweets and threads</td>`
2958	`</tr>`
2959	`</tbody>`
2960	`</table>`
2961	`<hr />`
2962	`<h2 id="auth-integration">Auth Integration<a class="headerlink" href="#auth-integration" title="Permanent link">¶</a></h2>`
2963	`<p>Most sources use PlanOpticon's unified auth system (see <a href="../auth/">Auth API</a>). The typical pattern within a source implementation:</p>`
2964	`<div class="highlight"><pre><span></span><code><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a><span class="kn">from</span><span class="w"> </span><span class="nn">video_processor.auth</span><span class="w"> </span><span class="kn">import</span> <span class="n">get_auth_manager</span>`
2965	`<a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a>`
2966	`<a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a><span class="k">class</span><span class="w"> </span><span class="nc">MySource</span><span class="p">(</span><span class="n">BaseSource</span><span class="p">):</span>`
2967	`<a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a> <span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>`
2968	`<a id="__codelineno-8-5" name="__codelineno-8-5" href="#__codelineno-8-5"></a> <span class="bp">self</span><span class="o">.</span><span class="n">_token</span> <span class="o">=</span> <span class="kc">None</span>`
2969	`<a id="__codelineno-8-6" name="__codelineno-8-6" href="#__codelineno-8-6"></a>`
2970	`<a id="__codelineno-8-7" name="__codelineno-8-7" href="#__codelineno-8-7"></a> <span class="k">def</span><span class="w"> </span><span class="nf">authenticate</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="nb">bool</span><span class="p">:</span>`
2971	`<a id="__codelineno-8-8" name="__codelineno-8-8" href="#__codelineno-8-8"></a> <span class="n">manager</span> <span class="o">=</span> <span class="n">get_auth_manager</span><span class="p">(</span><span class="s2">"my_service"</span><span class="p">)</span>`
2972	`<a id="__codelineno-8-9" name="__codelineno-8-9" href="#__codelineno-8-9"></a> <span class="k">if</span> <span class="n">manager</span><span class="p">:</span>`
2973	`<a id="__codelineno-8-10" name="__codelineno-8-10" href="#__codelineno-8-10"></a> <span class="n">token</span> <span class="o">=</span> <span class="n">manager</span><span class="o">.</span><span class="n">get_token</span><span class="p">()</span>`
2974	`<a id="__codelineno-8-11" name="__codelineno-8-11" href="#__codelineno-8-11"></a> <span class="k">if</span> <span class="n">token</span><span class="p">:</span>`
2975	`<a id="__codelineno-8-12" name="__codelineno-8-12" href="#__codelineno-8-12"></a> <span class="bp">self</span><span class="o">.</span><span class="n">_token</span> <span class="o">=</span> <span class="n">token</span>`
2976	`<a id="__codelineno-8-13" name="__codelineno-8-13" href="#__codelineno-8-13"></a> <span class="k">return</span> <span class="kc">True</span>`
2977	`<a id="__codelineno-8-14" name="__codelineno-8-14" href="#__codelineno-8-14"></a> <span class="k">return</span> <span class="kc">False</span>`
2978	`<a id="__codelineno-8-15" name="__codelineno-8-15" href="#__codelineno-8-15"></a>`
2979	`<a id="__codelineno-8-16" name="__codelineno-8-16" href="#__codelineno-8-16"></a> <span class="k">def</span><span class="w"> </span><span class="nf">list_videos</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-></span> <span class="nb">list</span><span class="p">[</span><span class="n">SourceFile</span><span class="p">]:</span>`
2980	`<a id="__codelineno-8-17" name="__codelineno-8-17" href="#__codelineno-8-17"></a> <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_token</span><span class="p">:</span>`
2981	`<a id="__codelineno-8-18" name="__codelineno-8-18" href="#__codelineno-8-18"></a> <span class="k">raise</span> <span class="ne">RuntimeError</span><span class="p">(</span><span class="s2">"Not authenticated. Call authenticate() first."</span><span class="p">)</span>`
2982	`<a id="__codelineno-8-19" name="__codelineno-8-19" href="#__codelineno-8-19"></a> <span class="c1"># Use self._token to call the API</span>`
2983	`<a id="__codelineno-8-20" name="__codelineno-8-20" href="#__codelineno-8-20"></a> <span class="o">...</span>`
2984	`</code></pre></div>`
2985	`<hr />`
2986	`<h2 id="usage-examples">Usage Examples<a class="headerlink" href="#usage-examples" title="Permanent link">¶</a></h2>`
2987	`<h3 id="listing-and-downloading-zoom-recordings">Listing and downloading Zoom recordings<a class="headerlink" href="#listing-and-downloading-zoom-recordings" title="Permanent link">¶</a></h3>`
2988	`<div class="highlight"><pre><span></span><code><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a><span class="kn">from</span><span class="w"> </span><span class="nn">pathlib</span><span class="w"> </span><span class="kn">import</span> <span class="n">Path</span>`
2989	`<a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a><span class="kn">from</span><span class="w"> </span><span class="nn">video_processor.sources</span><span class="w"> </span><span class="kn">import</span> <span class="n">ZoomSource</span>`
2990	`<a id="__codelineno-9-3" name="__codelineno-9-3" href="#__codelineno-9-3"></a>`
2991	`<a id="__codelineno-9-4" name="__codelineno-9-4" href="#__codelineno-9-4"></a><span class="n">source</span> <span class="o">=</span> <span class="n">ZoomSource</span><span class="p">()</span>`
2992	`<a id="__codelineno-9-5" name="__codelineno-9-5" href="#__codelineno-9-5"></a><span class="k">if</span> <span class="n">source</span><span class="o">.</span><span class="n">authenticate</span><span class="p">():</span>`
2993	`<a id="__codelineno-9-6" name="__codelineno-9-6" href="#__codelineno-9-6"></a> <span class="n">recordings</span> <span class="o">=</span> <span class="n">source</span><span class="o">.</span><span class="n">list_videos</span><span class="p">()</span>`
2994	`<a id="__codelineno-9-7" name="__codelineno-9-7" href="#__codelineno-9-7"></a> <span class="k">for</span> <span class="n">rec</span> <span class="ow">in</span> <span class="n">recordings</span><span class="p">:</span>`
2995	<a id="__codelineno-9-8" name="__codelineno-9-8" href="#__codelineno-9-8"></a> <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">"</span><span class="si">{</span><span class="n">rec</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s2"> (</span><span class="si">{</span><span class="n">rec</span><span class="o">.</span><span class="n">size_bytes</span><span class="si">}</span><span class="s2"> bytes)"</span><span class="p">)</span>
2996	`<a id="__codelineno-9-9" name="__codelineno-9-9" href="#__codelineno-9-9"></a>`
2997	`<a id="__codelineno-9-10" name="__codelineno-9-10" href="#__codelineno-9-10"></a> <span class="c1"># Download all to a local directory</span>`
2998	`<a id="__codelineno-9-11" name="__codelineno-9-11" href="#__codelineno-9-11"></a> <span class="n">paths</span> <span class="o">=</span> <span class="n">source</span><span class="o">.</span><span class="n">download_all</span><span class="p">(</span><span class="n">recordings</span><span class="p">,</span> <span class="n">Path</span><span class="p">(</span><span class="s2">"./downloads"</span><span class="p">))</span>`
2999	`</code></pre></div>`
3000	`<h3 id="fetching-from-multiple-sources">Fetching from multiple sources<a class="headerlink" href="#fetching-from-multiple-sources" title="Permanent link">¶</a></h3>`
3001	`<div class="highlight"><pre><span></span><code><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a><span class="kn">from</span><span class="w"> </span><span class="nn">pathlib</span><span class="w"> </span><span class="kn">import</span> <span class="n">Path</span>`
3002	`<a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a><span class="kn">from</span><span class="w"> </span><span class="nn">video_processor.sources</span><span class="w"> </span><span class="kn">import</span> <span class="n">GoogleDriveSource</span><span class="p">,</span> <span class="n">NotionSource</span>`
3003	`<a id="__codelineno-10-3" name="__codelineno-10-3" href="#__codelineno-10-3"></a>`
3004	`<a id="__codelineno-10-4" name="__codelineno-10-4" href="#__codelineno-10-4"></a><span class="c1"># Google Drive</span>`
3005	`<a id="__codelineno-10-5" name="__codelineno-10-5" href="#__codelineno-10-5"></a><span class="n">gdrive</span> <span class="o">=</span> <span class="n">GoogleDriveSource</span><span class="p">()</span>`
3006	`<a id="__codelineno-10-6" name="__codelineno-10-6" href="#__codelineno-10-6"></a><span class="k">if</span> <span class="n">gdrive</span><span class="o">.</span><span class="n">authenticate</span><span class="p">():</span>`
3007	`<a id="__codelineno-10-7" name="__codelineno-10-7" href="#__codelineno-10-7"></a> <span class="n">files</span> <span class="o">=</span> <span class="n">gdrive</span><span class="o">.</span><span class="n">list_videos</span><span class="p">(</span>`
3008	`<a id="__codelineno-10-8" name="__codelineno-10-8" href="#__codelineno-10-8"></a> <span class="n">folder_path</span><span class="o">=</span><span class="s2">"Meeting Recordings"</span><span class="p">,</span>`
3009	`<a id="__codelineno-10-9" name="__codelineno-10-9" href="#__codelineno-10-9"></a> <span class="n">patterns</span><span class="o">=</span><span class="p">[</span><span class="s2">".mp4"</span><span class="p">,</span> <span class="s2">".webm"</span><span class="p">],</span>`
3010	`<a id="__codelineno-10-10" name="__codelineno-10-10" href="#__codelineno-10-10"></a> <span class="p">)</span>`
3011	`<a id="__codelineno-10-11" name="__codelineno-10-11" href="#__codelineno-10-11"></a> <span class="n">gdrive</span><span class="o">.</span><span class="n">download_all</span><span class="p">(</span><span class="n">files</span><span class="p">,</span> <span class="n">Path</span><span class="p">(</span><span class="s2">"./drive-downloads"</span><span class="p">))</span>`
3012	`<a id="__codelineno-10-12" name="__codelineno-10-12" href="#__codelineno-10-12"></a>`
3013	`<a id="__codelineno-10-13" name="__codelineno-10-13" href="#__codelineno-10-13"></a><span class="c1"># Notion</span>`
3014	`<a id="__codelineno-10-14" name="__codelineno-10-14" href="#__codelineno-10-14"></a><span class="n">notion</span> <span class="o">=</span> <span class="n">NotionSource</span><span class="p">()</span>`
3015	`<a id="__codelineno-10-15" name="__codelineno-10-15" href="#__codelineno-10-15"></a><span class="k">if</span> <span class="n">notion</span><span class="o">.</span><span class="n">authenticate</span><span class="p">():</span>`
3016	`<a id="__codelineno-10-16" name="__codelineno-10-16" href="#__codelineno-10-16"></a> <span class="n">pages</span> <span class="o">=</span> <span class="n">notion</span><span class="o">.</span><span class="n">list_videos</span><span class="p">()</span> <span class="c1"># Lists Notion pages</span>`
3017	`<a id="__codelineno-10-17" name="__codelineno-10-17" href="#__codelineno-10-17"></a> <span class="k">for</span> <span class="n">page</span> <span class="ow">in</span> <span class="n">pages</span><span class="p">:</span>`
3018	`<a id="__codelineno-10-18" name="__codelineno-10-18" href="#__codelineno-10-18"></a> <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Page: </span><span class="si">{</span><span class="n">page</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span>`
3019	`</code></pre></div>`
3020	`<h3 id="youtube-content">YouTube content<a class="headerlink" href="#youtube-content" title="Permanent link">¶</a></h3>`
3021	`<div class="highlight"><pre><span></span><code><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a><span class="kn">from</span><span class="w"> </span><span class="nn">video_processor.sources</span><span class="w"> </span><span class="kn">import</span> <span class="n">YouTubeSource</span>`
3022	`<a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a>`
3023	`<a id="__codelineno-11-3" name="__codelineno-11-3" href="#__codelineno-11-3"></a><span class="n">yt</span> <span class="o">=</span> <span class="n">YouTubeSource</span><span class="p">()</span>`
3024	`<a id="__codelineno-11-4" name="__codelineno-11-4" href="#__codelineno-11-4"></a><span class="k">if</span> <span class="n">yt</span><span class="o">.</span><span class="n">authenticate</span><span class="p">():</span>`
3025	`<a id="__codelineno-11-5" name="__codelineno-11-5" href="#__codelineno-11-5"></a> <span class="n">videos</span> <span class="o">=</span> <span class="n">yt</span><span class="o">.</span><span class="n">list_videos</span><span class="p">(</span><span class="n">folder_path</span><span class="o">=</span><span class="s2">"https://youtube.com/playlist?list=..."</span><span class="p">)</span>`
3026	`<a id="__codelineno-11-6" name="__codelineno-11-6" href="#__codelineno-11-6"></a> <span class="k">for</span> <span class="n">v</span> <span class="ow">in</span> <span class="n">videos</span><span class="p">:</span>`
3027	<a id="__codelineno-11-7" name="__codelineno-11-7" href="#__codelineno-11-7"></a> <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">"</span><span class="si">{</span><span class="n">v</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s2"> - </span><span class="si">{</span><span class="n">v</span><span class="o">.</span><span class="n">id</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span>
3028	`</code></pre></div>`
3029
3030
3031
3032
3033
3034
3035
3036
3037
3038
3039
3040
3041
3042	`</article>`
3043	`</div>`
3044
3045
3046	`<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>`
3047
3048	`<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>`
3049	`</div>`
3050
3051	`<button type="button" class="md-top md-icon" data-md-component="top" hidden>`
3052
3053	`<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>`
3054	`Back to top`
3055	`</button>`
3056
3057	`</main>`
3058
3059	`<footer class="md-footer">`
3060
3061	`<div class="md-footer-meta md-typeset">`
3062	`<div class="md-footer-meta__inner md-grid">`
3063	`<div class="md-copyright">`
3064
3065	`<div class="md-copyright__highlight">`
3066	`Copyright © 2026 CONFLICT LLC`
3067	`</div>`
3068
3069
3070	`Made with`
3071	`<a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">`
3072	`Material for MkDocs`
3073	`</a>`
3074
3075	`</div>`
3076
3077
3078	`<div class="md-social">`
3079
3080
3081
3082
3083
3084
3085
3086
3087	`<a href="https://github.com/ConflictHQ/PlanOpticon" target="_blank" rel="noopener" title="github.com" class="md-social__link">`
3088	<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>
3089	`</a>`
3090
3091	`</div>`
3092
3093	`</div>`
3094	`</div>`
3095	`</footer>`
3096
3097	`</div>`
3098	`<div class="md-dialog" data-md-component="dialog">`
3099	`<div class="md-dialog__inner md-typeset"></div>`
3100	`</div>`
3101
3102
3103
3104
3105
3106	<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>
3107
3108
3109	`<script src="../../assets/javascripts/bundle.79ae519e.min.js"></script>`
3110
3111
3112	`</body>`
3113	`</html>`

PlanOpticon

Keyboard Shortcuts