https://github.com/mpvqc/mpvQC
A simple libmpv-based application for creating video file quality control reports.
https://github.com/mpvqc/mpvQC
libmpv linux mpv pyside6 quality-control windows
Last synced: 4 months ago
JSON representation
A simple libmpv-based application for creating video file quality control reports.
- Host: GitHub
- URL: https://github.com/mpvqc/mpvQC
- Owner: mpvqc
- License: gpl-3.0
- Created: 2016-02-03T15:21:54.000Z (almost 10 years ago)
- Default Branch: main
- Last Pushed: 2025-05-18T19:11:26.000Z (6 months ago)
- Last Synced: 2025-05-18T20:23:02.888Z (6 months ago)
- Topics: libmpv, linux, mpv, pyside6, quality-control, windows
- Language: QML
- Homepage: https://mpvqc.github.io
- Size: 7.24 MB
- Stars: 57
- Watchers: 6
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.MD
- Contributing: CONTRIBUTING.MD
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-mpv - mpvQC - Cross-platform application for quality control of videos, based on Python/QT. (Other)
README
# 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](https://www.python.org/downloads/)
- [uv](https://github.com/astral-sh/uv)
- [just](https://github.com/casey/just)
- **Windows users also need**
- [Git Bash](https://git-scm.com/downloads)
- Be sure to run `just` inside Git Bash
2. **Clone the repository**
3. **Open a terminal** where you cloned it
4. **Initialize the environment**:
```shell
just init
```
5. **Add libmpv to your path**
- **Linux**: Install `libmpv` through your package manager
- **Windows**: Download [libmpv (mpv-dev-x86_64)](https://github.com/shinchiro/mpv-winbuild-cmake/releases), extract it, and place the `libmpv-*.dll` in the repository’s root folder
6. **Compile Resources:**
```shell
just build-develop
```
7. **Start the application:**
```shell
uv run main.py
```
Whenever you change files in the `data`, `i18n`, or `qml` directories, run:
```shell
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` before launching the application.
## Internationalization
If you want to translate this application into more languages, see the [internationalization guide](docs/internationalization.md).
Feel free to open a new issue if you need further assistance.