From 889ba4af2b7fe4c358e427ad616f761c89398ee7 Mon Sep 17 00:00:00 2001
From: Boris Yumankulov <boria138@altlinux.org>
Date: Wed, 16 Jul 2025 11:10:31 +0500
Subject: [PATCH] feat: added sound effects support to themes

Signed-off-by: Boris Yumankulov <boria138@altlinux.org>
---
 documentation/theme_guide/README.md          | 25 ++++++-
 documentation/theme_guide/README.ru.md       | 27 +++++++-
 portprotonqt/main_window.py                  | 17 ++++-
 portprotonqt/theme_manager.py                | 68 +++++++++++++++++++-
 portprotonqt/themes/standart-light/styles.py |  6 ++
 portprotonqt/themes/standart/styles.py       |  6 ++
 6 files changed, 143 insertions(+), 6 deletions(-)

diff --git a/documentation/theme_guide/README.md b/documentation/theme_guide/README.md
index d29dca5..e8960b2 100644
--- a/documentation/theme_guide/README.md
+++ b/documentation/theme_guide/README.md
@@ -9,12 +9,13 @@
 - [Metadata](#metadata)
 - [Screenshots](#screenshots)
 - [Fonts and Icons](#fonts-and-icons)
+- [Sound Effects](#sound-effects)
 
 ---
 
 ## 📖 Overview
 
-Themes in `PortProtonQT` allow customizing the UI appearance. Themes are stored under:
+Themes in `PortProtonQT` allow customizing the UI appearance and sounds. Themes are stored under:
 
 - `~/.local/share/PortProtonQT/themes`.
 
@@ -34,6 +35,12 @@ Create a `styles.py` in the theme root. It should define variables or functions
 
 **Example:**
 ```python
+# Sound effects mapping
+SOUNDS = {
+    "app_start": "app_start.wav",           # Application startup
+    "app_exit": "app_exit.wav",             # Application exit
+}
+
 def custom_button_style(color1, color2):
     return f"""
     QPushButton {{
@@ -69,3 +76,19 @@ Folder: `images/screenshots/` — place UI screenshots there.
 - Icons: `images/icons/*.svg/.png`
 
 ---
+
+## 🔊 Sound Effects (optional)
+
+Folder: `sounds/` — place interface sound effects here.
+
+Supported formats:
+- `.wav` - Wave audio files
+
+Available sound events:
+- Interface sounds:
+  - `app_start.wav` - Application startup
+  - `app_exit.wav` - Application exit
+
+If a sound file is missing in a custom theme, the default sound from the standard theme will be used.
+
+---
diff --git a/documentation/theme_guide/README.ru.md b/documentation/theme_guide/README.ru.md
index 1b59e61..7f0a2ff 100644
--- a/documentation/theme_guide/README.ru.md
+++ b/documentation/theme_guide/README.ru.md
@@ -9,12 +9,13 @@
 - [Метаинформация](#метаинформация)
 - [Скриншоты](#скриншоты)
 - [Шрифты и иконки](#шрифты-и-иконки)
+- [Звуковые эффекты](#звуковые-эффекты)
 
 ---
 
 ## 📖 Обзор
 
-Темы в `PortProtonQT` позволяют изменить внешний вид интерфейса. Все темы хранятся в папке:
+Темы в `PortProtonQT` позволяют изменить внешний вид интерфейса и звуковое оформление. Все темы хранятся в папке:
 
 - `~/.local/share/PortProtonQT/themes`.
 
@@ -32,8 +33,14 @@ mkdir -p ~/.local/share/PortProtonQT/themes/my_custom_theme
 
 Создайте `styles.py` в корне темы. В нём определите переменные и/или функции, возвращающие CSS-оформление.
 
-**Пример функции:**
+**Пример:**
 ```python
+# Карта звуковых эффектов
+SOUNDS = {
+    "app_start": "app_start.wav",           # Запуск приложения
+    "app_exit": "app_exit.wav",             # Закрытие приложения
+}
+
 def custom_button_style(color1, color2):
     return f"""
     QPushButton {{
@@ -69,3 +76,19 @@ description = Описание вашей темы.
 - Иконки: `images/icons/*.svg/.png`
 
 ---
+
+## 🔊 Звуковые эффекты (опционально)
+
+Папка: `sounds/` — звуковые эффекты интерфейса.
+
+Поддерживаемые форматы:
+- `.wav` - Wave аудио файлы
+
+Доступные звуковые события:
+- Звуки интерфейса:
+  - `app_start.wav` - Запуск приложения
+  - `app_exit.wav` - Закрытие приложения
+
+Если звуковой файл отсутствует в пользовательской теме, будет использован звук из стандартной темы.
+
+---
diff --git a/portprotonqt/main_window.py b/portprotonqt/main_window.py
index 9c52662..2f09582 100644
--- a/portprotonqt/main_window.py
+++ b/portprotonqt/main_window.py
@@ -220,6 +220,13 @@ class MainWindow(QMainWindow):
                 self.resize(width, height)
             else:
                 self.showNormal()
+
+        self._startup_sound = self.theme_manager.get_sound(default_styles.SOUNDS["app_start"])
+        self._exit_sound = self.theme_manager.get_sound(default_styles.SOUNDS["app_exit"])
+
+        if self._startup_sound:
+            self._startup_sound.play()
+
     @Slot(list)
     def on_games_loaded(self, games: list[tuple]):
         self.games = games
@@ -2253,5 +2260,11 @@ class MainWindow(QMainWindow):
             self.checkProcessTimer.deleteLater()
             self.checkProcessTimer = None
 
-        QApplication.quit()
-        event.accept()
+        # Воспроизводим звук закрытия
+        if self._exit_sound:
+            self._exit_sound.play()
+            # Небольшая задержка перед закрытием, чтобы звук успел проиграться
+            QTimer.singleShot(100, lambda: event.accept())
+            event.ignore()
+        else:
+            event.accept()
diff --git a/portprotonqt/theme_manager.py b/portprotonqt/theme_manager.py
index 428b069..dbd6144 100644
--- a/portprotonqt/theme_manager.py
+++ b/portprotonqt/theme_manager.py
@@ -3,6 +3,8 @@ import os
 from portprotonqt.logger import get_logger
 from PySide6.QtSvg import QSvgRenderer
 from PySide6.QtGui import QIcon, QColor, QFontDatabase, QPixmap, QPainter
+from PySide6.QtCore import QUrl
+from PySide6.QtMultimedia import QSoundEffect
 
 from portprotonqt.config_utils import save_theme_to_config, load_theme_metainfo
 
@@ -226,7 +228,7 @@ class ThemeManager:
 
         # Если иконка всё равно не найдена
         if not icon_path or not os.path.exists(icon_path):
-            logger.error(f"Предупреждение: иконка '{icon_name}' не найдена")
+            logger.warning(f"icon '{icon_name}' not found")
             return QIcon() if not as_path else None
 
         if as_path:
@@ -284,3 +286,67 @@ class ThemeManager:
                         break
 
         return image_path
+
+    def get_sound(self, sound_name, theme_name=None):
+        """
+        Возвращает QSoundEffect для звука из папки sounds текущей темы.
+        Если не найден, проверяет стандартную тему.
+        Поддерживает форматы .wav
+
+        :param sound_name: Имя звукового файла (с расширением или без)
+        :param theme_name: Имя темы (опционально)
+        :return: QSoundEffect объект или None если звук не найден
+        """
+        sound_path = None
+        theme_name = theme_name or self.current_theme_name
+        supported_extensions = ['.wav']
+
+        has_extension = any(sound_name.lower().endswith(ext) for ext in supported_extensions)
+        base_name = sound_name if has_extension else sound_name
+
+        # Поиск звука в папке текущей темы
+        for themes_dir in THEMES_DIRS:
+            theme_folder = os.path.join(str(themes_dir), str(theme_name))
+            sounds_folder = os.path.join(theme_folder, "sounds")
+
+            # Если передано имя с расширением, проверяем только этот файл
+            if has_extension:
+                candidate = os.path.join(sounds_folder, str(base_name))
+                if os.path.exists(candidate):
+                    sound_path = candidate
+                    break
+            else:
+                # Проверяем все поддерживаемые расширения
+                for ext in supported_extensions:
+                    candidate = os.path.join(sounds_folder, str(base_name) + str(ext))
+                    if os.path.exists(candidate):
+                        sound_path = candidate
+                        break
+                if sound_path:
+                    break
+
+        # Если не нашли – используем стандартную тему
+        if not sound_path:
+            base_dir = os.path.dirname(os.path.abspath(__file__))
+            standard_sounds_folder = os.path.join(base_dir, "themes", "standart", "sounds")
+
+            # Аналогично проверяем в стандартной теме
+            if has_extension:
+                sound_path = os.path.join(standard_sounds_folder, base_name)
+                if not os.path.exists(sound_path):
+                    sound_path = None
+            else:
+                for ext in supported_extensions:
+                    candidate = os.path.join(standard_sounds_folder, base_name + ext)
+                    if os.path.exists(candidate):
+                        sound_path = candidate
+                        break
+
+        # Если звук всё равно не найден
+        if not sound_path or not os.path.exists(sound_path):
+            logger.warning(f"Sound '{sound_name}' not found")
+            return None
+
+        sound = QSoundEffect()
+        sound.setSource(QUrl.fromLocalFile(sound_path))
+        return sound
diff --git a/portprotonqt/themes/standart-light/styles.py b/portprotonqt/themes/standart-light/styles.py
index 7d3c378..e6fcb35 100644
--- a/portprotonqt/themes/standart-light/styles.py
+++ b/portprotonqt/themes/standart-light/styles.py
@@ -8,6 +8,12 @@ current_theme_name = read_theme_from_config()
 favoriteLabelSize = 48, 48
 pixmapsScaledSize = 60, 60
 
+# ЗВУКОВЫЕ ЭФФЕКТЫ
+SOUNDS = {
+    "app_start": "app_start.wav",           # Запуск приложения
+    "app_exit": "app_exit.wav",             # Закрытие приложения
+}
+
 GAME_CARD_ANIMATION = {
     # Ширина обводки карточки в состоянии покоя (без наведения или фокуса).
     # Влияет на толщину рамки вокруг карточки, когда она не выделена.
diff --git a/portprotonqt/themes/standart/styles.py b/portprotonqt/themes/standart/styles.py
index 529e89f..622fe5f 100644
--- a/portprotonqt/themes/standart/styles.py
+++ b/portprotonqt/themes/standart/styles.py
@@ -8,6 +8,12 @@ current_theme_name = read_theme_from_config()
 favoriteLabelSize = 48, 48
 pixmapsScaledSize = 60, 60
 
+# ЗВУКОВЫЕ ЭФФЕКТЫ
+SOUNDS = {
+    "app_start": "app_start.wav",           # Запуск приложения
+    "app_exit": "app_exit.wav",             # Закрытие приложения
+}
+
 # VARS
 font_family = "Play"
 font_size_a = "16px"