Add GUI

gui/views/__init__.py

@@ -0,0 +1,7 @@
+from gui.views.dashboard import DashboardView
+from gui.views.mods      import ModsView
+from gui.views.tools     import ToolsView
+from gui.views.logs      import LogsView
+from gui.views.settings  import SettingsView
+
+__all__ = ["DashboardView", "ModsView", "ToolsView", "LogsView", "SettingsView"]

gui/views/base.py

@@ -0,0 +1,32 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+import customtkinter as ctk
+
+if TYPE_CHECKING:
+    from gui.app import ArmaModManagerApp
+
+
+class BaseView(ctk.CTkFrame):
+    """
+    Common base for all view panels.
+
+    Each view is a CTkFrame owned by the app's content area. The app creates
+    view instances once and caches them; it calls refresh() on each navigation
+    so views can update their dynamic content without rebuilding the whole frame.
+
+    Subclasses must implement build() and may override refresh().
+    """
+
+    def __init__(self, parent: ctk.CTkFrame, app: ArmaModManagerApp) -> None:
+        super().__init__(parent, fg_color="transparent")
+        self.app = app
+        self.build()
+
+    def build(self) -> None:
+        """Construct all child widgets. Called once from __init__."""
+        raise NotImplementedError
+
+    def refresh(self) -> None:
+        """Re-query data and update dynamic widgets. Called on every navigation."""

gui/views/dashboard.py

