feat: rilis v1.3.0 — popup tutup (tray/keluar), tampilan modern ringan, salin report, ingat ukuran jendela

- closeEvent: dialog 'Sembunyikan ke tray / Keluar / Batal' + 'Ingat pilihan ini'
  (tersimpan sebagai close_action; tombol sembunyikan dinonaktifkan bila tray tidak tersedia)
- QSS tema gelap modern: kartu membulat, tombol utama beraksen, kontrol bergaya; tanpa aset/efek berat
- tombol 'Salin report' (hex ke papan klip) untuk laporan bug
- ukuran & posisi jendela diingat (config geometry)
- perbaikan: dialog tutup tidak muncul saat keluar otomatis (--selftest), tunggu tugas latar saat keluar
- suite uji: 13 langkah, semua lolos di bundel beku

.github/FUNDING.yml

@@ -0,0 +1,2 @@
+# Shows the ❤ Sponsor button in the repository header.
+custom: ["https://donasi.oxpoe.qzz.io/"]

.github/ISSUE_TEMPLATE/hardware-report.yml

@@ -0,0 +1,57 @@
+name: Hardware report
+description: Report a GAMEMAX (or other) LCD cooler that works, partly works, or does not work
+title: "[hardware] <cooler model>"
+labels: ["hardware"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for testing on your hardware! Reports from other panel revisions are how
+        this project grows. Please fill in what you can.
+  - type: input
+    id: cooler
+    attributes:
+      label: Cooler / panel model
+      placeholder: e.g. GAMEMAX IceBurg 360 Digital WH
+    validations:
+      required: true
+  - type: input
+    id: usb
+    attributes:
+      label: USB identity (lsusb)
+      description: "`lsusb -d 5131:2007` — paste the line, or the VID:PID if it differs"
+    validations:
+      required: true
+  - type: dropdown
+    id: result
+    attributes:
+      label: Result
+      options:
+        - Works fully (values correct on the panel)
+        - Partly works (which fields are wrong?)
+        - Panel lights up but shows wrong layout
+        - Not detected / no reaction
+    validations:
+      required: true
+  - type: textarea
+    id: report
+    attributes:
+      label: Output of `python3 src/gamemax_report.py --dry-run`
+      description: This writes nothing to the device, it only prints the report it would send.
+      render: text
+    validations:
+      required: false
+  - type: input
+    id: system
+    attributes:
+      label: System
+      placeholder: distro · kernel · desktop session · motherboard super-I/O (e.g. nct6798)
+    validations:
+      required: false
+  - type: textarea
+    id: notes
+    attributes:
+      label: Notes
+      description: Which fan channel / temperature source you had to pick, anything unexpected.
+    validations:
+      required: false

.github/workflows/release.yml

@@ -21,7 +21,7 @@ jobs:
         run: |
           sudo apt-get update
           sudo apt-get install -y --no-install-recommends \
-            libgl1 libegl1 libxkbcommon0 libdbus-1-3 libfuse2 fuse
+            libgl1 libegl1 libxkbcommon0 libdbus-1-3 libfuse2 fuse zsync
 
       - name: Set up uv
         uses: astral-sh/setup-uv@v5
@@ -29,6 +29,7 @@ jobs:
       - name: Build AppImage
         env:
           APPIMAGE_EXTRACT_AND_RUN: "1"
+          UPDATE_INFO_URL: https://github.com/${{ github.repository }}/releases/download/${{ github.ref_name }}/GAMEMAX-LCD-x86_64.AppImage.zsync
         run: bash packaging/build_appimage.sh
 
       - name: Smoke test the bundle (no display)
@@ -38,6 +39,15 @@ jobs:
         run: |
           ./dist/GAMEMAX-LCD-x86_64.AppImage --selftest
 
+      - name: Checksum and zsync metadata
+        run: |
+          cd dist
+          sha256sum GAMEMAX-LCD-x86_64.AppImage > GAMEMAX-LCD-x86_64.AppImage.sha256
+          zsyncmake -u "https://github.com/${{ github.repository }}/releases/download/${{ github.ref_name }}/GAMEMAX-LCD-x86_64.AppImage" \
+            -o GAMEMAX-LCD-x86_64.AppImage.zsync GAMEMAX-LCD-x86_64.AppImage
+          cat GAMEMAX-LCD-x86_64.AppImage.sha256
+          ls -l
+
       - name: Publish release
         uses: softprops/action-gh-release@v2
         with:
@@ -58,5 +68,12 @@ jobs:
             Device access still needs the udev rule once:
             `sudo cp packaging/70-gamemax.rules /etc/udev/rules.d/ && sudo udevadm control --reload`
 
+            **Integrity:** verify the download with the published SHA-256, or use
+            `appimageupdatetool`/AppImageUpdate with the `.zsync` asset for delta updates.
+            The built-in updater (v1.2.3+) also verifies that checksum before replacing itself.
+
             Independent project, not affiliated with the vendor — see DISCLAIMER.md.
-          files: dist/GAMEMAX-LCD-x86_64.AppImage
+          files: |
+            dist/GAMEMAX-LCD-x86_64.AppImage
+            dist/GAMEMAX-LCD-x86_64.AppImage.sha256
+            dist/GAMEMAX-LCD-x86_64.AppImage.zsync

CONTRIBUTING.md

@@ -0,0 +1,33 @@
+# Contributing
+
+Thanks for helping — the most valuable contribution is **hardware reports**: which cooler
+works, which firmware revision differs, which sensor channel has to be picked. Use the
+*Hardware report* issue template, or send a pull request.
+
+## Before opening a pull request
+
+The sender must stay dependency-free (standard library only) and must never write to the
+device unless the user asked for it.
+
+```bash
+# nothing is written to the panel:
+python3 src/gamemax_report.py --dry-run
+python3 src/gamemax_report.py --list-sensors
+
+# the tray app self-checks without a display, and can exercise every action:
+uv run --with pyside6 python src/gamemax_gui.py --selftest
+uv run --with pyside6 python src/gamemax_gui.py --selftest-actions
+
+# build the AppImage (needs uv + network on first run):
+bash packaging/build_appimage.sh
+```
+
+`--selftest-actions` really does start/stop the service and toggle autostart, then leaves
+the service running — expected.
+
+## Style
+
+- Python 3.10+, no new dependencies, comments only where the code cannot explain itself.
+- GUI strings are Indonesian (the original author's language); code and docs are English.
+- Keep the protocol knowledge in `docs/reverse-engineering.md` and the README table in sync
+  when you learn something new about the panel.

README.md

@@ -8,7 +8,22 @@ Reverse engineered independently from the Windows vendor software
 [`docs/reverse-engineering.md`](docs/reverse-engineering.md) (Indonesian).
 
 [![Release](https://img.shields.io/github/v/release/oxpoe/Gamemax-linux-apps?color=def750&label=release)](https://github.com/oxpoe/Gamemax-linux-apps/releases)
+[![Release build](https://github.com/oxpoe/Gamemax-linux-apps/actions/workflows/release.yml/badge.svg)](https://github.com/oxpoe/Gamemax-linux-apps/actions/workflows/release.yml)
 [![License: MIT](https://img.shields.io/badge/license-MIT-def750)](LICENSE)
+[![Platform: Linux](https://img.shields.io/badge/platform-Linux-def750)](#compatibility)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-def750)](src/gamemax_report.py)
+[![Dependencies: none](https://img.shields.io/badge/sender_dependencies-none-def750)](src/gamemax_report.py)
+[![Donate](https://img.shields.io/badge/%E2%9D%A4-donate-def750)](https://donasi.oxpoe.qzz.io/)
+
+```text
+ hwmon · /proc/stat · cpufreq · meminfo · statvfs
+                    │
+                    ▼
+        gamemax_report.py  ──►  65-byte HID report  ──►  LCD panel
+          (stdlib only)          hidraw, 5131:2007
+                    ▲
+        gamemax_gui.py (tray)  ──►  systemd user unit + udev rule
+```
 
 Author: **oxpoe** · License: **MIT** · Independent project, **not affiliated with the
 vendor** — please read [DISCLAIMER.md](DISCLAIMER.md) before using it.
@@ -90,6 +105,7 @@ temperature source (Tctl vs Tccd).
 - **Plug and play**: the service waits for the device, streams while present and keeps
   waiting through unplug/replug; a udev rule grants access to the logged-in user
 - **Single instance**: launching the app again just raises the running window
+- **Self-update from GitHub Releases** (check + one-click update)
 - **Donate / GitHub buttons** in the app (window and tray menu)
 - **AppImage build** script (`packaging/build_appimage.sh`, PySide6 bundled)
 
@@ -193,6 +209,29 @@ docs/        reverse-engineering.md — full analysis (Indonesian)
 assets/      previews and icon
 ```
 
+## Updates
+
+The app keeps itself current from GitHub Releases:
+
+- On start (when running from an AppImage) and from the **Periksa pembaruan** button or the
+  tray menu, it asks the GitHub API for the latest release and compares it with its version.
+- When a newer release exists, a **Perbarui ke vX.Y.Z** button appears. One click downloads
+  the release asset, replaces the running AppImage atomically, refreshes the sender from the
+  new bundle and restarts the service. Restart the app to use the new version.
+- The download is verified against the release's published **SHA-256** before the AppImage is
+  replaced; a mismatch aborts the update. Older releases without a checksum are updated with a
+  warning in the log.
+- Nothing is downloaded without that click, and no other files are touched.
+
+Each release publishes three assets: the AppImage, its `.sha256`, and a `.zsync` file for
+`appimageupdatetool` / AppImageUpdate (delta updates). The zsync file is optional — the
+built-in updater does not need it — but the AppImage also carries the zsync URL as embedded
+update information (releases built after v1.2.3), so `appimageupdatetool ./GAMEMAX-LCD.AppImage`
+works directly.
+
+If the check fails (offline, proxy), the message appears in the app log. `GAMEMAX_DEBUG=1`
+also mirrors the log to stdout for headless runs.
+
 ## Support
 
 If this project is useful to you:

SECURITY.md

@@ -0,0 +1,14 @@
+# Security
+
+This is a small local tool. The relevant surface:
+
+- It writes 64-byte HID reports to the panel matching `VID 0x5131 / PID 0x2007`
+  (plus a udev rule that grants the logged-in user access to that `hidraw` node).
+- The tray app runs `systemctl --user` and, for the udev rule, `pkexec sh` on a script it
+  writes to `/tmp`. Nothing else is executed, and no data leaves the machine.
+- No secrets are stored. The config file (`~/.config/gamemax-report/config.json`) holds
+  sensor channel names and display settings only.
+
+If you find a problem — for example a way to make the helper scripts run something else,
+or a path that writes outside the documented locations — please open an issue (or a
+private security advisory on GitHub). Do not test on hardware you do not own.

packaging/build_appimage.sh

@@ -51,13 +51,19 @@ Terminal=false
 Categories=System;Utility;
 EOF
 
-# 4. package
+# 4. package (UPDATE_INFO_URL menyematkan info zsync agar appimageupdatetool bisa jalan)
+UPDATE_INFO_ARG=""
+if [ -n "${UPDATE_INFO_URL:-}" ]; then
+  UPDATE_INFO_ARG="-u zsync|${UPDATE_INFO_URL}"
+  echo "embedding update information: ${UPDATE_INFO_URL}"
+fi
 if [ ! -x "$BUILD_DIR/appimagetool" ]; then
   curl -fsSL "$APPIMAGETOOL_URL" -o "$BUILD_DIR/appimagetool"
   chmod +x "$BUILD_DIR/appimagetool"
 fi
 OUT="$OUT_DIR/GAMEMAX-LCD-x86_64.AppImage"
-ARCH=x86_64 "$BUILD_DIR/appimagetool" "$APPDIR" "$OUT"
+# shellcheck disable=SC2086
+ARCH=x86_64 "$BUILD_DIR/appimagetool" $UPDATE_INFO_ARG "$APPDIR" "$OUT"
 chmod +x "$OUT"
 echo "built: $OUT"
 echo "verify: $OUT --selftest   (or APPIMAGE_EXTRACT_AND_RUN=1 $OUT --selftest)"

src/gamemax_gui.py

@@ -8,9 +8,13 @@ mengendalikannya dan memakai gamemax_report.py sebagai pengirim.
     gamemax_gui.py --tray-only  # tanpa jendela
     gamemax_gui.py --selftest   # uji muat tanpa tampilan (untuk build AppImage)
 """
+import hashlib
 import json
 import math
 import os
+import re
+import tempfile
+import urllib.request
 import shutil
 import subprocess
 import sys
@@ -23,11 +27,15 @@ from PySide6.QtGui import (QAction, QColor, QConicalGradient, QDesktopServices,
                            QIcon, QPainter, QPen, QPixmap)
 from PySide6.QtWidgets import (
     QApplication, QCheckBox, QComboBox, QFormLayout, QGroupBox, QHBoxLayout, QLabel,
-    QMenu, QPlainTextEdit, QProgressBar, QPushButton, QSystemTrayIcon, QVBoxLayout, QWidget,
+    QMenu, QMessageBox, QPlainTextEdit, QProgressBar, QPushButton, QSystemTrayIcon,
+    QVBoxLayout, QWidget,
 )
 from PySide6.QtNetwork import QLocalServer, QLocalSocket
 
-APP_VERSION = "1.1.0"
+APP_VERSION = "1.3.0"
+REPO = "oxpoe/Gamemax-linux-apps"
+RELEASES_API = f"https://api.github.com/repos/{REPO}/releases/latest"
+UPDATE_ASSET = "GAMEMAX-LCD-x86_64.AppImage"
 HERE = os.path.dirname(os.path.abspath(__file__))
 sys.path.insert(0, HERE)
 import gamemax_report as gr  # noqa: E402
@@ -58,6 +66,34 @@ WantedBy=default.target
 RULE_TEMPLATE = ('SUBSYSTEM=="hidraw", ATTRS{idVendor}=="5131", ATTRS{idProduct}=="2007", '
                  'TAG+="uaccess"\n')
 
+APP_QSS = """
+QWidget { background: #14121a; color: #ece6ff; font-size: 13px; }
+QLabel#hint { color: #a99fc4; }
+QGroupBox { border: 1px solid #2b2740; border-radius: 10px; margin-top: 14px;
+            padding: 12px 10px 8px 10px; font-weight: 600; }
+QGroupBox::title { subcontrol-origin: margin; left: 12px; padding: 0 6px; color: #a99fc4; }
+QPushButton { background: #242033; border: 1px solid #34304a; border-radius: 8px;
+              padding: 7px 13px; }
+QPushButton:hover { background: #2c2740; }
+QPushButton:pressed { background: #201c2e; }
+QPushButton:disabled { color: #6c6486; border-color: #2a2740; }
+QPushButton#primary { background: #def750; color: #14121a; border: none; font-weight: 700; }
+QPushButton#primary:hover { background: #e9ff6a; }
+QPushButton#primary:disabled { background: #4a5230; color: #2a2e20; }
+QComboBox, QDoubleSpinBox { background: #1c1926; border: 1px solid #34304a;
+                            border-radius: 8px; padding: 6px 8px; }
+QComboBox QAbstractItemView { background: #1c1926; border: 1px solid #2b2740;
+                              selection-background-color: #34304a; }
+QPlainTextEdit { background: #1c1926; border: 1px solid #2b2740; border-radius: 10px;
+                 padding: 6px; }
+QProgressBar { background: #1c1926; border: 1px solid #2b2740; border-radius: 6px; }
+QProgressBar::chunk { background: #def750; border-radius: 5px; }
+QCheckBox { spacing: 8px; }
+QCheckBox::indicator { width: 15px; height: 15px; border-radius: 4px;
+                       border: 1px solid #6c6486; background: #1c1926; }
+QCheckBox::indicator:checked { background: #def750; border-color: #def750; }
+QMessageBox { background: #1b1826; }
+"""
 CRASH_LOG = os.path.join(os.path.dirname(CONFIG_PATH), "gui-crash.log")
 ACCENT = QColor(222, 247, 80)      # warna aksen GAMEMAX dari appConfig.ini
 DIM = QColor(120, 128, 120)
@@ -73,6 +109,52 @@ def crash_log(text):
         pass
 
 
+def version_tuple(tag):
+    parts = re.findall(r"\d+", tag or "")[:3]
+    return tuple(int(p) for p in parts) or (0,)
+
+
+def ensure_ca_bundle():
+    """Bundel PyInstaller tidak menemukan CA sistem sendiri; arahkan OpenSSL ke sana."""
+    if os.environ.get("SSL_CERT_FILE"):
+        return
+    for path in ("/etc/ssl/certs/ca-certificates.crt",      # Arch/Debian
+                 "/etc/pki/tls/certs/ca-bundle.crt",        # Fedora/openSUSE
+                 "/etc/ssl/cert.pem"):                      # Alpine/BSD
+        if os.path.exists(path):
+            os.environ["SSL_CERT_FILE"] = path
+            return
+
+
+def verify_sha256(path, sha_url):
+    """True/False bila berkas checksum tersedia, None bila rilis tidak menyediakannya."""
+    try:
+        with urllib.request.urlopen(sha_url, timeout=10) as resp:
+            expected = resp.read().decode().split()[0].strip().lower()
+    except Exception:  # noqa: BLE001
+        return None
+    if len(expected) != 64:
+        return None
+    actual = hashlib.sha256(open(path, "rb").read()).hexdigest()
+    return actual == expected
+
+
+def latest_release():
+    """(tag, url aset) dari rilis terbaru GitHub — dipanggil dari thread pekerja."""
+    ensure_ca_bundle()
+    req = urllib.request.Request(RELEASES_API, headers={
+        "Accept": "application/vnd.github+json", "User-Agent": "gamemax-lcd"})
+    with urllib.request.urlopen(req, timeout=10) as resp:
+        data = json.load(resp)
+    asset = next((a for a in data.get("assets", []) if a["name"] == UPDATE_ASSET), None)
+    return data.get("tag_name", ""), (asset or {}).get("browser_download_url", "")
+
+
+def installed_appimage():
+    """Path AppImage yang sedang berjalan (kosong kalau dijalankan dari sumber)."""
+    return os.environ.get("APPIMAGE", "")
+
+
 def open_link(url, parent=None):
     """Buka tautan di peramban; kalau gagal, tampilkan pesannya di log."""
     if not QDesktopServices.openUrl(QUrl(url)):
@@ -128,10 +210,12 @@ class Task(QThread):
     def __init__(self, label, fn):
         super().__init__()
         self.label, self.fn = label, fn
+        self.result = None
 
     def run(self):
         try:
-            self.done.emit(self.label, True, self.fn() or "")
+            self.result = self.fn()
+            self.done.emit(self.label, True, self.result if isinstance(self.result, str) else "")
         except Exception as exc:  # noqa: BLE001
             self.done.emit(self.label, False, str(exc))
 
@@ -247,15 +331,20 @@ class Window(QWidget):
         super().__init__()
         self.tray = tray
         self.prev_stat = gr.stat_snapshot()
-        self.setWindowTitle("GAMEMAX IceBurg LCD")
+        self.setWindowTitle(f"GAMEMAX IceBurg LCD v{APP_VERSION}")
         self.setWindowIcon(QIcon(icon_path()))
         self.setMinimumWidth(640)
         root = QVBoxLayout(self)
+        self._extra = {k: v for k, v in gr.load_config(CONFIG_PATH).items()
+                       if k in ("close_action", "geometry")}
+        geom = self._extra.get("geometry")
+        if isinstance(geom, list) and len(geom) == 4:
+            self.setGeometry(*[int(g) for g in geom])
 
         hint = QLabel("Kontrol layar LCD AIO GAMEMAX. Pilih slot kipas/sumber suhu di "
                       "<b>Pengaturan</b> lalu klik <b>Simpan &amp; terapkan</b>.")
+        hint.setObjectName("hint")
         hint.setWordWrap(True)
-        hint.setStyleSheet("color:#c8ccc8;")
         root.addWidget(hint)
 
         # ---- banner mode layar (jelas: normal / kosong / berhenti)
@@ -273,7 +362,7 @@ class Window(QWidget):
         controls = QHBoxLayout()
         self.toggle = QPushButton("Aktifkan layar")
         self.toggle.setMinimumHeight(38)
-        self.toggle.setStyleSheet("font-weight: bold;")
+        self.toggle.setObjectName("primary")
         self.toggle.clicked.connect(lambda: self.start_task("mengubah status layanan", self.on_toggle))
         self.toggle.setToolTip("Mulai/hentikan pengiriman data sensor ke layar LCD")
         controls.addWidget(self.toggle, 2)
@@ -358,6 +447,20 @@ class Window(QWidget):
         links.addWidget(donate)
         links.addWidget(github)
         links.addStretch(1)
+        copy_button = QPushButton("Salin report")
+        copy_button.setToolTip("Salin isi report 65 byte ke papan klip (untuk laporan bug)")
+        copy_button.clicked.connect(self.copy_report)
+        links.addWidget(copy_button)
+        self.check_button = QPushButton("Periksa pembaruan")
+        self.check_button.setToolTip("Bandingkan dengan rilis terbaru di GitHub")
+        self.check_button.clicked.connect(lambda: self.start_task("memeriksa pembaruan", self.do_check_update))
+        links.addWidget(self.check_button)
+        self.update_button = QPushButton("Perbarui")
+        self.update_button.setStyleSheet("font-weight:bold;")
+        self.update_button.hide()
+        self.update_button.clicked.connect(self.on_update_clicked)
+        links.addWidget(self.update_button)
+        links.addStretch(1)
         self.version_label = QLabel(f"v{APP_VERSION}")
         self.version_label.setStyleSheet("color:#8a8f8a;")
         links.addWidget(self.version_label)
@@ -382,6 +485,10 @@ class Window(QWidget):
         self.poll = QTimer(self, timeout=self.refresh, interval=1000)
         self.poll.start()
         self.refresh()
+        testing = any(f in sys.argv for f in ("--selftest", "--selftest-actions"))
+        if installed_appimage() and not testing:     # hanya pada versi terpasang
+            QTimer.singleShot(2500, lambda: self.start_task("memeriksa pembaruan",
+                                                            self.do_check_update))
         if gr.load_config(CONFIG_PATH).get("blank"):
             self.log("PERHATIAN: mode layar kosong sedang aktif dari konfigurasi "
                      "(layar menampilkan nilai nol). Hilangkan centang 'Layar kosong' "
@@ -415,6 +522,7 @@ class Window(QWidget):
 
     def config(self):
         return {
+            **self._extra,
             "fan_channel": self.fan.currentData() or None,
             "temp_channel": self.temp.currentData() or None,
             "unit": "c",                      # panel hanya punya label °C
@@ -424,6 +532,113 @@ class Window(QWidget):
             "blank": bool(self.blank.isChecked()),
         }
 
+    def copy_report(self):
+        QApplication.clipboard().setText(getattr(self, "_report_hex", ""))
+        self.log("isi report disalin ke papan klip")
+
+    def save_geometry(self):
+        g = self.geometry()
+        self._extra["geometry"] = [g.x(), g.y(), g.width(), g.height()]
+        try:
+            self.write_config(self.config())
+        except OSError:
+            pass
+
+    def closeEvent(self, event):                      # noqa: N802 (Qt)
+        if getattr(self, "_quitting", False):
+            self.save_geometry()
+            event.accept()
+            return
+        action = self._extra.get("close_action", "ask")
+        if action == "tray" and self.tray.available():
+            self.save_geometry()
+            self.hide()
+            event.ignore()
+            return
+        if action == "quit":
+            self.save_geometry()
+            self._quitting = True
+            event.accept()
+            QApplication.quit()
+            return
+
+        box = QMessageBox(self)
+        box.setWindowTitle("Tutup GAMEMAX LCD")
+        box.setText("Sembunyikan ke tray atau keluar sepenuhnya?")
+        box.setInformativeText("Selama tersembunyi di tray, data sensor tetap dikirim ke layar.")
+        remember = QCheckBox("Ingat pilihan ini")
+        box.setCheckBox(remember)
+        hide_btn = box.addButton("Sembunyikan ke tray", QMessageBox.AcceptRole)
+        quit_btn = box.addButton("Keluar", QMessageBox.DestructiveRole)
+        box.addButton("Batal", QMessageBox.RejectRole)
+        if not self.tray.available():
+            hide_btn.setEnabled(False)
+            box.setInformativeText("Tray tidak tersedia di desktop ini — menutup jendela akan "
+                                   "menghentikan aplikasi.")
+        box.exec()
+        clicked = box.clickedButton()
+        if clicked is hide_btn:
+            if remember.isChecked():
+                self._extra["close_action"] = "tray"
+            self.save_geometry()
+            self.hide()
+            event.ignore()
+        elif clicked is quit_btn:
+            if remember.isChecked():
+                self._extra["close_action"] = "quit"
+            self.save_geometry()
+            self._quitting = True
+            event.accept()
+            QApplication.quit()
+        else:
+            event.ignore()
+
+    # -------------------------------------------------------------- pembaruan
+    def do_check_update(self):
+        tag, url = latest_release()
+        self._pending_update = (tag, url) if url and version_tuple(tag) > version_tuple(APP_VERSION) else None
+        if not tag:
+            return "tidak bisa membaca daftar rilis GitHub"
+        if self._pending_update:
+            return f"versi baru tersedia: {tag} (terpasang v{APP_VERSION})"
+        return f"sudah versi terbaru (v{APP_VERSION})"
+
+    def on_update_clicked(self):
+        pending = getattr(self, "_pending_update", None)
+        target = installed_appimage()
+        if not pending:
+            return
+        if not target:
+            self.log("tidak berjalan dari AppImage — perbarui manual dari halaman Releases")
+            return
+        tag, url = pending
+        self.start_task(f"mengunduh {tag}", lambda: self.do_update(tag, url, target))
+
+    def do_update(self, tag, url, target):
+        ensure_ca_bundle()
+        tmp = target + ".new"
+        urllib.request.urlretrieve(url, tmp)
+        checked = verify_sha256(tmp, url + ".sha256")
+        if checked is False:
+            os.unlink(tmp)
+            raise RuntimeError("checksum SHA-256 tidak cocok — unduhan dibatalkan")
+        os.chmod(tmp, 0o755)
+        os.replace(tmp, target)                      # ganti berkas secara atomik
+        # sender di layanan juga diambil dari bundel baru
+        with tempfile.TemporaryDirectory() as td:
+            subprocess.run([target, "--appimage-extract"], cwd=td,
+                           capture_output=True, timeout=180)
+            sender = os.path.join(td, "squashfs-root/usr/bin/_internal/gamemax_report.py")
+            if os.path.exists(sender):
+                os.makedirs(INSTALL_DIR, exist_ok=True)
+                shutil.copyfile(sender, os.path.join(INSTALL_DIR, "gamemax_report.py"))
+                systemctl("restart", SERVICE)
+        note = "" if checked is None else " (checksum SHA-256 terverifikasi)"
+        if checked is None:
+            note = " (rilis ini tidak menyertakan checksum)"
+        return (f"diperbarui ke {tag}{note} — tutup jendela ini lalu buka lagi "
+                "untuk memakai versi baru")
+
     # -------------------------------------------------------------- tugas latar
     def start_task(self, label, fn):
         if getattr(self, "_task", None) is not None and self._task.isRunning():
@@ -445,6 +660,10 @@ class Window(QWidget):
         for button in self.buttons:
             button.setEnabled(True)
         self.log(("selesai: " if ok else "GAGAL: ") + label + (f" — {message}" if message else ""))
+        pending = getattr(self, "_pending_update", None)
+        if label == "memeriksa pembaruan" and pending:
+            self.update_button.setText(f"Perbarui ke {pending[0]}")
+            self.update_button.show()
         self.refresh()
 
     # -------------------------------------------------------------- aksi
@@ -589,6 +808,8 @@ class Window(QWidget):
 
     def log(self, text):
         self.logview.appendPlainText(text)
+        if os.environ.get("GAMEMAX_DEBUG"):
+            print(text, flush=True)
 
     def warn_once(self, text):
         if getattr(self, "_warned", None) != text:
@@ -689,16 +910,20 @@ class Tray:
         toggle = QAction("Aktifkan / matikan", menu)
         toggle.triggered.connect(lambda: self.window.on_toggle())
         self.blank_action.triggered.connect(lambda checked: self.window.blank.setChecked(checked))
+        check_action = QAction("Periksa pembaruan", menu)
+        check_action.triggered.connect(lambda: self.window.start_task(
+            "memeriksa pembaruan", self.window.do_check_update))
         donate_action = QAction("❤  Donasi", menu)
         donate_action.triggered.connect(lambda: open_link(DONATE_URL, self.window))
         github_action = QAction("GitHub", menu)
         github_action.triggered.connect(lambda: open_link(GITHUB_URL, self.window))
         quit_action = QAction("Keluar", menu)
-        quit_action.triggered.connect(app.quit)
+        quit_action.triggered.connect(self.quit_app)
         menu.addAction(show)
         menu.addAction(toggle)
         menu.addAction(self.blank_action)
         menu.addSeparator()
+        menu.addAction(check_action)
         menu.addAction(donate_action)
         menu.addAction(github_action)
         menu.addSeparator()
@@ -709,6 +934,13 @@ class Tray:
         self.window = Window(self)
         self.icon.show()
 
+    def available(self):
+        return QSystemTrayIcon.isSystemTrayAvailable()
+
+    def quit_app(self):
+        self.window._quitting = True
+        self.app.quit()
+
     def sync(self, active):
         blank = bool(gr.load_config(CONFIG_PATH).get("blank"))
         state = ("layar kosong (nilai nol)" if blank and active
@@ -745,6 +977,7 @@ def main():
 def _main():
     app = QApplication(sys.argv)
     app.setApplicationName("GAMEMAX LCD")
+    app.setStyleSheet(APP_QSS)
     app.setQuitOnLastWindowClosed(False)
 
     # hanya satu instance: yang kedua memunculkan jendela yang sudah ada lalu keluar
@@ -766,7 +999,14 @@ def _main():
 
     tray = Tray(app)
     server.newConnection.connect(lambda: tray.show_window())
-    app.aboutToQuit.connect(lambda: (server.close(), QLocalServer.removeServer(SOCKET_NAME)))
+    def on_quit():
+        task = getattr(tray.window, "_task", None)
+        if task is not None and task.isRunning():
+            task.wait(3000)
+        server.close()
+        QLocalServer.removeServer(SOCKET_NAME)
+
+    app.aboutToQuit.connect(on_quit)
     # Jendela selalu dibuka saat diluncurkan; tray tetap ada kalau didukung desktop.
     tray.show_window()
     if "--tray-only" in sys.argv:
@@ -792,11 +1032,12 @@ def _main():
                  ("nyalakan layar", w.on_toggle),
                  ("autostart ON", lambda: w.on_autostart(True)),
                  ("kirim uji", w.send_test),
-                 ("pasang layanan", lambda: w.install_service(w.config())))
+                 ("pasang layanan", lambda: w.install_service(w.config())),
+                 ("periksa pembaruan", w.do_check_update))
         for name, fn in steps:
             try:
-                fn()
-                print(f"[ OK ] {name}")
+                out = fn()
+                print(f"[ OK ] {name}" + (f" — {out}" if isinstance(out, str) and out else ""))
             except Exception as exc:  # noqa: BLE001
                 print(f"[GAGAL] {name}: {exc}")
         # jalur asinkron yang dipakai tombol: centang layar kosong + simpan
@@ -825,6 +1066,7 @@ def _main():
         print("log:", " | ".join(w.logview.toPlainText().splitlines()[-6:]))
         return 0
     if "--selftest" in sys.argv:
+        tray.window._quitting = True                 # keluar otomatis: lewati dialog tutup
         QTimer.singleShot(1200, app.quit)
     rc = app.exec()
     if "--selftest" in sys.argv: