Audio / MIDI
Výpis AV QT
0.3.0
Qt verze pro výpis audio/video metadat.
Co projekt řeší
Qt verze pro výpis audio/video metadat.
Jak aplikace funguje a k čemu slouží
Co aplikace řeší
vypis_AV_QT je praktický nástroj pro správu přehledu multimediálních souborů nad velkými adresářovými stromy. Kombinuje batch scan, průběžné počítání kategorií, zobrazení per-adresář statistik a export do čitelných výstupů pro archivaci i sdílení.
Primární cíle
- Rychlý přehled: okamžitě spočítat audio/video/image/ostatní soubory.
- Nezamrzající UI: sken probíhá na pozadí přes worker thread.
- Auditovatelné výstupy: TXT výpis a HTML galerie s vyhledáváním.
- Provozní komfort: perzistence konfigurace, seznamů a výstupních cest.
Skenovací workflow (detail)
6.1 Start
Při startu se inicializuje worker, naváže se na samostatné vlákno a UI přechází do běžícího režimu.
6.2 Běh
Worker rekurzivně prochází adresáře, třídí podle přípon a periodicky posílá průběžné shrnutí, aktuální status i per-adresář statistiky.
6.3 Pauza / pokračování / stop
Stav lze kdykoli pozastavit tlačítkem Pauza, obnovit a bezpečně ukončit přes Stop.
6.4 Dokončení
Po dokončení se výsledek propíše do interního seznamu a uloží do konfigurace jako poslední známý file list.
Statistiky a reporting
- Globální souhrn: počty audio/video/obrázky/ostatní.
- Per-adresář tabulka: detailní rozpad podle složek včetně celkového počtu.
- Status lišta: průběžný textový stav (scanning, stop, hotovo, error).
- Progress komponenty: procenta, počitadlo a aktuální právě zpracovávaný soubor.
Export TXT
TXT export vytváří lineární seznam cest k souborům pro rychlé další zpracování (audit, grep, další nástroje).
- Preferuje explicitní cestu z UI pole .
- Pokud cíl existuje, používá bezpečný unikátní suffix s timestampem.
- Uložená cesta se persistuje do configu pro další spuštění.
Export HTML galerie
HTML export generuje samostatnou stránku s interním JavaScriptem pro filtraci kategorií a fulltext vyhledávání.
Obsah výsledné galerie
- Souhrnné odkazy: Vše / Audio / Video / Obrázky + počet viditelných řádků.
- Search box pro okamžité filtrování tabulky.
- Klikatelné názvy souborů (URI) a plné cesty.
- Volitelná sekce náhledů (obrázky, videa).
Podporované formáty
Audio
Video
Obrázky
Troubleshooting
| Symptom | Příčina / Řešení |
|---|---|
| Aplikace nenachází soubory | Zkontroluj přístupová práva a skutečnou existenci cest. |
| Export HTML je pomalý | U velkých datasetů je to očekávané; vypni náhledy a opakuj export. |
| Náhledy videí se negenerují | Ověř dostupnost a funkčnost /. |
| Po restartu se ztratí rozložení | Ověř zapisovatelný . |
| Prázdný export | Zkontroluj stav checkboxů kategorií a zda existuje poslední file list. |
FAQ (Q01–Q30)
| ID | Otázka | Odpověď |
|---|---|---|
| Q01 | Je aplikace určená jen pro video? | Ne, zpracovává audio, video i obrázky. |
| Q02 | Zamrzá UI při skenu? | Nemělo by; sken běží ve worker vlákně. |
| Q03 | Můžu scan dočasně pozastavit? | Ano, tlačítkem Pauza a následně Pokračovat. |
| Q04 | Kde se ukládá config? | Do souboru . |
| Q05 | Jak načtu existující file list? | Přes akci Načíst file_list a výběr TXT souboru. |
| Q06 | Co když je výstupní soubor už obsazený? | Aplikace použije bezpečný timestamp suffix. |
| Q07 | Podporuje app rekurzi do podadresářů? | Ano, používá rekurzivní průchod přes os.walk. |
| Q08 | Co znamená „ostatní“ ve statistikách? | Soubory mimo audio/video/image přípony. |
| Q09 | Je možné vypnout obrázky? | Ano, odškrtni kategorii Obrázky. |
| Q10 | Jaký je rozdíl TXT vs HTML export? | TXT je lineární seznam, HTML je interaktivní galerie. |
| Q11 | Generuje HTML i hledání? | Ano, má vestavěný fulltext filtr. |
| Q12 | Jdou v HTML filtrovat kategorie? | Ano, přes odkazy Vše/Audio/Video/Obrázky. |
| Q13 | Jak fungují náhledy obrázků? | Obrázky jsou vloženy přímo jako preview řádky. |
| Q14 | Jak fungují náhledy videí? | Přes ffmpeg screenshoty z více časových bodů. |
| Q15 | Co když nemám ffmpeg? | Export poběží dál, jen bez video náhledů. |
| Q16 | Jaké cesty ffmpeg se prohledávají? | Systémová PATH, bundled bin a běžné instalační cesty. |
| Q17 | Je možné mít více vstupních složek? | Ano, seznam je více-položkový. |
| Q18 | Jak odeberu jednu položku? | Přes Odebrat vybranou. |
| Q19 | Jak vymažu celý seznam? | Přes Vymazat vše. |
| Q20 | Ukládá se poslední file list? | Ano, jako v configu. |
| Q21 | Ukládá se velikost a pozice okna? | Ano, přes klíče a . |
| Q22 | Jak poznám průběh skenu? | Progress bar, status text a aktuální soubor. |
| Q23 | Lze sken bezpečně zastavit? | Ano, tlačítkem Stop s ukončením workeru. |
| Q24 | Co dělat při velmi velkých knihovnách? | Skenovat po dávkách a exportovat bez thumbnailů. |
| Q25 | Je app vhodná pro síťové disky? | Ano, ale počítej s delší odezvou. |
| Q26 | Mohu exportovat jen audio? | Ano, nech zapnutou pouze kategorii Audio. |
| Q27 | Mohu exportovat jen obrázky? | Ano, zapni pouze Obrázky. |
| Q28 | Co když je config poškozený? | Aplikace použije defaulty; případně config smaž a vytvoří se nový. |
| Q29 | Jaká je role externího file listu? | Umožní export/report i bez nového skenu. |
| Q30 | Je dokumentace určena i maintainerům? | Ano, obsahuje architekturu, config klíče, QA a provozní doporučení. |
OPS runbook (provozní scénáře a standardy)
C1 — Standardní produkční běh
- Načti uložený profil adresářů nebo přidej aktuální kořenové cesty.
- Nastav filtry kategorií (audio/video/obrázky) podle účelu reportu.
- Spusť sken a průběžně sleduj status + per-adresář statistiky.
- Po dokončení validuj souhrny a zkontroluj outlier adresáře.
- Exportuj TXT pro auditní pipeline.
- Exportuj HTML pro lidský review a sdílení.
- Ulož config snapshot a zapiš run poznámky.
C2 — Režim velké knihovny (large media tree)
- Preferuj lokální SSD pro export cesty.
- Nejprve proveď scan bez thumbnailů (rychlý audit).
- Teprve poté spusť cílený HTML export náhledů na podmnožinu.
- Při síťových share měř latenci a plánuj delší runtime.
- Dávkuj běhy po adresářových blocích, ne vše naráz.
C3 — Incidentní režim (když export padá)
- Odděl problém: vstupní data vs export pipeline vs oprávnění.
- Spusť export bez náhledů; pokud projde, problém je v ffmpeg části.
- Ověř cesty, názvy, znakové sady a práva zápisu.
- Zapiš incident s přesným časem a symptomem.
- Po fixu proveď potvrzovací run na malé i velké sadě dat.
C4 — Team collaboration režim
- Používej jednotnou naming konvenci exportů.
- TXT a HTML ukládej vždy společně jako jeden artefakt runu.
- Přidávej run metadata (operátor, datum, scope složek).
- Před sdílením proveď rychlou kontrolu čitelnosti HTML.