@@ -0,0 +1,289 @@
+from __future__ import annotations
+
+import json
+import shutil
+from pathlib import Path
+from tkinter import filedialog, messagebox
+from typing import TYPE_CHECKING
+
+import customtkinter as ctk
+
+from gui._constants import (
+    COLOR_OK, COLOR_PENDING, COLOR_ERROR, COLOR_WARN,
+)
+from gui.views.base import BaseView
+
+if TYPE_CHECKING:
+    from gui.app import ArmaModManagerApp
+
+
+class DashboardView(BaseView):
+    """
+    Preset file selector + pipeline status + Run button.
+
+    Dynamic regions (rebuilt in refresh):
+    - _preset_scroll  — checkbox list of .html files
+    - _step_icons     — ✓/○ status for each pipeline step
+    - _stats_lbl      — mod counts from comparison.json
+
+    Static regions (built once):
+    - _run_btn / _prog  — pipeline controls, state changed by set_pipeline_ui()
+    - _sel_count_lbl    — "X of Y selected" label, updated by _on_toggle()
+    """
+
+    def build(self) -> None:
+        self.grid_columnconfigure(0, weight=1)
+        self.grid_rowconfigure(1, weight=1)
+
+        # ── Header ────────────────────────────────────────────────────────────
+        hdr = ctk.CTkFrame(self, fg_color="transparent")
+        hdr.grid(row=0, column=0, sticky="ew", padx=24, pady=(20, 10))
+        ctk.CTkLabel(hdr, text="Dashboard",
+                     font=ctk.CTkFont(size=22, weight="bold")).pack(side="left")
+        ctk.CTkButton(hdr, text="⟳  Refresh", width=100,
+                      command=self.refresh).pack(side="right")
+
+        # ── Cards ─────────────────────────────────────────────────────────────
+        cards = ctk.CTkFrame(self, fg_color="transparent")
+        cards.grid(row=1, column=0, sticky="nsew", padx=24)
+        cards.columnconfigure(0, weight=3)
+        cards.columnconfigure(1, weight=2)
+
+        self._build_preset_card(cards)
+        self._build_pipeline_card(cards)
+
+        # ── Run button area ───────────────────────────────────────────────────
+        run_area = ctk.CTkFrame(self, fg_color="transparent")
+        run_area.grid(row=2, column=0, sticky="ew", padx=24, pady=16)
+
+        self._run_btn = ctk.CTkButton(
+            run_area,
+            text="▶   Run Full Pipeline",
+            font=ctk.CTkFont(size=15, weight="bold"),
+            height=46,
+            command=self._on_run,
+        )
+        self._run_btn.pack(fill="x")
+        self._prog = ctk.CTkProgressBar(run_area, mode="indeterminate")
+
+    # ── Preset card ───────────────────────────────────────────────────────────
+
+    def _build_preset_card(self, parent: ctk.CTkFrame) -> None:
+        pc = ctk.CTkFrame(parent)
+        pc.grid(row=0, column=0, sticky="nsew", padx=(0, 8), pady=4)
+
+        ctk.CTkLabel(pc, text="Preset Files",
+                     font=ctk.CTkFont(size=14, weight="bold")).pack(
+            anchor="w", padx=14, pady=(14, 2))
+        ctk.CTkLabel(pc,
+                     text="HTML exports from Arma 3 Launcher → Mods → Export to HTML",
+                     text_color="gray", font=ctk.CTkFont(size=11)).pack(
+            anchor="w", padx=14)
+
+        self._preset_scroll = ctk.CTkScrollableFrame(pc, height=150)
+        self._preset_scroll.pack(fill="x", padx=14, pady=(10, 4))
+
+        # Selection controls
+        sel_row = ctk.CTkFrame(pc, fg_color="transparent")
+        sel_row.pack(fill="x", padx=14, pady=(0, 8))
+        self._sel_count_lbl = ctk.CTkLabel(sel_row, text="", text_color="gray",
+                                           font=ctk.CTkFont(size=11))
+        self._sel_count_lbl.pack(side="left")
+        ctk.CTkButton(sel_row, text="None", width=54,
+                      fg_color="transparent", border_width=1,
+                      text_color=("gray10", "gray90"), font=ctk.CTkFont(size=11),
+                      command=self._select_none).pack(side="right")
+        ctk.CTkButton(sel_row, text="All", width=54,
+                      fg_color="transparent", border_width=1,
+                      text_color=("gray10", "gray90"), font=ctk.CTkFont(size=11),
+                      command=self._select_all).pack(side="right", padx=(0, 6))
+
+        ctk.CTkButton(pc, text="+ Add Preset Files",
+                      fg_color="transparent", border_width=1,
+                      text_color=("gray10", "gray90"),
+                      command=self._add_presets).pack(pady=(0, 14))
+
+    # ── Pipeline card ─────────────────────────────────────────────────────────
+
+    def _build_pipeline_card(self, parent: ctk.CTkFrame) -> None:
+        pipe = ctk.CTkFrame(parent)
+        pipe.grid(row=0, column=1, sticky="nsew", padx=(8, 0), pady=4)
+
+        ctk.CTkLabel(pipe, text="Pipeline Status",
+                     font=ctk.CTkFont(size=14, weight="bold")).pack(
+            anchor="w", padx=14, pady=(14, 8))
+
+        self._step_icons: dict[str, ctk.CTkLabel] = {}
+        for key, label in [
+            ("parse",    "Parse presets"),
+            ("compare",  "Compare presets"),
+            ("download", "Download mods"),
+            ("link",     "Link to Arma"),
+        ]:
+            row = ctk.CTkFrame(pipe, fg_color="transparent")
+            row.pack(fill="x", padx=14, pady=3)
+            icon = ctk.CTkLabel(row, text="○", width=22,
+                                text_color=COLOR_PENDING,
+                                font=ctk.CTkFont(size=15))
+            icon.pack(side="left")
+            ctk.CTkLabel(row, text=label, anchor="w").pack(side="left", padx=6)
+            self._step_icons[key] = icon
+
+        self._stats_lbl = ctk.CTkLabel(pipe, text="", text_color="gray",
+                                       font=ctk.CTkFont(size=11),
+                                       wraplength=200, justify="left")
+        self._stats_lbl.pack(anchor="w", padx=14, pady=(10, 14))
+
+    # ── refresh ───────────────────────────────────────────────────────────────
+
+    def refresh(self) -> None:
+        self._rebuild_preset_list()
+        self._update_pipeline_status()
+
+    def _rebuild_preset_list(self) -> None:
+        for w in self._preset_scroll.winfo_children():
+            w.destroy()
+        self._preset_checks: dict[str, ctk.BooleanVar] = {}
+
+        cfg = self.app.cfg
+        if not cfg:
+            ctk.CTkLabel(self._preset_scroll,
+                         text="No config found. Complete Setup first.",
+                         text_color=COLOR_WARN).pack(anchor="w")
+            return
+
+        html_dir = cfg.modlist_html
+        if not html_dir.is_dir():
+            ctk.CTkLabel(self._preset_scroll,
+                         text=f"Folder missing:\n{html_dir}",
+                         text_color=COLOR_WARN, justify="left").pack(padx=4, pady=8)
+            return
+
+        files = sorted(html_dir.glob("*.html"))
+        if not files:
+            ctk.CTkLabel(self._preset_scroll,
+                         text="No preset files yet.\nUse the button below to add them.",
+                         text_color="gray", justify="left").pack(padx=4, pady=8)
+            return
+
+        saved = self.app.load_selection()
+        for fp in files:
+            var = ctk.BooleanVar(value=fp.name in saved)
+            self._preset_checks[fp.name] = var
+            ctk.CTkCheckBox(
+                self._preset_scroll,
+                text=fp.name,
+                variable=var,
+                command=self._on_toggle,
+            ).pack(anchor="w", padx=4, pady=3)
+
+        self._on_toggle()  # initialise count label
+
+    def _update_pipeline_status(self) -> None:
+        cfg = self.app.cfg
+        if not cfg:
+            for key in self._step_icons:
+                self._set_step(key, False)
+            return
+
+        selected_count = sum(1 for v in self._preset_checks.values() if v.get())
+        downloads_ok   = (
+            cfg.downloads.is_dir()
+            and any(True for _ in cfg.downloads.rglob("@*"))
+        )
+
+        self._set_step("parse",    selected_count >= 2)
+        self._set_step("compare",  cfg.comparison.exists())
+        self._set_step("download", downloads_ok)
+        self._set_step("link",     cfg.arma_dir.is_dir())
+
+        if cfg.comparison.exists():
+            try:
+                comp = json.loads(cfg.comparison.read_text(encoding="utf-8"))
+                total = (comp["shared"]["mod_count"]
+                         + sum(v["mod_count"] for v in comp["unique"].values()))
+                shared  = comp["shared"]["mod_count"]
+                missing = 0
+                if cfg.missing_report.exists():
+                    rep = json.loads(cfg.missing_report.read_text(encoding="utf-8"))
+                    missing = rep.get("missing", 0)
+                stat = f"{total} mods · {shared} shared"
+                if missing:
+                    stat += f"\n{missing} missing from server"
+                self._stats_lbl.configure(text=stat)
+            except Exception:
+                pass
+
+    def _set_step(self, key: str, done: bool) -> None:
+        icon = self._step_icons.get(key)
+        if icon:
+            icon.configure(
+                text="✓" if done else "○",
+                text_color=COLOR_OK if done else COLOR_PENDING,
+            )
+
+    # ── Selection helpers ─────────────────────────────────────────────────────
+
+    def get_selected_names(self) -> set[str]:
+        return {name for name, var in self._preset_checks.items() if var.get()}
+
+    def _on_toggle(self) -> None:
+        selected = self.get_selected_names()
+        self.app.save_selection(selected)
+        n_sel   = len(selected)
+        n_total = len(self._preset_checks)
+        color   = (COLOR_OK    if n_sel >= 2 else
+                   COLOR_WARN  if n_sel == 1 else
+                   COLOR_ERROR)
+        self._sel_count_lbl.configure(
+            text=f"{n_sel} of {n_total} selected", text_color=color)
+
+    def _select_all(self) -> None:
+        for var in self._preset_checks.values():
+            var.set(True)
+        self._on_toggle()
+
+    def _select_none(self) -> None:
+        for var in self._preset_checks.values():
+            var.set(False)
+        self._on_toggle()
+
+    # ── Add presets ───────────────────────────────────────────────────────────
+
+    def _add_presets(self) -> None:
+        cfg = self.app.cfg
+        if not cfg:
+            messagebox.showwarning("Setup required",
+                                   "Please complete Setup before adding presets.")
+            return
+        files = filedialog.askopenfilenames(
+            title="Select Arma 3 Launcher preset files",
+            filetypes=[("HTML Preset", "*.html"), ("All files", "*.*")],
+        )
+        if not files:
+            return
+        dest = cfg.modlist_html
+        dest.mkdir(parents=True, exist_ok=True)
+        current = self.app.load_selection()
+        for fp in files:
+            name = Path(fp).name
+            shutil.copy2(fp, dest / name)
+            current.add(name)
+        self.app.save_selection(current)
+        self.refresh()
+
+    # ── Run button ────────────────────────────────────────────────────────────
+
+    def _on_run(self) -> None:
+        self.app.run_pipeline(self.get_selected_names())
+
+    def set_pipeline_ui(self, running: bool) -> None:
+        """Called by the app to reflect pipeline start/end in the UI."""
+        if running:
+            self._run_btn.configure(state="disabled", text="Running…")
+            self._prog.pack(fill="x", pady=(6, 0))
+            self._prog.start()
+        else:
+            self._run_btn.configure(state="normal", text="▶   Run Full Pipeline")
+            self._prog.stop()
+            self._prog.pack_forget()

