easympv 1.4.0__py3-none-any.whl

easympv-1.4.0.dist-info/METADATA

@@ -0,0 +1,147 @@
+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
+

easympv-1.4.0.dist-info/RECORD

@@ -0,0 +1,77 @@
+easyplayer/AudioPlay.py,sha256=4wniMy-hEZSxEwv8AUPvNu3VxovyGIlpIfA9pYjci1Y,7290
+easyplayer/EasyPlayer.py,sha256=OeKFRFTaRPscOHWEIx84Rhwy-Eycg3cIgsdRIoW9nZk,56890
+easyplayer/FFMPEGTools.py,sha256=TQimYgsFKIbiVNCY58cU-KoDoF8AV_sZOUo816vAsYM,46015
+easyplayer/Playlist.py,sha256=n92qz6eUXAFfsOZAj2i4_StvvH8C-WX-obW9rxdDGAo,9104
+easyplayer/QtTools.py,sha256=1vlJ1YF2pRzE8vzYksFFZ3xhUBiSF4vQQGBdnLKBotM,1863
+easyplayer/Slideshow.py,sha256=CUtD80HVMTYKSvvmf1AKEPQRevLDqODzwjLXOm49Tys,3925
+easyplayer/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+easyplayer/icons/Pictures-icon.png,sha256=nRXcb0j4wffG8COCz_bH55wpe1-roagz_vtmYMBTX5o,31152
+easyplayer/icons/clear-all.png,sha256=wvGLF-xR1NNlaTlYsvlBIbDO_muCO5BnixHsAWZT-pM,19751
+easyplayer/icons/close-x.png,sha256=oCv28VjQgE-MeLTy0TTp5hjB9oGTIHFm4UsWDh67CtM,9925
+easyplayer/icons/easyPlay.png,sha256=4kdLxFKybPaNEI5BcEIXLH5QysmuKMhhB3e4iNfhWHQ,57948
+easyplayer/icons/easyPlay.svg,sha256=4A39UEthvN6Jv0p75nxxKiVpqECRSweD89nbULLb49A,5591
+easyplayer/icons/film-clapper.png,sha256=xWNdhWAITXLhDqZx8lfVYbvl6smBFMAyxPaTi_2bHM0,41422
+easyplayer/icons/fullscreen.png,sha256=0x4UuVcdHZH_yt_6IRdsfFmHkxMycUoPNjOH0zyajCU,4322
+easyplayer/icons/go-next.png,sha256=_tF0KYzI1up_Nqc0kxEcyqqjcmyfUvBP7Q02qqAGfv8,10365
+easyplayer/icons/icomap.json,sha256=OM2x7yPr5qmDd_odW8HZAtRv5oOqTG4VPCfYxqHdMjE,3016
+easyplayer/icons/info.png,sha256=H6RI8Yer2gnRyp5VR2nFlFj8zISUACoHgerndabAkmE,10917
+easyplayer/icons/langflags.png,sha256=ogOEA3KPplleix0I9UFlHsJKGiu6kb99A8ovocsasSA,58832
+easyplayer/icons/license.txt,sha256=nLwFv-RmmyZl4fVibZjXEHoVhNxHglrC1kqsjkGLg78,194
+easyplayer/icons/loadfile.png,sha256=7YEo8GYcVbsVWDgEFQopKTvpPRnUxv-KqseltTmpgak,11772
+easyplayer/icons/movie-icon.png,sha256=rNTDLL1T7xguEhthIJKXkehFNWjhqxnY-0PrtGJZRp8,12768
+easyplayer/icons/newList.png,sha256=DiGuyLv8o81E3qNUkEOlErG_de-QiHPl_Tzqzagq4fw,9476
+easyplayer/icons/next.png,sha256=3gvtgCgoRRH1UwEHog2L5acLDdvjTcdrdR1cTZJcmAA,7113
+easyplayer/icons/pause.png,sha256=NPz85YvCErMUs1QOSCZ9KopYPkEgFfP4y1TLeErP7NI,9283
+easyplayer/icons/play.png,sha256=aJg2k93liu4g7cE9HF6SdEwiaQ2oJusM_Zer2LK8F0A,10348
+easyplayer/icons/previous.png,sha256=uFJY_7qZiVU-5rFzzT4X_y9kciSVupgTagErmccJMw4,7040
+easyplayer/icons/save-as-icon.png,sha256=1_jFiIO0kSCQefL8CpIYl3wowe1T6ue842EUwLZAgqU,19625
+easyplayer/icons/screenshot.png,sha256=C2g5kGcB1i0-nzUP6LalvM4BV9Ez2CUVvb0d--hmRrU,12315
+easyplayer/icons/settings.png,sha256=2JPUeCiJ7ZQWK5eU7dlqDBJD2yOfpxo4zcywN2rR61U,25073
+easyplayer/icons/speaker-high.png,sha256=ZSDk3ePsEnHeqiClenksw1eDofku4b5SgwysgGtbxr0,5358
+easyplayer/icons/speaker-muted.png,sha256=uPBT1JVU_0HdVCkCLjScIoYP9gke-b_nMsVdBFoSRBc,5217
+easyplayer/icons/splitVertical.png,sha256=M-OusZLoQ2d-hM5tVhKUBN2GCxyHMuKzcckbEhqtHBg,16122
+easyplayer/icons/start-icon.png,sha256=iKPCXPkQfU1snvg7tdJWjoVrJYDo7cURnL7MIuSLM2s,5687
+easyplayer/icons/stop-red-icon.png,sha256=IsYqbgPs4ikrlTS8iiKj2Nq7RiT0-Fq8wM_rBJsXoJs,3203
+easyplayer/icons/video_clapper.png,sha256=GCimowGev2zMpnmmV7a9NpiiL0JQGtdM6qHy4aEhAaA,56090
+easyplayer/icons/window-close.png,sha256=GK5Mok9px2hyKFcyVdcjidPdLdfE99s8ht2iALg78lU,15444
+easyplayer/icons/flatdark/fullscreen.png,sha256=HlGcbtFK6IZQhcIE_S8fYLFmmkZvS8FZ-NL9jvi0yG0,14760
+easyplayer/icons/flatdark/goto.svg,sha256=-RzidC47NUn1tTr6W2ltPjM0AjFEx5D3BT8F3J_k4aw,1939
+easyplayer/icons/flatdark/info.svg,sha256=sYj79PHj5xrbSvonCY4nDXuiVkRGmh4tlo7avesevuo,2289
+easyplayer/icons/flatdark/mute.svg,sha256=FVKraZ9Jr69UjLOClFj8Qh4UcSpvxaW01ok2K3Dva7Y,2424
+easyplayer/icons/flatdark/newList.svg,sha256=Mev6b227hxIW4MSeGkVUEOfGGOggY0YwhDqO0qlXeBs,3342
+easyplayer/icons/flatdark/open.svg,sha256=pjHp4A2QYsv0xDZ5GA6oKQbNAcqY9DTSPxmxUdIn13Q,1620
+easyplayer/icons/flatdark/pause.svg,sha256=XWF9A3DBVMMjklnSzB1ZwIBqBUkjYnDF5h-Dc8n44jo,1306
+easyplayer/icons/flatdark/play.svg,sha256=zALoG-g1gHFAphVMkovtZieTjyvFpvD9A2i5oLX703k,1535
+easyplayer/icons/flatdark/remove.svg,sha256=rDMTpPshftckhl2exZkkp9yAmCCXThTaf9lVxUm1PZg,1425
+easyplayer/icons/flatdark/remove_all.svg,sha256=izKMdJr7z2cZRzov9318B-m9OOa_zLMWZy9YV3zS5tU,2306
+easyplayer/icons/flatdark/save.svg,sha256=Xn1z0oB__qePYJI1znlEkJj2rEwq9FilSyfFcBQtDcg,2006
+easyplayer/icons/flatdark/screenshot.svg,sha256=2n7WATAwFHU3blWhwoNgEeXEQmMvuUoBtHvk5XNjOtQ,1712
+easyplayer/icons/flatdark/settings.svg,sha256=3qI8zGwJTk0WmknoYol4ETWoMZTIuCDzNRrG0dD2J68,2325
+easyplayer/icons/flatdark/sound.svg,sha256=nbkLDEyP8OWhKsBh1JVnLBY4yKnNHlIQkUJzVFANukM,2147
+easyplayer/icons/flatdark/splitVertical.svg,sha256=-kaI9gOkjYvRNKX0mxRBRdvNKtvgDvsJlO8cuHkBLDs,201
+easyplayer/icons/flatdark/start-cut.svg,sha256=ie7tyS1kPcY4mLMUi5T3Ir-SDvGx7h-CAH63bRCRyZE,1699
+easyplayer/icons/flatdark/stop-cut.svg,sha256=9s0e092Ze-rrFZYZozG5_X52CrR7PHUpQJTloMenbDA,1743
+easyplayer/icons/flaticons/fullscreen.png,sha256=nlRf-QPG4llrEkk27FjQE3vjlI5wE07sTGjZCGzSG5I,4894
+easyplayer/icons/flaticons/goto.svg,sha256=0XpDsby0LbJAn1F1ILABrzQO6UDYukZX4fwAMD-gohM,744
+easyplayer/icons/flaticons/info.svg,sha256=XUr9l0X1qaK61PqDkSytc5TL3GoWmz82v4UJXxkwhig,516
+easyplayer/icons/flaticons/mute.svg,sha256=6PpJfTd9oLHE41HYzMW0zJEJzgBnIyuWQll2RSR3Uvw,1173
+easyplayer/icons/flaticons/newList.svg,sha256=IrL6KVUg4Tu9uDBY1aI9wnswG5m19msU2Tshq3LQrlU,2042
+easyplayer/icons/flaticons/open.svg,sha256=wFDiNrdxrZVlxDejs8S4dEGzTh0AdzXLzawzMhusQnw,489
+easyplayer/icons/flaticons/pause.svg,sha256=SIY9O3JoO5y3Dkmaj2teBEGigxpL9QlZ7U7O4SXVPBo,284
+easyplayer/icons/flaticons/play.svg,sha256=ZaXvt3jzhdNolPgIn7435aarxN5Ia1ce3ffnGeA76ls,1436
+easyplayer/icons/flaticons/remove.svg,sha256=JN9-AZKB0y1xBrcGaLJJdQhGOYNVEFJuzBvcKG9qRfM,392
+easyplayer/icons/flaticons/remove_all.svg,sha256=N_lPesbUB3rdXqyOLzO3ME6CdHsjK8lzWx9sZ6HdpFc,914
+easyplayer/icons/flaticons/save.svg,sha256=E_R_tTY7xHB_qjxZmSC4VKlkR6xNeIg_NRMFXfBLCZ4,568
+easyplayer/icons/flaticons/screenshot.svg,sha256=ATe0zu_TQU-AGfQdK3lSRjBHNIbKxEuS9bs4zD0wtMA,665
+easyplayer/icons/flaticons/settings.svg,sha256=BTUgJIvi7IfU66wyrKFHqOqgLN9U2qcIIr4rOR8YpU0,1295
+easyplayer/icons/flaticons/sound.svg,sha256=ZhNuqhhNjDSS-LIbt7yz0omYLrLkvskMvTsrQsDHLnU,933
+easyplayer/icons/flaticons/splitVertical.svg,sha256=MWg9Ct8qjfTet8xOF35EdD2-TK4kZ8WSodgzFn3ohoI,185
+easyplayer/icons/flaticons/start-cut.svg,sha256=ie7tyS1kPcY4mLMUi5T3Ir-SDvGx7h-CAH63bRCRyZE,1699
+easyplayer/icons/flaticons/stop-cut.svg,sha256=9s0e092Ze-rrFZYZozG5_X52CrR7PHUpQJTloMenbDA,1743
+easyplayer/lib/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+easyplayer/lib/mpv.py,sha256=wFtV_MqGWUhugBsytwAI1HIZ_6gxgaNdsmh24Y-Jzk8,92910
+easympv-1.4.0.dist-info/METADATA,sha256=8EBnSGLzh2T7iuEPUNZWKwLA1OUxsglwJD8E-lXTvSQ,5208
+easympv-1.4.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+easympv-1.4.0.dist-info/entry_points.txt,sha256=tPTwnbnXIayz9RFCwJEB_uMvaSS0TGEloi1EG8eFtpk,58
+easympv-1.4.0.dist-info/top_level.txt,sha256=YjFIl5m-ptoifGAMVIDXX1XpNQtYfGZf4EpsiPhBWto,11
+easympv-1.4.0.dist-info/RECORD,,

