Metadata-Version: 2.4
Name: easympv
Version: 1.5.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.5.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
* The test suite in `tests/` needs nothing beyond the above - see [tests/README.md](tests/README.md)

#### 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, avif, heic)
    * Formats without a Qt image plugin (avif, heic) are decoded via ffmpeg
* Opening a single file loads its whole folder - including subfolders
    * Only the file you opened is shown; nothing advances on its own
    * Next/Prev step to the next or previous picture/video (green arrows, or Ctrl+Left / Ctrl+Right) - a video plays at once and stops at its end, an image waits
    * Next/Prev wrap around at the ends of the list; a running slideshow still stops at the last item
    * Press play to run through the rest of the folder as a slideshow (videos included)
    * Window title and info line follow the file currently shown
* Slideshow with configurable timeout
* Zoom with Ctrl + mouse wheel - works for videos and pictures
    * Zooms in on the mouse pointer, from 100% up to 800%
    * While zoomed in, drag with the left mouse button to move the visible section
    * The cursor turns into a hand as soon as the zoom is active
* 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 pip (all distros)
Install system dependencies first (libmpv, ffmpeg), then:
```
pip install easympv
```
Launch with `easyplayer` or open a file with `easyplayer /path/to/video.mp4`

#### 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 install --no-install-recommends 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 
10.09.2026
* Zoom for videos and pictures via Ctrl + mouse wheel, pan the zoomed image with the left mouse button
* Opening a file queues its whole folder tree - next/prev step through it, play runs it as a slideshow
* Next/Prev buttons added to the toolbar
* Added mts, m2ts, avif and heic; pictures now show up in the default file dialog filter
* Window title follows the current track - the media title, or the file name when there is none
* Reworked play/pause: browsing shows one item at a time (a video plays once, an image holds), pressing play runs the show from the current item, and the button always reflects what is happening
* Next/Prev wrap around at the ends of the list
* The folder scan sorts like a file manager: case-insensitive, numbers as numbers
* The playlist panel shows subfolder entries with their relative path (VD/song.mp4)
* Fixed the playlist panel button icon in the default icon set

12.05.2026
* Fix pause/play logic, audio display management, and PyDev import

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

