Database / Media
MfilmDB
0.2.6.4
Main application for film collection management ( graphical interface). Folder scanning, metadata, HTML export, profiles, CZ/EN localization.
What the project solves
Main application for film collection management ( graphical interface). Folder scanning, metadata, HTML export, profiles, CZ/EN localization.
Typical use
- Centralised management of films, series, documents and other content
- Intelligent Watchfolder Scanning (QUICK / DEEP / FULL mods)
- Advanced parsing of metadata (name, year, actors, dubbing, episode, order)
- Manual and automatic data enrichment (CSDD, TMDb, OMDb, FDb, IMDb)
- Management cover art (download, caching, fallback strategy)
- YouTube fallback for online-only items (placeholders)
How the application works and what it is for
Overview
MfilmDB is part of the MFilmDB repository. This documentation was aggregated from all available versions.
- Watchfolders Inline Editing: The Quick / Deep / Disabled mode can be set directly in the table.
- Harden Subprocesses: More robust call of FFprobe / yt-dlp with fixed UTF-8 coding.
- Scanner Stability: Fix critical threed- safety NameError bug.
- More robust network communication for Wikidata seeder (GET → POST fallback + retry / backoff)
- Updated import of persons: 'APP _ DATA / known _ actors.txt' + list generator
- Tests moved to 'tests /' + unified links in documentation
- Python 3.8 +
- ttkbootstrap
This is the total amount of the subordinated mutual member accounts that meet the criteria for Tier 1.
- More robust network communication for Wikidata seeder (GET → POST fallback + retry / backoff)
- Updated import of persons: 'APP _ DATA / known _ actors.txt' + list generator
- Tests moved to 'tests /' + unified links in documentation
- Python 3.8 +
- ttkbootstrap
- yt-dlp (for downloading videos from YouTube)
- FFmpeg / FFprobe (metadata)
- YT placeholder (online- only) are highlighted in the table (red line + white bold text)
- Collection statistics show the number of YT placeholders
- YT fallback can optionally download video via yt-dlp to the selected folder
- Window head has buttons for minimization and closing (with tooltips)
- Scan libraries a watchfolder
- Deep parsing names and paths
- Online enrichment (CSDD)
- YouTube fallback (placeholder on empty search)
- YT placeholder in the highlighted table (red line + white bold text)
- Statistics include YT placeholders
- Optional download YT videos via yt-dlp (setting in YT fallback)
- In- app header with buttons Minimalization and Close
- Integration with the players and tools of the project
Use & batch mode
The application can be started in several ways depending on the environment:
| Parameter | Description |
|---|---|
| Enables detailed logging (including ). | |
| Path to Alternative . | |
| Load a specific user profile. |
Online Enrichment: Contains Wikidata Seeder with a retry mechanism, and YouTube Integration (uses ).
- Batch Scanning: Support for fast disk searching and extraction of technical metadata (FFmpeg).
- Shell Integration: Option to run movies directly in the system player via DND or context menu.
Troubleshooting
| Problem | Cause | Solution |
|---|---|---|
| Metadata Download Error (HTTP 4xx / 5xx) | Check the connection. Wikidata seeder uses automatic retras and fallback to post questions. | |
| No miniature reading | Verify the existence of the folder and installed FFmpeg / FFprobe components. | |
| Slow gear shift in table | For a large number of movies (10k +) we recommend using 64-bit Python and enough RAM for caching the results of queries. |
The total amount of the funding received shall be reported in column 060.
- What are YT placeholders?
- These are entries in a database that do not have a local file but refer to an online video (YouTube). The table highlights the red background.
- Can I download the YT videos right now?
- Yes, if you have installed tool , you can select the "Download Video" action in the application.
- Where can I find the logs?
- All outputs and errors are saved to folder .