gui/views/logs.py

@@ -0,0 +1,64 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+import customtkinter as ctk
+
+from gui._constants import COLOR_ERROR
+from gui.views.base import BaseView
+
+if TYPE_CHECKING:
+    from gui.app import ArmaModManagerApp
+
+
+class LogsView(BaseView):
+    """
+    Monospace textbox showing captured stdout/stderr from pipeline and tools.
+
+    The app's poll loop appends text by calling append() directly on this view.
+    Log content persists across navigation — the textbox is built once in build()
+    and never recreated.
+    """
+
+    def build(self) -> None:
+        self.grid_columnconfigure(0, weight=1)
+        self.grid_rowconfigure(1, weight=1)
+
+        # ── Header ────────────────────────────────────────────────────────────
+        hdr = ctk.CTkFrame(self, fg_color="transparent")
+        hdr.grid(row=0, column=0, sticky="ew", padx=24, pady=(20, 8))
+        ctk.CTkLabel(hdr, text="Logs",
+                     font=ctk.CTkFont(size=22, weight="bold")).pack(side="left")
+
+        btn_row = ctk.CTkFrame(hdr, fg_color="transparent")
+        btn_row.pack(side="right")
+        ctk.CTkButton(btn_row, text="Copy", width=72,
+                      command=self._copy).pack(side="left", padx=4)
+        ctk.CTkButton(btn_row, text="Clear", width=72,
+                      fg_color=COLOR_ERROR, hover_color="#c62828",
+                      command=self._clear).pack(side="left")
+
+        # ── Log textbox (persistent) ──────────────────────────────────────────
+        self._log_box = ctk.CTkTextbox(
+            self, state="disabled",
+            font=ctk.CTkFont(family="Consolas", size=12))
+        self._log_box.grid(row=1, column=0, sticky="nsew", padx=24, pady=(0, 12))
+
+    def append(self, text: str) -> None:
+        """Thread-safe-ish: called from the app's after() poll loop (main thread)."""
+        try:
+            self._log_box.configure(state="normal")
+            self._log_box.insert("end", text)
+            self._log_box.see("end")
+            self._log_box.configure(state="disabled")
+        except Exception:
+            pass
+
+    def _copy(self) -> None:
+        self.clipboard_clear()
+        self.clipboard_append(self._log_box.get("1.0", "end"))
+
+    def _clear(self) -> None:
+        self._log_box.configure(state="normal")
+        self._log_box.delete("1.0", "end")
+        self._log_box.configure(state="disabled")

gui/views/mods.py

@@ -0,0 +1,353 @@
+from __future__ import annotations
+
+import json
+import threading
+from pathlib import Path
+from typing import TYPE_CHECKING, Optional
+
+import customtkinter as ctk
+
+from gui._constants import COLOR_OK, COLOR_ERROR, COLOR_WARN, COLOR_RUNNING
+from gui.views.base import BaseView
+
+if TYPE_CHECKING:
+    from gui.app import ArmaModManagerApp
+
+
+def _find_folder(group_dir: Path, mod_name: str) -> Optional[Path]:
+    """Return the local mod folder path, or None if not downloaded."""
+    if not group_dir.is_dir():
+        return None
+    candidate = group_dir / f"@{mod_name}"
+    if candidate.is_dir():
+        return candidate
+    target = mod_name.lower()
+    for p in group_dir.iterdir():
+        if p.is_dir() and p.name.lstrip("@").lower() == target:
+            return p
+    return None
+
+
+class ModsView(BaseView):
+    """Tabbed mod browser — one tab per comparison group with server status checking."""
+
+    def build(self) -> None:
+        self.grid_columnconfigure(0, weight=1)
+        self.grid_rowconfigure(2, weight=1)
+
+        # ── State ─────────────────────────────────────────────────────────────
+        self._search_var = ctk.StringVar()
+        self._checking   = False
+        self._check_btn: Optional[ctk.CTkButton] = None
+        self._tab_view:  Optional[ctk.CTkTabview] = None
+        # key = "{group}/{folder_name_or_mod_name}"
+        # value = dict(status_label, update_btn, group, folder_path, mod_dict, name_label)
+        self._mod_rows: dict[str, dict] = {}
+
+        # ── Header ────────────────────────────────────────────────────────────
+        hdr = ctk.CTkFrame(self, fg_color="transparent")
+        hdr.grid(row=0, column=0, sticky="ew", padx=24, pady=(20, 6))
+        hdr.columnconfigure(1, weight=1)
+
+        ctk.CTkLabel(hdr, text="Mods",
+                     font=ctk.CTkFont(size=22, weight="bold")).grid(
+            row=0, column=0, sticky="w")
+
+        btn_frame = ctk.CTkFrame(hdr, fg_color="transparent")
+        btn_frame.grid(row=0, column=2, sticky="e")
+
+        ctk.CTkButton(btn_frame, text="⟳  Refresh", width=100,
+                      command=self.refresh).pack(side="left", padx=(0, 6))
+
+        self._check_btn = ctk.CTkButton(
+            btn_frame, text="☁  Check Updates", width=130,
+            command=self._check_updates,
+        )
+        self._check_btn.pack(side="left")
+
+        # ── Search ────────────────────────────────────────────────────────────
+        bar = ctk.CTkFrame(self, fg_color="transparent")
+        bar.grid(row=1, column=0, sticky="ew", padx=24, pady=(0, 8))
+        ctk.CTkLabel(bar, text="Search:").pack(side="left", padx=(0, 6))
+        ctk.CTkEntry(bar, textvariable=self._search_var,
+                     placeholder_text="Filter mods in active tab…",
+                     width=220).pack(side="left")
+        self._search_var.trace_add("write", lambda *_: self._apply_search())
+
+        # ── Tab area placeholder ───────────────────────────────────────────────
+        self._tab_area = ctk.CTkFrame(self, fg_color="transparent")
+        self._tab_area.grid(row=2, column=0, sticky="nsew", padx=16, pady=(0, 12))
+        self._tab_area.grid_columnconfigure(0, weight=1)
+        self._tab_area.grid_rowconfigure(0, weight=1)
+
+        self._msg_label: Optional[ctk.CTkLabel] = None
+
+    # =========================================================================
+    # Public
+    # =========================================================================
+
+    def refresh(self) -> None:
+        self._mod_rows.clear()
+
+        # Destroy previous tab_view / message
+        if self._tab_view is not None:
+            self._tab_view.destroy()
+            self._tab_view = None
+        if self._msg_label is not None:
+            self._msg_label.destroy()
+            self._msg_label = None
+
+        cfg = self.app.cfg
+        if not cfg:
+            self._show_msg("No config found. Complete Setup first.")
+            return
+        if not cfg.comparison.exists():
+            self._show_msg(
+                "No mod data yet.\n"
+                "Go to Dashboard, select your presets, then click Run Full Pipeline."
+            )
+            return
+
+        try:
+            comp = json.loads(cfg.comparison.read_text(encoding="utf-8"))
+        except Exception as e:
+            self._show_msg(f"Error reading comparison.json: {e}", error=True)
+            return
+
+        # Build ordered group list: shared first, then unique groups
+        groups: list[tuple[str, dict]] = [("shared", comp["shared"])]
+        for preset, data in comp["unique"].items():
+            groups.append((preset, data))
+
+        # Precompute link maps per group (one get_link_status call per group)
+        link_maps: dict[str, dict[str, bool]] = {}
+        try:
+            from arma_modlist_tools.linker import get_link_status
+            for group, _ in groups:
+                gdir = cfg.downloads / group
+                if gdir.is_dir():
+                    link_maps[group] = {
+                        e["name"].lower(): e["is_linked"]
+                        for e in get_link_status(gdir, cfg.arma_dir)
+                    }
+        except Exception:
+            pass
+
+        # Build CTkTabview
+        tv = ctk.CTkTabview(self._tab_area)
+        tv.grid(row=0, column=0, sticky="nsew")
+        self._tab_view = tv
+
+        for group, data in groups:
+            mods = data.get("mods", [])
+            count = len(mods)
+            tab_label = f"{group}  ({count})"
+            tv.add(tab_label)
+            tab_frame = tv.tab(tab_label)
+            tab_frame.grid_columnconfigure(0, weight=1)
+            tab_frame.grid_rowconfigure(1, weight=1)
+
+            # Column header
+            col_hdr = ctk.CTkFrame(tab_frame,
+                                   fg_color=("gray82", "gray22"), corner_radius=6)
+            col_hdr.grid(row=0, column=0, sticky="ew", padx=4, pady=(6, 2))
+            col_hdr.columnconfigure(0, weight=1)
+            for col, (w, lbl) in enumerate([
+                (0,   "Mod Name"),
+                (80,  "Downloaded"),
+                (80,  "Linked"),
+                (160, "Server Status"),
+                (80,  ""),
+            ]):
+                ctk.CTkLabel(col_hdr, text=lbl,
+                             font=ctk.CTkFont(weight="bold"),
+                             anchor="w", width=w or 1).grid(
+                    row=0, column=col,
+                    padx=(10 if col == 0 else 4, 4), pady=5,
+                    sticky="ew" if col == 0 else "")
+
+            # Scrollable rows
+            scroll = ctk.CTkScrollableFrame(tab_frame)
+            scroll.grid(row=1, column=0, sticky="nsew", padx=4, pady=(0, 4))
+
+            self._build_group_rows(scroll, group, mods,
+                                   cfg, link_maps.get(group, {}))
+
+        if groups:
+            tv.set(f"{groups[0][0]}  ({len(groups[0][1].get('mods', []))})")
+
+    # =========================================================================
+    # Private — layout helpers
+    # =========================================================================
+
+    def _show_msg(self, text: str, error: bool = False) -> None:
+        self._msg_label = ctk.CTkLabel(
+            self._tab_area, text=text, justify="left",
+            text_color="#F44336" if error else "gray",
+        )
+        self._msg_label.grid(row=0, column=0, padx=24, pady=24, sticky="nw")
+
+    def _build_group_rows(
+        self,
+        parent: ctk.CTkScrollableFrame,
+        group: str,
+        mods: list[dict],
+        cfg,
+        link_map: dict[str, bool],
+    ) -> None:
+        for i, mod in enumerate(sorted(mods, key=lambda m: m["name"].lower())):
+            folder_path = _find_folder(cfg.downloads / group, mod["name"])
+            downloaded  = folder_path is not None
+            linked      = (link_map.get(folder_path.name.lower(), False)
+                           if folder_path else False)
+
+            bg = ("gray90", "gray17") if i % 2 == 0 else ("gray86", "gray14")
+            row = ctk.CTkFrame(parent, fg_color=bg, corner_radius=4)
+            row.pack(fill="x", pady=1)
+            row.columnconfigure(0, weight=1)
+
+            # Mod name
+            name_lbl = ctk.CTkLabel(row, text=f"  {mod['name']}", anchor="w")
+            name_lbl.grid(row=0, column=0, sticky="ew", padx=4, pady=3)
+
+            # Downloaded
+            ctk.CTkLabel(
+                row,
+                text="  ✓" if downloaded else "  ✗",
+                text_color=COLOR_OK if downloaded else COLOR_ERROR,
+                width=80, anchor="w",
+            ).grid(row=0, column=1, padx=4)
+
+            # Linked
+            ctk.CTkLabel(
+                row,
+                text="  ✓" if linked else ("  —" if not downloaded else "  ✗"),
+                text_color=COLOR_OK if linked else "gray",
+                width=80, anchor="w",
+            ).grid(row=0, column=2, padx=4)
+
+            # Server status
+            status_lbl = ctk.CTkLabel(
+                row, text="—", text_color="gray", width=160, anchor="w",
+            )
+            status_lbl.grid(row=0, column=3, padx=4)
+
+            # Update button (hidden until stale detected)
+            folder_name = folder_path.name if folder_path else None
+            update_btn = ctk.CTkButton(
+                row, text="Update", width=70,
+                command=(lambda g=group, fn=folder_name:
+                         self._update_mod(g, fn)) if folder_name else None,
+                state="normal" if folder_name else "disabled",
+            )
+            update_btn.grid(row=0, column=4, padx=(4, 8), pady=2)
+            update_btn.grid_remove()  # hidden until check finds stale files
+
+            # Register in row map
+            key = f"{group}/{folder_name or mod['name']}"
+            self._mod_rows[key] = {
+                "status_label": status_lbl,
+                "update_btn":   update_btn,
+                "name_label":   name_lbl,
+                "row_frame":    row,
+                "group":        group,
+                "folder_path":  folder_path,
+                "mod_dict":     mod,
+                "mod_name":     mod["name"],
+            }
+
+    # =========================================================================
+    # Private — server update check
+    # =========================================================================
+
+    def _check_updates(self) -> None:
+        if self._checking:
+            return
+        cfg = self.app.cfg
+        if not cfg:
+            return
+        if not self._mod_rows:
+            return
+
+        self._checking = True
+        self._check_btn.configure(text="Checking…", state="disabled")
+
+        # Reset downloaded rows to "Checking…"
+        for row in self._mod_rows.values():
+            if row["folder_path"]:
+                row["status_label"].configure(
+                    text="Checking…", text_color=COLOR_RUNNING)
+            else:
+                row["status_label"].configure(text="—", text_color="gray")
+
+        # Snapshot rows for thread (avoid race with refresh)
+        rows_snapshot = dict(self._mod_rows)
+
+        def worker() -> None:
+            from arma_modlist_tools.fetcher import (
+                build_server_index, list_mod_updates, make_session, find_mod_folder,
+            )
+            results: dict[str, tuple[str, int]] = {}
+            try:
+                idx     = build_server_index(cfg.server_url, cfg.server_auth)
+                session = make_session(cfg.server_auth)
+                for key, row in rows_snapshot.items():
+                    if not row["folder_path"]:
+                        results[key] = ("not_downloaded", 0)
+                        continue
+                    try:
+                        folder_url = find_mod_folder(row["mod_dict"], idx)
+                        if not folder_url:
+                            results[key] = ("not_on_server", 0)
+                            continue
+                        stale = list_mod_updates(
+                            folder_url, row["folder_path"], session)
+                        results[key] = ("stale" if stale else "ok", len(stale))
+                    except Exception:
+                        results[key] = ("error", 0)
+            except Exception:
+                for key in rows_snapshot:
+                    results[key] = ("error", 0)
+            self.after(0, lambda: self._apply_check_results(results))
+
+        threading.Thread(target=worker, daemon=True).start()
+
+    def _apply_check_results(self, results: dict[str, tuple[str, int]]) -> None:
+        _STATUS: dict[str, tuple[str, str]] = {
+            "ok":             ("✓ Up to date",  COLOR_OK),
+            "stale":          ("⚠ {n} outdated", COLOR_WARN),
+            "not_downloaded": ("—",              "gray"),
+            "not_on_server":  ("Not on server",  "gray"),
+            "error":          ("✗ Error",        COLOR_ERROR),
+        }
+        for key, (status, n) in results.items():
+            row = self._mod_rows.get(key)
+            if not row:
+                continue
+            tmpl, color = _STATUS.get(status, ("—", "gray"))
+            row["status_label"].configure(
+                text=tmpl.replace("{n}", str(n)), text_color=color)
+            if status == "stale" and row["folder_path"]:
+                row["update_btn"].grid()
+            else:
+                row["update_btn"].grid_remove()
+
+        self._checking = False
+        self._check_btn.configure(text="☁  Check Updates", state="normal")
+
+    def _update_mod(self, group: str, folder_name: str) -> None:
+        self.app.navigate_to("Logs")
+        self.app.run_tool(["update_mods.py", "--group", group, "--mod", folder_name])
+
+    # =========================================================================
+    # Private — search filter
+    # =========================================================================
+
+    def _apply_search(self) -> None:
+        search = self._search_var.get().lower()
+        for row in self._mod_rows.values():
+            frame = row["row_frame"]
+            if not search or search in row["mod_name"].lower():
+                frame.pack(fill="x", pady=1)
+            else:
+                frame.pack_forget()

gui/views/settings.py

@@ -0,0 +1,79 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+import customtkinter as ctk
+
+from gui.views.base import BaseView
+
+if TYPE_CHECKING:
+    from gui.app import ArmaModManagerApp
+
+
+class SettingsView(BaseView):
+    """Appearance switcher, wizard re-opener, and current config display."""
+
+    def build(self) -> None:
+        self.grid_columnconfigure(0, weight=1)
+        self.grid_rowconfigure(1, weight=1)
+
+        ctk.CTkLabel(self, text="Settings",
+                     font=ctk.CTkFont(size=22, weight="bold")).grid(
+            row=0, column=0, sticky="w", padx=24, pady=(20, 8))
+
+        self._scroll = ctk.CTkScrollableFrame(self, fg_color="transparent")
+        self._scroll.grid(row=1, column=0, sticky="nsew", padx=24, pady=(0, 12))
+
+        self._build_cards()
+
+    def refresh(self) -> None:
+        # Config info may have changed (e.g. after wizard); rebuild cards.
+        for w in self._scroll.winfo_children():
+            w.destroy()
+        self._build_cards()
+
+    def _build_cards(self) -> None:
+        # ── Server & Paths ────────────────────────────────────────────────────
+        c1 = ctk.CTkFrame(self._scroll)
+        c1.pack(fill="x", pady=6)
+        ctk.CTkLabel(c1, text="Server & Path Configuration",
+                     font=ctk.CTkFont(size=14, weight="bold")).pack(
+            anchor="w", padx=16, pady=(14, 3))
+        ctk.CTkLabel(c1,
+                     text="Re-run the setup wizard to change your server URL, "
+                          "credentials, or Arma folder.",
+                     text_color="gray", wraplength=600, justify="left").pack(
+            anchor="w", padx=16, pady=(0, 8))
+        ctk.CTkButton(c1, text="Open Setup Wizard", width=160,
+                      command=self.app.open_wizard).pack(
+            anchor="e", padx=16, pady=(0, 14))
+
+        # ── Appearance ────────────────────────────────────────────────────────
+        c2 = ctk.CTkFrame(self._scroll)
+        c2.pack(fill="x", pady=6)
+        ctk.CTkLabel(c2, text="Appearance",
+                     font=ctk.CTkFont(size=14, weight="bold")).pack(
+            anchor="w", padx=16, pady=(14, 3))
+        mode_var = ctk.StringVar(value=ctk.get_appearance_mode())
+        ctk.CTkOptionMenu(c2, values=["Dark", "Light", "System"],
+                          variable=mode_var,
+                          command=ctk.set_appearance_mode,
+                          width=140).pack(anchor="w", padx=16, pady=(0, 14))
+
+        # ── Current config info ───────────────────────────────────────────────
+        cfg = self.app.cfg
+        if cfg:
+            c3 = ctk.CTkFrame(self._scroll)
+            c3.pack(fill="x", pady=6)
+            ctk.CTkLabel(c3, text="Current Configuration",
+                         font=ctk.CTkFont(size=14, weight="bold")).pack(
+                anchor="w", padx=16, pady=(14, 3))
+            info = (
+                f"Server:      {cfg.server_url}\n"
+                f"Arma dir:    {cfg.arma_dir}\n"
+                f"Downloads:   {cfg.downloads}\n"
+                f"Presets:     {cfg.modlist_html}\n"
+            )
+            ctk.CTkLabel(c3, text=info, justify="left",
+                         font=ctk.CTkFont(family="Consolas", size=11),
+                         text_color="gray").pack(anchor="w", padx=16, pady=(0, 14))

