mpvQC

A simple libmpv-based application for creating video file quality control reports.
https://mpvqc.github.io

Development Setup

1. Install these tools

   • Python 3.13 or later
   • uv
   • just
   • Windows users also need
     • Git Bash
     • Be sure to run just inside Git Bash

2. Clone the repository

3. Open a terminal where you cloned it

4. Initialize the environment:

   just init
   

5. Add libmpv to your path

   • Linux: Install libmpv through your package manager
   • Windows: Download libmpv (mpv-dev-x86_64), extract it, and place the libmpv-*.dll in the repository’s root folder

6. Compile Resources:

   just build-develop
   

7. Start the application:

   uv run main.py
   

Whenever you change files in the data, i18n, or qml directories, run:

just build-develop

This compiles them into a Python file in the mpvqc folder, so the app recognizes them on startup.

Tip: Configure your IDE to run the build-develop recipe before launching the application.

Internationalization

If you want to translate this application into more languages, see the internationalization guide. Feel free to open a new issue if you need further assistance.

Licenses

This project uses multiple licenses for different parts:

• Our own source code: GNU GPL-3.0-or-later
• Build scripts and helper code: MIT
• Fonts (Noto Sans): SIL Open Font License 1.1
• Icons (Google Material Icons/Symbols): Apache-2.0

Each source file usually contains an SPDX license header. If a file does not have a header, its licensing information can be found in our REUSE.toml.