feat(updater): implement auto-update system with GitHub Releases integration

- Add comprehensive auto-update functionality using GitHub Releases
- Include update checking on app start and manual check option
- Implement update download, extraction, and installation process
- Add version comparison and skip version functionality
- Create update dialog UI with update options
- Add translation support for update related strings
- Update version management and changelog documentation

Author: SPluzh

CHANGELOG.md

@@ -2,6 +2,9 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.3.0]
+- **Auto-Update**: Implemented a comprehensive auto-update system using GitHub Releases
+
 ## [1.2.7]
 - **Availability Tracking**: Implemented smart file availability tracking:
     - **Scanner**: Updated scan logic to mark missing videos/folders as unavailable instead of removing them.

config_manager.py

@@ -18,6 +18,8 @@ class ConfigManager:
         'General': {
             'language': 'en',
             'show_preview_popup': 'True',
+            'check_updates_on_start': 'True',
+            'skip_version': '',
         },
         'Paths': {
             'paths': '',
@@ -132,6 +134,30 @@ def get_selected_tag_ids(self) -> set:
                 return set()
         return set()
 
+    # --- Update settings ---
+
+    def get_check_updates_on_start(self) -> bool:
+        config = self._read_config()
+        return config.getboolean('General', 'check_updates_on_start', fallback=True)
+
+    def set_check_updates_on_start(self, value: bool):
+        config = self._read_config()
+        if 'General' not in config:
+            config['General'] = {}
+        config['General']['check_updates_on_start'] = str(value)
+        self._write_config(config)
+
+    def get_skip_version(self) -> str:
+        config = self._read_config()
+        return config.get('General', 'skip_version', fallback='')
+
+    def set_skip_version(self, version: str):
+        config = self._read_config()
+        if 'General' not in config:
+            config['General'] = {}
+        config['General']['skip_version'] = version
+        self._write_config(config)
+
     # --- Path settings ---
 
     def get_library_paths(self) -> str:

main.py

@@ -231,6 +231,12 @@ def __init__(self):
         if hasattr(self, 'tag_filter_active'):
             self.tag_filter_btn.setChecked(self.tag_filter_active)
 
+        # Auto-update cleanup and check
+        from update_app import cleanup_update_artifacts
+        cleanup_update_artifacts()
+        if self.config.get_check_updates_on_start():
+            QTimer.singleShot(5000, self._check_for_update)
+
     def keyPressEvent(self, event: QKeyEvent):
         action = self.hotkey_manager.get_action(event)
 
@@ -623,9 +629,14 @@ def create_menu_bar(self):
         reload_styles_action.triggered.connect(self.reload_styles)
         view_menu.addAction(reload_styles_action)
 
-        # [Help] Menu
         help_menu = menubar.addMenu(tr('menu.help'))
 
+        check_updates_action = QAction(self.icons.get('upload', QIcon()), tr('menu.check_updates'), self)
+        check_updates_action.triggered.connect(lambda: self._check_for_update(force=True))
+        help_menu.addAction(check_updates_action)
+
+        help_menu.addSeparator()
+
         about_action = QAction(self.icons.get('menu_about', QIcon()), tr('menu.about'), self)
         about_action.triggered.connect(self.show_about)
         help_menu.addAction(about_action)
@@ -692,6 +703,76 @@ def show_about(self):
         dialog = AboutDialog(self)
         dialog.exec()
 
+    def _check_for_update(self, force=False):
+        """Check for app updates. If force=True, always show result."""
+        try:
+            from update_app import check_for_update, get_current_version
+            update_info = check_for_update()
+
+            if update_info:
+                # Skip if user chose to skip this version (unless forced)
+                if not force:
+                    skip = self.config.get_skip_version()
+                    if skip and skip == update_info['latest']:
+                        return
+
+                from update_dialog import UpdateDialog
+                dialog = UpdateDialog(self, update_info)
+                dialog.exec()
+
+                if dialog.result_action == UpdateDialog.UPDATE_NOW:
+                    self._do_app_update(update_info)
+                elif dialog.result_action == UpdateDialog.SKIP_VERSION:
+                    self.config.set_skip_version(update_info['latest'])
+            elif force:
+                current = get_current_version()
+                QMessageBox.information(
+                    self,
+                    tr('updater.title'),
+                    tr('updater.no_updates', version=current)
+                )
+        except Exception as e:
+            if force:
+                QMessageBox.warning(
+                    self,
+                    tr('updater.title'),
+                    tr('updater.error', error=str(e))
+                )
+
+    def _do_app_update(self, update_info: dict):
+        """Download update and launch updater script."""
+        try:
+            from update_app import download_update, create_updater_script, launch_updater_and_exit
+
+            self.info_label.setText(tr('updater.downloading'))
+            QApplication.processEvents()
+
+            # Download
+            zip_path = download_update(update_info['url'])
+
+            self.info_label.setText(tr('updater.extracting'))
+            QApplication.processEvents()
+
+            # Create bat script
+            bat_path = create_updater_script(zip_path, update_info['latest'])
+
+            self.info_label.setText(tr('updater.success'))
+            QApplication.processEvents()
+
+            # Save state before exit
+            self.save_window_state()
+
+            # Launch updater and quit
+            launch_updater_and_exit(bat_path)
+            QApplication.quit()
+
+        except Exception as e:
+            QMessageBox.critical(
+                self,
+                tr('updater.title'),
+                tr('updater.error', error=str(e))
+            )
+
     def save_progress(self, position_sec, file_path):
         """Save playback progress."""
         # logging.debug(f"save_progress called for {file_path}")

resources/translations/en.json

@@ -19,7 +19,8 @@
         "screenshot": "Take Screenshot",
         "frame_step": "Next Frame",
         "frame_back": "Previous Frame",
-        "show_markers": "Show Bookmarks"
+        "show_markers": "Show Bookmarks",
+        "check_updates": "Check for Updates..."
     },
     "library": {
         "search_placeholder": "Search...",
@@ -131,7 +132,8 @@
             "deess_tooltip": "De-esser",
             "mono": "Mono",
             "mono_tooltip": "Mono Mode"
-        }
+        },
+        "filter_tags": "Filter by tags"
     },
     "status": {
         "ready": "Ready",
@@ -260,6 +262,7 @@
         "scan_existing_videos": "   • Videos: {count}",
         "scan_searching": "🔍 Searching for video courses...",
         "scan_found_folders": "   Found folders: {count} ({time} sec)",
+        "availability_check": "🔍 Checking availability...",
         "process_title": "PROCESSING VIDEO COURSES",
         "process_progress": "[{current}/{total}] ({percent}%) {name}...",
         "process_info": "   {info}",
@@ -355,5 +358,22 @@
         "watched_time": "Watched",
         "progress": "Progress",
         "subtitle": "Total videos: {total}"
+    },
+    "updater": {
+        "title": "Application Update",
+        "checking": "Checking for updates...",
+        "available": "New version available: {version}",
+        "current_version": "Current version: {version}",
+        "new_version": "New version: {version}",
+        "changelog": "What's new:",
+        "update_now": "Update and Restart",
+        "later": "Later",
+        "skip_version": "Skip this version",
+        "downloading": "Downloading update...",
+        "extracting": "Installing update...",
+        "success": "Update downloaded. Application restarting...",
+        "no_updates": "You have the latest version ({version})",
+        "error": "Update error: {error}",
+        "check_updates_auto": "Check for updates on startup"
     }
 }

resources/translations/ru.json

@@ -19,7 +19,8 @@
         "screenshot": "Сделать скриншот",
         "frame_step": "Следующий кадр",
         "frame_back": "Предыдущий кадр",
-        "show_markers": "Показать закладки"
+        "show_markers": "Показать закладки",
+        "check_updates": "Проверить обновления..."
     },
     "library": {
         "search_placeholder": "Поиск...",
@@ -131,7 +132,8 @@
             "deess_tooltip": "Де-эссер",
             "mono": "Моно",
             "mono_tooltip": "Моно режим"
-        }
+        },
+        "filter_tags": "Фильтр по тегам"
     },
     "status": {
         "error": "Ошибка",
@@ -260,6 +262,7 @@
         "scan_existing_videos": "   • Видео: {count}",
         "scan_searching": "🔍 Поиск видеокурсов...",
         "scan_found_folders": "   Найдено папок: {count} ({time} сек)",
+        "availability_check": "🔍 Проверка доступности...",
         "process_title": "ОБРАБОТКА ВИДЕОКУРСОВ",
         "process_progress": "[{current}/{total}] ({percent}%) {name}...",
         "process_info": "   {info}",
@@ -355,5 +358,22 @@
         "watched_time": "Просмотрено",
         "progress": "Прогресс",
         "subtitle": "Всего видео: {total}"
+    },
+    "updater": {
+        "title": "Обновление приложения",
+        "checking": "Проверка обновлений...",
+        "available": "Доступна новая версия: {version}",
+        "current_version": "Текущая версия: {version}",
+        "new_version": "Новая версия: {version}",
+        "changelog": "Что нового:",
+        "update_now": "Обновить и перезапустить",
+        "later": "Позже",
+        "skip_version": "Пропустить эту версию",
+        "downloading": "Загрузка обновления...",
+        "extracting": "Установка обновления...",
+        "success": "Обновление загружено. Приложение перезапускается...",
+        "no_updates": "У вас установлена последняя версия ({version})",
+        "error": "Ошибка обновления: {error}",
+        "check_updates_auto": "Проверять обновления при запуске"
     }
 }

