Metadata-Version: 2.4
Name: mpvbuddy
Version: 0.10.dev4+g2372f1e5c
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

Repositories are maintained for Fedora 42 and 43. For Fedora 43, as root, create the file `/etc/yum.repos.d/bp-fedora43-release.repo` with the following contents:

```
[bp-fedora43-release]
name=BattlePenguin (Fedora 43) (Release)
baseurl=https://nexus.sumit.im/repository/bp-fedora43
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
```

The repository configuration for Fedora 42 is identical, just replace all the `fedora43` instances with `fedora42` 

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. 
