Metadata-Version: 2.4
Name: easympv
Version: 1.4.0
Summary: Simple video and audio player based on mpv
License: GPL-2.0-or-later
Project-URL: Homepage, https://github.com/kanehekili/EasyPlayer
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: PyQt6

# EasyPlayer
Version 1.4.0


A simple video and audio player based on mpv and QT6 . It is a spin off of my VideoCut app. It handles pictures, plays videos and audio files.

![Screenshot](https://raw.githubusercontent.com/kanehekili/EasyPlayer/main/easyplayer.png)

Configurable Spectrum Analyzer:

![Screenshot](https://raw.githubusercontent.com/kanehekili/EasyPlayer/main/spectrum.png)

### Prerequisites
* Arch: python3, python-pillow and mpv
* Debian/Mint/Ubuntu: python3 python3-pil libmpv2 (or libmpv1) (no-recommends) 
* Ubuntu 26.04 needs additionally qt6-svg-plugins
  #not working for Ubuntu 18.4: libmpv - use python3-opencv instead
* Fedora: python3-pillow-qt and mpv-libs.x86_64
* ffmpeg > 3.X to 8.X
* python3-pyqt6

#### Set GTK Theme for this QT application
If you are running a DE with GTK/Gnome (as opposed to LXQT or KDE)  you might set QT_QPA_PLATFORMTHEME:
* Depending on the distro and version this variable may be defined with one of:
* gtk2, qt6ct, fusion, gtk3
* Easyplayer will enforce "QT_QPA_PLATFORM=xcb" on Wayland for SSD decorations.
* On Ubuntu 26.04 you need to install qt6-gtk-platformtheme. This will get your GTK theme into any QT6 app. 
* On Ubuntu(with libadwaita) use /etc/environment to add GTK_THEME=yourTheme to enforce a third party theme. (Hack)

### Features
* Easyplayer supports wayland and orientation recognition (which mplayer does not). 
* Has been tested with interlaced video and 4K 
* Subtitles can be shown (settings)
* Playlist support
* Picture/image viewer (png, jpg, bmp, gif, webp, tiff)
* Slideshow with configurable timeout
* Flat and non flat icon set
* Language can be selected
* Supports an EQ-display for audio files - Some distros need to install python3-sounddevice via pip. (Not mandatory) 
* Colors of the EQ display can be changed live via the settings dialog. 
* Settings allows you to switch to software mode (old hardware & virtual environments)


### Support for Qemu and old hardware:
* -v will use a virtual GL driver or software for rendering. (easyplayer -v)
* Can be set via the "Settings dialog - Software mode" as well. 


#### Install via ppa on Linux Mint or Ubuntu (Mint 22.2, Ubuntu 22.04 and newer versions)
```
sudo add-apt-repository ppa:jentiger-moratai/mediatools
sudo apt update
sudo apt install --no-install-recommends easyplayer
```
(--no-install-recommends will install only what is required)
Select video and open it with "Open with ->EasyPlayer", oder via terminal "easyplayer"

Remove with:
`sudo apt remove easyplayer`

#### Install EasyPlayer via AUR (Arch Linux /Manjaro only)
* Use pamac or other GUI tools, search for "easyplayer" in AUR, click install
* Manually :
    * Download [PKGBUILD ](https://aur.archlinux.org/cgit/aur.git/snapshot/easyplayer.tar.gz)
    * unpack it and go into the "easyplayer" folder
    * execute `makepkg -s`
    * excute `sudo pacman -U easyplayer-1.x.x.x-1-x86_64.pkg.tar.zst` 
    * uninstall via `sudo pacman -Rs easyplayer`

Select video and open it with "Open with ->EasyPlayer", oder via terminal "easyplayer"


#### Install dependencies manually on Linux Mint or Ubuntu (tested from noble to resolute)
```
sudo apt –no-install-recommends install python3-pyqt6 ffmpeg python3-pil libmpv2
```

#### Install dependencies on Fedora
```
sudo dnf python3-qt6 ffmpeg python3-pillow-qt mpv-libs.x86_64
```

### How to install with a terminal
* Install dependencies (see prerequisites)
* Download the easyplayer*.tar from the download link (see above)
* Extract it to a location that suits you.
* Open a terminal to execute the install.sh file inside the folder with sudo like `sudo ./install.sh`
* (if you are in the download directory - just an example)
* The app will be installed in /opt/easyplayer with a link to /usr/bin. 
* The app should be appear in a menu or "Actvities"
* Can be openend by selecting a video file & Open with...
* In the terminal can be started via `easyplayer`
* python qt6, mpv and ffmpeg are required
* you may now remove that download directory.
* logs can be found in the user home ".config/EasyPlayer" folder

### How to remove
* Open a terminal
* execute `sudo /opt/easyplayer/uninstall.sh`

### Changes 
23.04.2026:
* Added slideshow features for pictures
* Improved scrolling while playing

18.04.2026
* Remove outer border for fullscreen
* Picture/image support added to file dialog and MIME types
* Fix playlist errors

30.03.2026
* Playlist support
* Fix scaled Xwayland desktops

21.03.2026
* Support for virtual environments or slow hardware via SettingsDialog

20.03.2026
* introducing "parec" for Spectrum EQ (Ubuntu)
 
16.03.2026
* Configuration of Spectrum EQ
* Reviewed Pulseaudio dependencies
* Distro agnostic installation (Debian & Arch)

12.03.2026
* Graphic EQ display for audio files 

09.03.2026
* Support for playlists and streams

05.03.2026
* Hardened interlacing recognition, fixed interprocess communication

26..12.2025
* Initial start

