Metadata-Version: 2.4
Name: mpvbuddy
Version: 0.6.dev26+gca3f72ad8
Summary: media player that tracks watching progress
Author-email: sumit@penguindreasm.org
License-File: LICENSE.txt
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: X11 Applications :: Qt
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Topic :: Multimedia :: Video
Classifier: Topic :: Multimedia :: Video :: Display
Requires-Python: >=3.12
Requires-Dist: click>=8.1
Requires-Dist: pyqt6>=6.8.0
Requires-Dist: python-mpv>=1.0.7
Requires-Dist: python-xlib>=0.33
Requires-Dist: rich>=13.8.1
Requires-Dist: yoyo-migrations>=9.0.0
Description-Content-Type: text/markdown

# mpvbuddy

![PyPI](https://img.shields.io/pypi/v/mpvbuddy.svg)

Mpvbuddy is a frontend for the media player [mpv](https://mpv.io). Its main feature is the ability to keep track of where you are in every video on your playlist so you can jump around between videos you are currently watching. It supports multiple playlists as well.

It's still in early beta and is written in Python + PyQt6. Please include and messages from the console and logging window (Ctrl+U) when filing issues.

![Screenshot of mpvbuddy with playlist and video window](screenshots/mpvbuddy-example-1.png)


# Installation

Mpvbuddy is dependent on PyQt6. There are several installation methods.

Virtual environment using `pip`:
```commandline
python3 -m venv mpvbuddy-venv
source mpvbuddy-venv/bin/active
pip install mpvbuddy --extra-index-url https://nexus.sumit.im/repository/bp-python/simple
mpvbuddy
```

Creating a developer environment using the source (requires the `uv` build tool)
```commandline
git clone https://gitlab.com/djsumdog/mpvbuddy
cd mpvbuddy
uv sync
uv run python3 -m mediahug
```

# License

mpvbuddy is licensed under the GNU GPLv3 (2019,2025). Dependencies and their licenses can be found in the about menu. 