easympv-1.4.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

easympv-1.4.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+easyplayer = easyplayer.EasyPlayer:main

easympv-1.4.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+easyplayer

easyplayer/AudioPlay.py

@@ -0,0 +1,210 @@
+import subprocess
+from threading import Thread
+from PyQt6 import QtWidgets, QtCore, QtGui
+import FFMPEGTools
+
+Log = FFMPEGTools.Log
+
+try:
+    import numpy as np
+    HAS_SPECTRUM = True
+except ImportError:
+    HAS_SPECTRUM = False
+
+SPECTRUM_SAMPLE_RATE = 44100
+SPECTRUM_BLOCK_SIZE = 4096
+
+
+class ParecStream:
+    def __init__(self, device, samplerate, blocksize, callback):
+        self._proc = subprocess.Popen(
+            ['parec', f'--device={device}', '--format=float32le',
+             '--channels=1', f'--rate={samplerate}', '--latency-msec=20'],
+            stdout=subprocess.PIPE, stderr=subprocess.DEVNULL
+        )
+        self._blocksize = blocksize
+        self._callback = callback
+        self._stopped = False
+        self._thread = Thread(target=self._loop, daemon=True)
+
+    def start(self):
+        self._thread.start()
+
+    def stop(self):
+        self._stopped = True
+        self._proc.terminate()
+
+    def close(self):
+        try:
+            self._proc.wait(timeout=1)
+        except Exception:
+            pass
+        self._thread.join(timeout=1)
+
+    def _loop(self):
+        bytes_per_block = self._blocksize * 4
+        while not self._stopped:
+            data = self._proc.stdout.read(bytes_per_block)
+            if not data or len(data) < bytes_per_block:
+                break
+            if not self._stopped:
+                arr = np.frombuffer(data, dtype='float32').reshape(-1, 1)
+                self._callback(arr, self._blocksize, None, None)
+
+
+class SpectrumOverlay(QtWidgets.QWidget):
+    BAND_EDGES = [50, 100, 200, 400, 800, 1600, 3200, 6400, 12800, 14000, 14500, 15000, 16000]
+    BANDS = len(BAND_EDGES) - 1
+    BAR_COLORS = ["heat", "rainbow", "blue", "green", "magenta", "red"]
+
+    def __init__(self, parent):
+        super().__init__(parent)
+        self.setAttribute(QtCore.Qt.WidgetAttribute.WA_TransparentForMouseEvents, True)
+        from threading import Lock
+        self._mags = [0.0] * self.BANDS
+        self._lock = Lock()
+        self.mode = "heat"
+
+    def setMags(self, mags):
+        with self._lock:
+            self._mags = mags[:]
+        self.update()
+
+    def clearMags(self):
+        with self._lock:
+            self._mags = [0.0] * self.BANDS
+        self.update()
+
+    def paintEvent(self, __event):
+        with self._lock:
+            mags = self._mags[:]
+        mode = self.mode
+        painter = QtGui.QPainter(self)
+        painter.fillRect(self.rect(), QtGui.QColor(15, 15, 15))
+        w, h = self.width(), self.height()
+        bar_w = w // self.BANDS
+        gap = max(2, bar_w // 8)
+        for i, level in enumerate(mags):
+            bar_h = max(2, int(level * 0.9 * (h - 4)))
+            x = i * bar_w + gap
+            y = h - bar_h - 2
+            if mode == "red":
+                r = min(255, int(level * 2 * 255))
+                g = min(255, int((1.0 - level) * 2 * 255))
+                b = 0
+                color = QtGui.QColor(r, g, b)
+            elif mode == "magenta":
+                r = min(255, int(level * 2 * 255))
+                g = min(255, int((1.0 - level) * 2 * 255))
+                b = min(255, max(0, int((level * 2 - 1) * 255)))
+                color = QtGui.QColor(r, g, b)
+            elif mode == "blue":
+                r = 0
+                g = min(255, int((1.0 - level) * 2 * 255))
+                b = min(255, int(level * 2 * 255))
+                color = QtGui.QColor(r, g, b)
+            elif mode == "rainbow":
+                hue = int(i / SpectrumOverlay.BANDS * 300)
+                color = QtGui.QColor.fromHsv(hue, 220, max(30, int(level * 255)))
+            elif mode == "heat":
+                hue = int((1.0 - level) * 240)
+                color = QtGui.QColor.fromHsv(hue, 255, max(80, int(level * 255)))
+            else:  # green
+                r = int((1.0 - level) * 255)
+                g = int((1.0 - level * 0.6) * 255)
+                b = 0
+                color = QtGui.QColor(r, g, b)
+            painter.fillRect(x, y, bar_w - gap * 2, bar_h, color)
+        painter.end()
+
+
+class SpectrumController(QtCore.QObject):
+    def __init__(self, player):
+        super().__init__()
+        self._player = player
+        self._specStream = None
+        self._overlay = SpectrumOverlay(player)
+        self._overlay.hide()
+
+    @property
+    def overlay(self):
+        return self._overlay
+
+    def setGeometry(self, x, y, w, h):
+        self._overlay.setGeometry(x, y, w, h)
+
+    def setMode(self, mode):
+        self._overlay.mode = mode
+
+    def getMode(self):
+        return self._overlay.mode
+
+    def startCapture(self):
+        if not HAS_SPECTRUM or self._specStream is not None:
+            return
+        try:
+            device = self._findMonitorDevice()
+            if not device:
+                Log.warning("Spectrum capture failed - no monitor device found")
+                return
+            self._specStream = ParecStream(
+                device,
+                SPECTRUM_SAMPLE_RATE,
+                SPECTRUM_BLOCK_SIZE,
+                self._audioCallback
+            )
+            self._specStream.start()
+            self._overlay.show()
+        except Exception:
+            Log.warning("Spectrum capture failed - no valid device found")
+
+    def stopCapture(self):
+        if self._specStream:
+            try:
+                self._specStream.stop()
+                self._specStream.close()
+            except Exception:
+                pass
+            self._specStream = None
+        self._overlay.hide()
+        self._overlay.clearMags()
+
+    def _findMonitorDevice(self):
+        try:
+            result = subprocess.run(['pactl', 'get-default-sink'], capture_output=True, text=True, timeout=2)
+            if result.returncode == 0:
+                monitor = result.stdout.strip() + '.monitor'
+                Log.info("Spectrum: using parec with monitor source %s", monitor)
+                return monitor
+        except Exception:
+            pass
+        Log.info("Spectrum: no monitor device found")
+        return None
+
+    def _audioCallback(self, indata, __frames, __time, __status):
+        data = indata[:, 0]
+        windowed = data * np.hanning(len(data))
+        fft_data = np.abs(np.fft.rfft(windowed))
+        freqs = np.fft.rfftfreq(len(data), 1.0 / SPECTRUM_SAMPLE_RATE)
+        DB_FLOOR = -100.0
+        reference = SPECTRUM_BLOCK_SIZE / 15.0
+        new_mags = []
+        for i in range(SpectrumOverlay.BANDS):
+            mask = (freqs >= SpectrumOverlay.BAND_EDGES[i]) & (freqs < SpectrumOverlay.BAND_EDGES[i + 1])
+            if mask.any():
+                val = float(np.max(fft_data[mask])) / reference
+                db = 20.0 * np.log10(val) if val > 0 else DB_FLOOR
+                if i >= SpectrumOverlay.BANDS - 4:
+                    db += 6.0
+                new_mags.append(max(0.0, min(1.0, (db - DB_FLOOR) / -DB_FLOOR)))
+            else:
+                new_mags.append(0.0)
+        with self._overlay._lock:
+            riseFactor = 0.5
+            decayFactor = 0.9
+            for i in range(SpectrumOverlay.BANDS):
+                if new_mags[i] > self._overlay._mags[i]:
+                    self._overlay._mags[i] += riseFactor * (new_mags[i] - self._overlay._mags[i])
+                else:
+                    self._overlay._mags[i] *= decayFactor
+        self._overlay.update()