gui/views/tools.py

@@ -0,0 +1,409 @@
+from __future__ import annotations
+
+import json
+from tkinter import messagebox
+from typing import TYPE_CHECKING, Optional
+
+import customtkinter as ctk
+
+from gui._constants import COLOR_WARN, PROJECT_ROOT
+from gui.views.base import BaseView
+
+if TYPE_CHECKING:
+    from gui.app import ArmaModManagerApp
+
+_WARN_COLOR = COLOR_WARN
+
+
+class ToolsView(BaseView):
+    """Per-tool panels inside a CTkTabview."""
+
+    def build(self) -> None:
+        self.grid_columnconfigure(0, weight=1)
+        self.grid_rowconfigure(1, weight=1)
+
+        ctk.CTkLabel(self, text="Tools",
+                     font=ctk.CTkFont(size=22, weight="bold")).grid(
+            row=0, column=0, sticky="w", padx=24, pady=(20, 8))
+
+        self._tab_view = ctk.CTkTabview(self)
+        self._tab_view.grid(row=1, column=0, sticky="nsew", padx=16, pady=(0, 12))
+
+        # Per-tab group menu references so refresh() can repopulate them all
+        self._group_menus: list[tuple[ctk.CTkOptionMenu, ctk.StringVar]] = []
+
+        self._build_check_names_tab()
+        self._build_update_mods_tab()
+        self._build_link_mods_tab()
+        self._build_sync_missing_tab()
+        self._build_report_missing_tab()
+
+    # =========================================================================
+    # Public
+    # =========================================================================
+
+    def refresh(self) -> None:
+        groups     = self._get_groups()
+        all_groups = ["All groups"] + groups
+
+        # Repopulate generic group menus
+        for menu, var in self._group_menus:
+            prev = var.get()
+            menu.configure(values=all_groups)
+            if prev not in all_groups:
+                var.set("All groups")
+
+        # Link Mods group menu (no "All groups")
+        lm_prev = self._lm_group_var.get()
+        lm_vals = groups if groups else ["(no groups found)"]
+        self._lm_group_menu.configure(values=lm_vals)
+        if lm_prev not in lm_vals:
+            self._lm_group_var.set(lm_vals[0])
+        self._lm_on_change()   # re-evaluate button state
+
+        # Info labels
+        self._update_sm_label()
+        self._update_rm_label()
+
+    # =========================================================================
+    # Private — tab builders
+    # =========================================================================
+
+    def _build_check_names_tab(self) -> None:
+        self._tab_view.add("Check Names")
+        tab = self._tab_view.tab("Check Names")
+        tab.grid_columnconfigure(0, weight=1)
+
+        _desc(tab, row=0,
+              text="Scan mod folders and compare against the server. "
+                   "Reports naming mismatches (MISMATCH), unrecognised folders "
+                   "(NOT_ON_SERVER), and wrong Steam IDs in meta.cpp (ID_COLLISION).")
+
+        # Group
+        gf = _row(tab, row=1, label="Group:")
+        self._cn_group_var = ctk.StringVar(value="All groups")
+        menu = ctk.CTkOptionMenu(gf, variable=self._cn_group_var,
+                                 values=["All groups"], width=200)
+        menu.pack(side="left")
+        self._group_menus.append((menu, self._cn_group_var))
+
+        # Checkboxes
+        cf = _row(tab, row=2, label="Options:")
+        self._cn_fix_var     = ctk.BooleanVar(value=False)
+        self._cn_fix_ids_var = ctk.BooleanVar(value=False)
+        ctk.CTkCheckBox(cf, text="Auto-fix folder name mismatches  (--fix)",
+                        variable=self._cn_fix_var,
+                        command=self._cn_on_toggle).pack(side="left", padx=(0, 16))
+        ctk.CTkCheckBox(cf, text="Auto-fix wrong Steam IDs in meta.cpp  (--fix-ids)",
+                        variable=self._cn_fix_ids_var,
+                        command=self._cn_on_toggle).pack(side="left")
+
+        # Warning (hidden until checkbox ticked)
+        self._cn_warn = ctk.CTkLabel(
+            tab,
+            text="⚠  --fix renames folders and updates junctions.  "
+                 "--fix-ids rewrites meta.cpp files.",
+            text_color=_WARN_COLOR, anchor="w",
+        )
+        # not gridded yet — shown on demand
+
+        # Run button
+        ctk.CTkButton(tab, text="Run Check Names", width=180,
+                      command=self._cn_run).grid(
+            row=10, column=0, padx=24, pady=(16, 24), sticky="e")
+
+    def _cn_on_toggle(self) -> None:
+        if self._cn_fix_var.get() or self._cn_fix_ids_var.get():
+            self._cn_warn.grid(row=5, column=0, padx=24, pady=(4, 0), sticky="w")
+        else:
+            self._cn_warn.grid_forget()
+
+    def _cn_run(self) -> None:
+        args = ["check_names.py"]
+        g = self._cn_group_var.get()
+        if g != "All groups":
+            args += ["--group", g]
+        if self._cn_fix_var.get():
+            args.append("--fix")
+        if self._cn_fix_ids_var.get():
+            args.append("--fix-ids")
+        self._launch(args)
+
+    # -------------------------------------------------------------------------
+
+    def _build_update_mods_tab(self) -> None:
+        self._tab_view.add("Update Mods")
+        tab = self._tab_view.tab("Update Mods")
+        tab.grid_columnconfigure(0, weight=1)
+
+        _desc(tab, row=0,
+              text="Re-download mod files whose size on the server differs from "
+                   "your local copy.  Use --force to re-download everything "
+                   "regardless of size.")
+
+        # Group
+        gf = _row(tab, row=1, label="Group:")
+        self._um_group_var = ctk.StringVar(value="All groups")
+        um_menu = ctk.CTkOptionMenu(
+            gf, variable=self._um_group_var, values=["All groups"], width=200,
+            command=self._um_on_group_change,
+        )
+        um_menu.pack(side="left")
+        self._group_menus.append((um_menu, self._um_group_var))
+
+        # Mod name (enabled only when a specific group is selected)
+        mf = _row(tab, row=2, label="Mod folder:")
+        self._um_mod_entry = ctk.CTkEntry(
+            mf, placeholder_text="Optional — e.g. @ace", width=220,
+            state="disabled",
+        )
+        self._um_mod_entry.pack(side="left")
+        ctk.CTkLabel(mf, text="(only when a specific group is selected)",
+                     text_color="gray").pack(side="left", padx=8)
+
+        # Force checkbox
+        ff = _row(tab, row=3, label="Options:")
+        self._um_force_var = ctk.BooleanVar(value=False)
+        ctk.CTkCheckBox(
+            ff, text="Force re-download all files  (--force)",
+            variable=self._um_force_var,
+            command=self._um_on_toggle,
+        ).pack(side="left")
+
+        # Warning
+        self._um_warn = ctk.CTkLabel(
+            tab,
+            text="⚠  --force re-downloads every file regardless of size. "
+                 "This may transfer a large amount of data.",
+            text_color=_WARN_COLOR, anchor="w",
+        )
+
+        ctk.CTkButton(tab, text="Run Update", width=180,
+                      command=self._um_run).grid(
+            row=10, column=0, padx=24, pady=(16, 24), sticky="e")
+
+    def _um_on_group_change(self, _: str) -> None:
+        is_specific = self._um_group_var.get() != "All groups"
+        self._um_mod_entry.configure(state="normal" if is_specific else "disabled")
+        if not is_specific:
+            self._um_mod_entry.delete(0, "end")
+
+    def _um_on_toggle(self) -> None:
+        if self._um_force_var.get():
+            self._um_warn.grid(row=5, column=0, padx=24, pady=(4, 0), sticky="w")
+        else:
+            self._um_warn.grid_forget()
+
+    def _um_run(self) -> None:
+        args = ["update_mods.py"]
+        g = self._um_group_var.get()
+        if g != "All groups":
+            args += ["--group", g]
+        mod = self._um_mod_entry.get().strip()
+        if mod:
+            args += ["--mod", mod]
+        if self._um_force_var.get():
+            args.append("--force")
+        self._launch(args)
+
+    # -------------------------------------------------------------------------
+
+    def _build_link_mods_tab(self) -> None:
+        self._tab_view.add("Link Mods")
+        tab = self._tab_view.tab("Link Mods")
+        tab.grid_columnconfigure(0, weight=1)
+
+        _desc(tab, row=0,
+              text="Manage junction/symlink links between your downloads folder "
+                   "and the Arma 3 directory.\n"
+                   "Status — show what's linked.  "
+                   "Link — create missing junctions.  "
+                   "Unlink — remove junctions (mod files are NOT deleted).")
+
+        # Command selector
+        cf = _row(tab, row=1, label="Command:")
+        self._lm_cmd_var = ctk.StringVar(value="Status")
+        ctk.CTkSegmentedButton(
+            cf,
+            values=["Status", "Link", "Unlink"],
+            variable=self._lm_cmd_var,
+            command=self._lm_on_change,
+        ).pack(side="left")
+
+        # Group (required — no "All groups")
+        gf = _row(tab, row=2, label="Group:")
+        self._lm_group_var = ctk.StringVar(value="")
+        self._lm_group_menu = ctk.CTkOptionMenu(
+            gf, variable=self._lm_group_var,
+            values=["(no groups found)"], width=200,
+            command=lambda _: self._lm_on_change(),
+        )
+        self._lm_group_menu.pack(side="left")
+
+        # Warning (shown for Unlink)
+        self._lm_warn = ctk.CTkLabel(
+            tab,
+            text="⚠  Unlink removes junction links from the Arma 3 directory. "
+                 "Mod files in downloads/ are NOT deleted.",
+            text_color=_WARN_COLOR, anchor="w",
+        )
+
+        # Run button (label changes with command)
+        self._lm_run_btn = ctk.CTkButton(
+            tab, text="Show Status", width=180,
+            command=self._lm_run,
+        )
+        self._lm_run_btn.grid(row=10, column=0, padx=24, pady=(16, 24), sticky="e")
+
+    def _lm_on_change(self, _: str = "") -> None:
+        cmd = self._lm_cmd_var.get()
+        labels = {"Status": "Show Status", "Link": "Create Links", "Unlink": "Remove Links"}
+        self._lm_run_btn.configure(text=labels.get(cmd, cmd))
+
+        if cmd == "Unlink":
+            self._lm_warn.grid(row=5, column=0, padx=24, pady=(4, 0), sticky="w")
+        else:
+            self._lm_warn.grid_forget()
+
+    def _lm_run(self) -> None:
+        cmd   = self._lm_cmd_var.get().lower()
+        group = self._lm_group_var.get()
+
+        if not group or group == "(no groups found)":
+            messagebox.showwarning("No group selected",
+                                   "Please select a group from the dropdown.")
+            return
+
+        args = ["link_mods.py", cmd, "--group", group]
+
+        if cmd == "unlink":
+            confirmed = messagebox.askyesno(
+                "Confirm Unlink",
+                f"Remove junction links for group '{group}'?\n\n"
+                "This removes links from the Arma 3 directory but does NOT delete "
+                "mod files in downloads/.",
+            )
+            if not confirmed:
+                return
+            args.append("--yes")
+
+        self._launch(args)
+
+    # -------------------------------------------------------------------------
+
+    def _build_sync_missing_tab(self) -> None:
+        self._tab_view.add("Sync Missing")
+        tab = self._tab_view.tab("Sync Missing")
+        tab.grid_columnconfigure(0, weight=1)
+
+        _desc(tab, row=0,
+              text="Retry downloading mods that were missing from the server "
+                   "when you last ran the pipeline. "
+                   "Checks the server again and downloads any that have since appeared.")
+
+        self._sm_info = ctk.CTkLabel(tab, text="", text_color="gray", anchor="w")
+        self._sm_info.grid(row=1, column=0, padx=24, pady=(4, 0), sticky="w")
+
+        ctk.CTkButton(tab, text="Run Sync Missing", width=180,
+                      command=lambda: self._launch(["sync_missing.py"])).grid(
+            row=10, column=0, padx=24, pady=(16, 24), sticky="e")
+
+    def _update_sm_label(self) -> None:
+        cfg = self.app.cfg
+        if not cfg:
+            self._sm_info.configure(text="")
+            return
+        report_path = cfg.missing_report if hasattr(cfg, "missing_report") else (
+            cfg.modlist_json / "missing_report.json"
+            if hasattr(cfg, "modlist_json") else None
+        )
+        if report_path and report_path.exists():
+            try:
+                data  = json.loads(report_path.read_text(encoding="utf-8"))
+                count = data.get("missing", len(data.get("missing_mods", [])))
+                self._sm_info.configure(
+                    text=f"{count} mod(s) currently listed as missing.")
+                return
+            except Exception:
+                pass
+        self._sm_info.configure(
+            text="No missing_report.json found — run the pipeline first.")
+
+    # -------------------------------------------------------------------------
+
+    def _build_report_missing_tab(self) -> None:
+        self._tab_view.add("Report Missing")
+        tab = self._tab_view.tab("Report Missing")
+        tab.grid_columnconfigure(0, weight=1)
+
+        _desc(tab, row=0,
+              text="Check which mods from comparison.json are absent from the "
+                   "file server. Saves missing_report.json so you can track what "
+                   "still needs to be added to the server.")
+
+        self._rm_info = ctk.CTkLabel(tab, text="", text_color="gray", anchor="w")
+        self._rm_info.grid(row=1, column=0, padx=24, pady=(4, 0), sticky="w")
+
+        ctk.CTkButton(tab, text="Generate Report", width=180,
+                      command=lambda: self._launch(["report_missing.py"])).grid(
+            row=10, column=0, padx=24, pady=(16, 24), sticky="e")
+
+    def _update_rm_label(self) -> None:
+        cfg = self.app.cfg
+        if not cfg:
+            self._rm_info.configure(text="")
+            return
+        report_path = cfg.missing_report if hasattr(cfg, "missing_report") else (
+            cfg.modlist_json / "missing_report.json"
+            if hasattr(cfg, "modlist_json") else None
+        )
+        if report_path and report_path.exists():
+            try:
+                data = json.loads(report_path.read_text(encoding="utf-8"))
+                ts   = data.get("generated_at", "unknown")
+                self._rm_info.configure(text=f"Last generated: {ts}")
+                return
+            except Exception:
+                pass
+        self._rm_info.configure(text="No report yet.")
+
+    # =========================================================================
+    # Private — helpers
+    # =========================================================================
+
+    def _get_groups(self) -> list[str]:
+        cfg = self.app.cfg
+        if cfg and cfg.downloads.is_dir():
+            return sorted(p.name for p in cfg.downloads.iterdir() if p.is_dir())
+        # Fallback: read comparison.json
+        if cfg and cfg.comparison.exists():
+            try:
+                comp = json.loads(cfg.comparison.read_text(encoding="utf-8"))
+                return ["shared"] + list(comp.get("unique", {}).keys())
+            except Exception:
+                pass
+        return []
+
+    def _launch(self, args: list[str]) -> None:
+        self.app.navigate_to("Logs")
+        self.app.run_tool(args)
+
+
+# ---------------------------------------------------------------------------
+# Layout helpers
+# ---------------------------------------------------------------------------
+
+def _desc(parent, row: int, text: str) -> ctk.CTkLabel:
+    lbl = ctk.CTkLabel(parent, text=text, justify="left",
+                       wraplength=700, text_color="gray", anchor="w")
+    lbl.grid(row=row, column=0, padx=24, pady=(16, 8), sticky="ew")
+    return lbl
+
+
+def _row(parent, row: int, label: str) -> ctk.CTkFrame:
+    """A label + horizontal frame for a settings row."""
+    ctk.CTkLabel(parent, text=label, anchor="w", width=110).grid(
+        row=row, column=0, padx=(24, 0), pady=6, sticky="w")
+    f = ctk.CTkFrame(parent, fg_color="transparent")
+    f.grid(row=row, column=0, padx=(140, 24), pady=6, sticky="w")
+    return f