resources/version.txt

@@ -1 +1 @@
-1.2.7
+1.3.0

settings_dialog.py

@@ -8,7 +8,7 @@
 from PyQt6.QtWidgets import (
     QDialog, QVBoxLayout, QGroupBox, QTreeWidget, QTreeWidgetItem, QPushButton,
     QHBoxLayout, QFileDialog, QStyle, QMessageBox, QLabel, QProgressBar, QTextEdit,
-    QFrame
+    QFrame, QCheckBox
 )
 from PyQt6.QtCore import Qt, QTimer, pyqtSignal, QThread
 from PyQt6.QtGui import QTextCursor, QIcon
@@ -91,8 +91,17 @@ def setup_ui(self):
         self.ffmpeg_btn = QPushButton(tr('settings.ffmpeg_checking'))
         self.ffmpeg_btn.clicked.connect(self.update_ffmpeg)
         deps_layout.addWidget(self.ffmpeg_btn)
+
+        self.app_update_btn = QPushButton(tr('updater.checking'))
+        self.app_update_btn.clicked.connect(self.update_app)
+        deps_layout.addWidget(self.app_update_btn)
 
         deps_layout.addStretch()
+
+        self.auto_update_chk = QCheckBox(tr('updater.check_updates_auto'))
+        self.auto_update_chk.setChecked(True)
+        deps_layout.addWidget(self.auto_update_chk)
+
         deps_group.setLayout(deps_layout)
 
         storage_group = QGroupBox(tr('settings.storage_group'))
@@ -117,6 +126,7 @@ def setup_ui(self):
 
         QTimer.singleShot(100, self.check_libmpv_version)
         QTimer.singleShot(200, self.check_ffmpeg_version)
+        QTimer.singleShot(300, self.check_app_version)
 
         save_btn = QPushButton(tr('settings.save'))
         save_btn.setIcon(self.icons.get('save', QIcon()))
@@ -243,6 +253,8 @@ def load_current_settings(self):
                     self.pathslist.addTopLevelItem(item)
                     self._validate_path(item)
 
+        self.auto_update_chk.setChecked(self.config.get_check_updates_on_start())
+
     def _validate_path(self, item):
         path = item.text(0)
         if os.path.exists(path):
@@ -266,6 +278,7 @@ def save_settings(self):
 
         self.config.set_library_paths(paths)
         self.config.set_excluded_library_paths(excluded_paths)
+        self.config.set_check_updates_on_start(self.auto_update_chk.isChecked())
 
         self.accept()
 
@@ -406,3 +419,34 @@ def do_update():
         dialog.exec()
 
         self.check_ffmpeg_version()
+
+    def check_app_version(self):
+        """Check if a newer app version is available on GitHub."""
+        try:
+            from update_app import get_current_version, get_latest_release, compare_versions
+            current = get_current_version()
+            release = get_latest_release()
+
+            if release:
+                latest = release['tag'].lstrip('v')
+                if compare_versions(current, latest):
+                    self.app_update_btn.setText(f" SP Video Courses Player ({current} → {latest})")
+                    self.app_update_btn.setIcon(self.icons.get('upload', QIcon()))
+                    self.app_update_btn.setToolTip(tr('updater.available', version=latest))
+                else:
+                    self.app_update_btn.setText(f" SP Video Courses Player ({current})")
+                    self.app_update_btn.setIcon(self.icons.get('check', QIcon()))
+                    self.app_update_btn.setToolTip(tr('updater.no_updates', version=current))
+            else:
+                self.app_update_btn.setText(f" SP Video Courses Player ({current})")
+                self.app_update_btn.setIcon(self.icons.get('check', QIcon()))
+                self.app_update_btn.setToolTip(tr('updater.no_updates', version=current))
+        except Exception as e:
+            self.app_update_btn.setText(" SP Video Courses Player")
+            self.app_update_btn.setIcon(self.icons.get('fail', QIcon()))
+            self.app_update_btn.setToolTip(str(e))
+
+    def update_app(self):
+        """Trigger app update via parent window."""
+        if self.parent() and hasattr(self.parent(), '_check_for_update'):
+            self.parent()._check_for_update(force=True)