Databáze / média
MfilmDB
0.2.6.4
Hlavní aplikace pro správu filmové sbírky ( grafické rozhraní). Skenování složek, metadata, HTML export, profily, lokalizace CZ/EN.
Co projekt řeší
Hlavní aplikace pro správu filmové sbírky ( grafické rozhraní). Skenování složek, metadata, HTML export, profily, lokalizace CZ/EN.
Typické použití
- Centralizovaná správa filmů, sérií, dokumentů a dalšího obsahu
- Inteligentní skenování watchfolderů (QUICK/DEEP/FULL mody)
- Pokročilé parsování metadat (název, rok, herci, dabing, epizoda, pořadí)
- Manuální a automatické obohacování dat (ČSFD, TMDb, OMDb, FDb, IMDb)
- Management cover artů (stažení, caching, fallback strategie)
- YouTube fallback pro online-only položky (placeholdery)
Jak aplikace funguje a k čemu slouží
Přehled
MfilmDB je součástí MFilmDB repozitáře. Tato dokumentace byla agregována ze všech dostupných verzí.
- Inline editace Watchfolderů: Režim skenování (Quick/Deep/Disabled) lze nastavit přímo v tabulce.
- Hardened Subprocesses: Robustnější volání ffprobe/yt-dlp s fixovaným kódováním UTF-8.
- Scanner Stability: Oprava kritického thread-safety NameError bugu.
- Robustnější síťová komunikace pro Wikidata seeder (GET→POST fallback + retry/backoff)
- Aktualizovaný import osob: `APP_DATA/known_actors.txt` (varianty/aliasy) + generátor seznamu
- Testy přesunuty do `tests/` + sjednocené odkazy v dokumentaci
- Python 3.8+
- ttkbootstrap
Funkce (agregované ze všech verzí)
- Robustnější síťová komunikace pro Wikidata seeder (GET→POST fallback + retry/backoff)
- Aktualizovaný import osob: `APP_DATA/known_actors.txt` (varianty/aliasy) + generátor seznamu
- Testy přesunuty do `tests/` + sjednocené odkazy v dokumentaci
- Python 3.8+
- ttkbootstrap
- yt-dlp (pro stažení videa z YouTube)
- FFmpeg/FFprobe (metadata)
- YT placeholdery (online-only) jsou zvýrazněné v tabulce (rudý řádek + bílý bold text)
- Statistiky sbírky uvádí počet YT placeholderů
- YT fallback umí volitelně stáhnout video přes yt-dlp do zvolené složky
- Hlavička okna má tlačítka pro minimalizaci a zavření (s tooltipy)
- Scan knihoven a watchfolder
- Hloubkový parsing názvů a cest
- Online enrichment (ČSFD)
- YouTube fallback (placeholdery při prázdném vyhledávání)
- YT placeholdery v tabulce zvýrazněné (červený řádek + bílý bold text)
- Statistiky obsahují počty YT placeholderů
- Volitelné stahování YT videí přes yt-dlp (nastavení v YT fallback)
- In-app hlavička s tlačítky Minimalizace a Zavření
- Integrace s přehrávači a nástroji projektu
Použití & dávkový režim
Aplikaci lze spustit několika způsoby v závislosti na prostředí:
| Parametr | Popis |
|---|---|
| Zapne detailní logování (včetně ). | |
| Cesta k alternativnímu . | |
| Načte specifický uživatelský profil. |
Online Enrichment: Obsahuje Wikidata Seeder s retry mechanismem a YouTube Integration (využívá ).
- Batch Skenování: Podpora pro rychlé prohledávání disků a extrakci technických metadat (FFmpeg).
- Shell Integration: Možnost spouštět filmy přímo v systémovém přehrávači přes DND nebo kontextové menu.
Troubleshooting
| Problém | Příčina | Řešení |
|---|---|---|
| Chyba při stahování metadat (HTTP 4xx/5xx) | Zkontrolujte připojení. Wikidata seeder používá automatický retry a fallback na POST dotazy. | |
| Nenačítají se miniatury | Ověřte existenci složky a nainstalované komponenty FFmpeg/FFprobe. | |
| Pomalé řazení v tabulce | Při velkém počtu filmů (10k+) doporučujeme používat 64-bit Python a dostatek RAM pro caching výsledků dotazů. |
FAQ
- Co jsou to "YT placeholdery"?
- Jedná se o záznamy v databázi, které nemají lokální soubor, ale odkazují na online video (YouTube). V tabulce jsou zvýrazněny rudým pozadím.
- Mohu YT videa rovnou stáhnout?
- Ano, pokud máte nainstalovaný nástroj , můžete v aplikaci zvolit akci "Stáhnout video".
- Kde najdu logy?
- Všechny výstupy a chyby se ukládají do složky .
Publikace a návody ve Čtení
Archivní uživatelský návod a recenze vycházejí z MFilmDB 0.2.2.30; popisují tuto generaci aplikace.