Metadata-Version: 2.4
Name: mpvbuddy
Version: 0.8.dev49+g9e0ca0c2e
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: pyobjc>=12.0; sys_platform == 'darwin'
Requires-Dist: pyside6>=6.9.0
Requires-Dist: python-mpv>=1.0.7
Requires-Dist: python-xlib>=0.33
Requires-Dist: pywin32>=306; sys_platform == 'win32'
Requires-Dist: rich>=13.8.1
Requires-Dist: yoyo-migrations>=9.0.0
Description-Content-Type: text/markdown

# mpvbuddy

[![Build Status](https://build.sumit.im/badge/mpvbuddy.svg "MpvBuddy Build Status")](https://build.sumit.im/jobs/mpvbuddy)

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.

#### Gentoo Linux

Enable the BattlePenguin Gentoo overlay.

```commandline
eselect repository enable battlepenguin
emerge -av mpvbuddy
```

#### Fedora

A repository is maintained for Fedora 42. As root, create the file `/etc/yum.repos.d/bp-fedora42-release.repo` with the following contents:

```
[bp-fedora42-release]
name=BattlePenguin (Fedora 42) (Release)
baseurl=https://nexus.sumit.im/repository/bp-fedora42
enabled=1
countme=1
metadata_expire=7d
repo_gpgcheck=1
type=rpm
gpgcheck=1
gpgkey=https://nexus.sumit.im/repository/public-keys/RPM-GPG-KEY-battlepenguin
```

Then install the package using `dnf`:

```commandline
dnf install mpvbuddy
```

#### 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
```

#### 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 mpvbuddy
```

#### Fedora Unstable Builds

Use the following repository configuration if you hate yourself.

```
[bp-fedora42-unstable]
name=BattlePenguin (Fedora 42) (Unstable)
baseurl=https://nexus.sumit.im/repository/bp-fedora42-unstable
enabled=1
countme=1
metadata_expire=7d
repo_gpgcheck=1
type=rpm
gpgcheck=1
gpgkey=https://nexus.sumit.im/repository/public-keys/RPM-GPG-KEY-battlepenguin
```

# License

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