MFilmDB – uživatelský návod
Praktický průvodce prvním spuštěním a používáním MFilmDB a MFilmDB Qt, správou filmů, metadaty, importem a exportem.
🎬 MFilmDB - Uživatelský návod
Verze 0.2.2.30🎯 První spuštění
Při prvním spuštění aplikace vytvoří:
config.json- konfigurační soubormfilmdb.db- SQLite databáze filmůcovers/- složka pro stažené plakáty
Rozložení hlavního okna
| Oblast | Umístění | Funkce |
|---|---|---|
| 📋 Menu | Horní lišta | Soubor, Úpravy, Nástroje, Nastavení |
| 🔍 Panel nástrojů | Pod menu | Vyhledávání, filtry, rychlé akce |
| 📊 Tabulka filmů | Střed | Seznam všech filmů v databázi |
| 🖼️ Panel detailu | Pravá strana | Náhled vybraného filmu, cover |
| 📈 Stavový řádek | Spodní lišta | Počet filmů, stav operací |
⚙️ Základní nastavení
Přístup k nastavení
Menu: Nastavení → různé položky
Výběr tématu vzhledu
Nastavení → Vybrat motiv
- ttkbootstrap motivy - 20+ profesionálních témat
- Vlastní témata - uživatelem vytvořená
Změna jazyka
Nastavení → Lokalizace / Language
- 🇨🇿 Čeština
- 🇬🇧 English
Zdroje metadat
Nastavení → Zdroje metadat...
Zde můžete zapnout/vypnout jednotlivé zdroje:
- TMDb, OMDb, ČSFD, FDb, Edison Online, Netflix, Google Images
➕ Přidání filmů
Způsoby přidání
Skenování složky
Automatické přidání všech filmů ze složky
Ruční přidání
Přidání jednoho filmu s ručním vyplněním
Drag & Drop
Přetažení souborů/složek do okna
Ruční přidání filmu
Otevřete dialog
Menu: Úpravy → Přidat film...
Vyplňte údaje
Název, rok, žánr, cesta k souboru, cesta ke coveru...
Uložte
Klikněte na tlačítko Uložit
🔍 Skenování složek
Přístup
Menu: Nástroje → Skenovat složku...
Režimy skenování
| Režim | Ikona | Popis | Rychlost |
|---|---|---|---|
| Quick Scan | ⚡ | Pouze základní info (cesta, velikost, formát) | Velmi rychlé |
| Deep Scan | 🔍 | + extrakce metadat z názvů souborů a cest | Střední |
| Full Scan | 🌐 | + online enrichment (TMDb, ČSFD, covers...) | Pomalé (závisí na internetu) |
Co se extrahuje z názvu souboru
- Název filmu - první část názvu souboru
- Rok - číslo v závorce (2024) nebo za tečkou .2024.
- Kvalita - 1080p, 720p, 480p, 4K, UHD
- Zdroj - BluRay, WEB-DL, HDTV, DVDRip, BRRip
- Dabing/titulky - CZ, SK, EN, dabing, titulky
✏️ Editace záznamu
Způsoby editace
- Double-click na řádek v tabulce
- Menu: Úpravy → Upravit vybraný...
- Pravý klik → Upravit
Dostupná pole
| Pole | Popis |
|---|---|
| title | Název filmu (český) |
| original_title | Originální název |
| year | Rok vydání |
| genre | Žánr(y) |
| director | Režisér |
| writer | Scénář |
| cinematography | Kamera |
| music | Hudba |
| cast | Obsazení |
| dubbing | Dabing |
| subtitles | Titulky |
| duration | Délka filmu |
| file_size | Velikost souboru |
| file_path | Cesta k souboru |
| cover_path | Cesta ke coveru |
| plot | Popis děje |
| notes | Poznámky |
| rating | Hodnocení |
| quality | Kvalita (1080p, 4K...) |
🗑️ Mazání filmů
Smazání jednoho filmu
- Vyberte film v tabulce
- Menu: Úpravy → Smazat vybraný
- Potvrďte dialog
🌐 Zdroje metadat
Aplikace podporuje stahování metadat z těchto zdrojů:
🔑 API klíče
Získání TMDb API klíče
- Zaregistrujte se na themoviedb.org
- Přejděte do Settings → API
- Požádejte o API klíč (vývojář)
- Zkopírujte klíč do aplikace: Nastavení → Zdroje metadat
Získání OMDb API klíče
- Přejděte na omdbapi.com
- Zvolte tier (Free = 1000 požadavků/den)
- Potvrďte email a zkopírujte klíč
config.json.
Nezveřejňujte tento soubor (obsahuje vaše klíče).
✨ Enrichment (obohacení dat)
Enrichment je proces automatického doplnění metadat z online zdrojů.
Automatický enrichment
Probíhá při Full Scan nebo při použití Watchdog s auto_import: true.
Ruční enrichment
- Vyberte film(y) v tabulce
- Pravý klik → Obnovit metadata
- Aplikace stáhne aktuální data ze zdrojů
Priorita zdrojů
Pořadí, v jakém se data kombinují (nastavitelné):
- TMDb (preferovaný zdroj)
- OMDb / IMDb
- ČSFD
- FDb.cz
- Ostatní
📥 Import dat
Import ze starších verzí
Menu: Soubor → Import ze starších verzí...
Podporované formáty:
- CSV export ze starších verzí MFilmDB
- JSON export
- HTML export (omezená podpora)
Standardní import
Menu: Soubor → Importovat...
Import z aktuálních formátů (CSV, JSON) exportovaných touto verzí.
📤 Export dat
Přístup
Menu: Soubor → Exportovat...
Dostupné formáty
| Formát | Přípona | Použití |
|---|---|---|
| CSV | .csv | Tabulkové procesory (Excel, LibreOffice) |
| JSON | .json | Programatické zpracování, záloha |
| Excel | .xlsx | Microsoft Excel s vloženými náhledy |
| HTML | .html | Webová stránka pro prohlížení |
| XML | .xml | Strukturovaná data pro integraci |
| ZIP | .zip | HTML + všechny covery v archivu |
🎨 HTML šablony exportu
Při exportu do HTML můžete vybrat z několika šablon:
👁️ Watchdog - automatické sledování
Co je Watchdog?
Watchdog je funkce, která automaticky sleduje vybrané složky a při přidání nového video souboru ho automaticky importuje do databáze.
Nastavení
Menu: Nástroje → Nastavení watchdog...
Konfigurace
- Enabled - zapnutí/vypnutí watchdog
- Folders - seznam sledovaných složek
- Auto import - automatické přidání do DB
- Check interval - interval kontroly (sekundy)
- File types - sledované přípony (.mp4, .mkv, .avi...)
🎭 Témata vzhledu
Změna tématu
Menu: Nastavení → Vybrat motiv
ttkbootstrap témata
Tmavá: darkly, superhero, cyborg, vapor, solar
Světlá: flatly, litera, minty, lumen, sandstone, yeti
Ostatní: cosmo, journal, cerculean, pulse, morph...
Vlastní témata
Můžete vytvořit vlastní barevné schéma:
- Nastavení → Vybrat motiv → 🎨 Vlastní témata
- ➕ Vytvořit nové téma...
- Definujte barvy (bg, fg, accent, header, table...)
- Uložte téma
🔎 Vyhledávání a filtrování
Rychlé vyhledávání
Pole v panelu nástrojů - prohledává název, originální název, rok, režiséra.
Pokročilé vyhledávání
Menu: Nástroje → Pokročilé vyhledávání...
- Filtr podle roku (rozsah)
- Filtr podle žánru
- Filtr podle kvality
- Kombinace více kritérií
Víceúrovňové třídění
Menu: Nástroje → Víceúrovňové třídění...
- Primární: např. Rok (sestupně)
- Sekundární: např. Název (vzestupně)
- Terciární: např. Hodnocení (sestupně)
⌨️ Klávesové zkratky
| Zkratka | Akce |
|---|---|
| Ctrl + N | Nový film |
| Ctrl + O | Importovat |
| Ctrl + S | Exportovat |
| Ctrl + F | Vyhledávání |
| Enter | Editovat vybraný |
| Delete | Smazat vybraný |
| F5 | Obnovit zobrazení |
❓ Často kladené otázky (FAQ)
Kde se ukládá databáze?
Ve stejné složce jako aplikace, soubor mfilmdb.db (SQLite).
Můžu používat aplikaci offline?
Ano, základní funkce fungují offline. Pro enrichment metadat je potřeba internet.
Jak zálohovat databázi?
Zkopírujte soubory mfilmdb.db a config.json. Případně složku covers/.
Podporuje aplikace seriály?
Částečně - můžete přidat epizody jako samostatné záznamy. Plná podpora seriálů je plánována.
Jak přidat nový zdroj metadat?
Vyžaduje úpravu zdrojového kódu - přidání funkce enrich_film_* a registrace v konfiguraci.
🔧 Řešení problémů
❌ Aplikace se nespustí
- Ověřte verzi Pythonu:
python --version(vyžaduje 3.10+) - Nainstalujte závislosti:
pip install -r requirements.txt - Zkuste smazat
config.json(vytvoří se nový)
❌ Metadata se nestahují
- Ověřte připojení k internetu
- Zkontrolujte API klíče v nastavení
- Některé zdroje mohou být dočasně nedostupné
❌ Covery se nezobrazují
- Zkontrolujte cestu ke coveru v detailu filmu
- Ověřte, že soubor coveru existuje
- Podporované formáty: JPG, PNG, WebP
❌ Watchdog nefunguje
- Ověřte, že je watchdog zapnutý v nastavení
- Zkontrolujte oprávnění ke sledovaným složkám
- Restartujte aplikaci po změně nastavení