AudioDB

Přehled & filozofie

AudioDB je navržený pro smíšené kolekce (audio, MIDI, tracker, video klipy), nekonzistentní tagy a potřebu rychlé operativy nad velkým datasetem. Primárním cílem je mít jeden stabilní desktop nástroj, který zvládá ingest, analýzu, validaci metadat, export i praktický „copy workflow“ pro kurátorské použití.

Use-case orientace

• Archivace: katalogizace velkých sbírek se silnou variabilitou kvality tagů.
• Kurátorství: rychlé filtrování podle BPM, key, roku, žánru a vlastních polí.
• Integrace: export do XLSX/CSV/HTML a navazující práce v dalších nástrojích.
• Workflow „To chci“: staging + přenos vybraného subsetu na cílové médium.

Podporované formáty

Výchozí sada přípon je navržená jako široké „ingest minimum“ pro reálné sbírky, kde se míchá moderní audio, historické formáty i video klipy používané jako hudební reference.

• Audio:
• MIDI:
• SID:
• Tracker:
• Video:

Praktická kompatibilita

• Tracker/SID soubory jsou plně evidovatelné v databázi a exportech.
• Playback a detailní analýza tracker/SID může vyžadovat externí backend nástroj.
• Video formáty se používají primárně pro evidenci, preview a metadata workflow.
• Rozšíření seznamu je možné přes nastavení aplikace filtru (scan include/extensions).

Formátová strategie v provozu

1. Nejprve proveď QUICK scan přes celé rooty kvůli inventory.
2. DEEP/FULL pouštěj až na vybrané subsety.
3. Neznámé nebo problematické přípony ukládej do custom flagu pro pozdější audit.

To chci workflow

Workflow je určený pro logistiku výběru tracků do cílové složky (USB, staging, release subset). V praxi jsou k dispozici dva režimy.

09.1 Přímé kopírování

• Akce: akci To chci
• Použití: rychlá jednorázová akce bez mezikroku.
• Výhoda: minimální počet kliknutí.
• Riziko: slabší kontrola cílové struktury před spuštěním.

09.2 Staging pipeline

1. přidání do průběžného výběru — průběžné skládání výběru napříč filtry.
2. náhled a validaci zdrojů a cílů — validace zdrojů/cílů před kopírováním.
3. finální vytvoření přenosové úlohy — finální job a přenos.

09.3 Doporučení pro velké kopie

• Na Windows použij robocopy režim, pokud je dostupný v konfiguraci.
• Vždy uchovej log summary: počty kopírovaných souborů, chyby, missing files.
• Při opakovaném balíčkování pracuj s manifestem a timestamp exportem.

Exporty + streaming server + subtitles

10.1 Exporty

• XLSX: ideální pro ruční editace a roundtrip import.
• CSV: vhodné pro automatizaci, diffy a BI pipeline.
• HTML: reporty a playlisty; pro robustní prohlížení je k dispozici .

10.2 Streaming server (Range Requests)

implementuje HTTP Range Requests pro okamžité seek/přehrávání velkých souborů bez full downloadu. Je určený pro localhost/LAN scénáře a je vhodný zejména pro HTML exporty s audio odkazy.

• podpora RFC 7233 range
• single-thread model (jedna export session)
• graceful shutdown
• důraz na lokální provoz, nikoli veřejný hosting

10.3 Subtitles a textové doprovodné soubory

AudioDB v této verzi neřeší plnohodnotný subtitle pipeline jako primární funkci playeru; pracuje se zejména s metadaty a exportem. Pokud jsou v knihovně externí textové doprovody (lyrics/notes), doporučený postup je evidovat je přes custom pole nebo navazující exportní workflow.

• embedded subtitle stream není hlavní cílový scénář AudioDB monolitu
• externí textové soubory lze mapovat přes filepath/custom sloupce
• pro pokročilé playback scénáře je vhodné napojení na specializovaný player

Troubleshooting + diagnostika

14.1 Rychlá matice problémů

• Deep/Full scan selhává: ověř /, spusť worker test, fallback na Quick.
• Lookup chyby: zkontroluj tokeny, internet, rate-limit a retry interval.
• FFmpeg nedostupný: ověř a cestu v konfiguraci.
• Pomalé UI: paging, menší počet sloupců, scan dávkovat.
• Playback nefunguje: fallback na System player provider, zkontroluj backend volby.
• HTML playback nefunkční: použij nebo lokální streaming server.

14.2 Diagnostický tok

1. Zopakuj problém na malém test datasetu.
2. Ulož log export a poznamenej aktivní config klíče.
3. Ověř, zda problém vzniká i po resetu konfigurace.
4. Teprve potom proveď reindex all nebo migraci DB.

14.3 Known limits (runtime)

• Mastering-grade loudness a true-peak metriky nejsou cílem aplikace.
• Vizualizér není zamýšlen jako DAW realtime DSP nástroj.
• Multimachine DB sync je řešen export/import workflow, ne distribuovanou DB.

14.4 FAQ (provozní otázky)

Proč se po přesunu knihovny rozbije část výsledků?

Primární identita řádku je . Pokud se změní kořenová cesta, staré záznamy je potřeba reindexovat nebo migrovat mapováním cest. Hash pomáhá s dedupe, ale nenahrazuje změnu absolutní cesty.

Je lepší Deep scan na všechno naráz?

Ne. Pro stabilitu je lepší dávkování po složkách nebo profilech. Velké jednorázové běhy zvyšují riziko timeoutu workeru a komplikují recovery.

Kdy použít Save DB As místo Save DB?

Při větších hromadných operacích (masový import, globální editace, přemapování cest) vždy použij akci Uložit databázi jako… a pracuj na snapshotu.

Jak řešit pomalé procházení tabulky?

Omez viditelné sloupce, drž paging, nepoužívej show all řádky a zkontroluj, zda současně neběží náročný scan nebo lookup.

Mohu HTML export sdílet veřejně?

Ano pouze po anonymizaci. Export může obsahovat lokální cesty nebo interní identifikátory. Před zveřejněním odstraň citlivé údaje.