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.

Configurable Spectrum Analyzer:

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

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
  • 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