feat(launcher): add auto-update, fix proxy UX, and prevent editing running profiles (#96)

mykola-zalizniak · web-flow · commit 14a3e0593b8d · 2026-03-08T12:55:34.000-04:00
* refactor: rename BotBrowserConsole to BotBrowserLauncher

* feat: add kernel management, proxy management, and setup scripts

* fix: enable macOS native Edit menu for Cmd+C/V/X/A keyboard shortcuts

* chore: upgrade Neutralino runtime to 6.4.0

* chore: remove Neutralino binaries from repo, download via neu update

* fix: improve macOS clipboard support with JS fallback for Cmd+V paste

* fix: expand macOS clipboard fallback to Cmd+C/X, auto-download Neutralino via postinstall

* chore: upgrade Neutralino to 6.5.0 and simplify setup scripts

* fix: fix PowerShell setup script ZIP download corruption

* feat: enhance proxy workflow with IP check, quick change, and reusable input component

* fix: correct checkbox color override and setup script stdin handling

* feat: improve profile deletion with auto-stop, group WebRTC settings, prioritize custom exec path

* feat: add port protection toggle, fix kernel auto-update cleanup and UI refresh

* fix: detect kernel assets by file extension to support renamed Windows/Linux packages

* fix: handle non-browser process exits, add crash detection, validate kernel executable paths

* docs: add --bot-time-seed documentation, changelog 2026-03-03, value range and per-context cross-links

* feat: add proxy save/check, improve table layout and kernel date display

- Add "Save to proxy list" button in proxy input for reusing manually entered proxies
- Add batch proxy connectivity check with IP/status display in proxy management
- Sort proxy list by creation time (newest first)
- Fix kernel date display: parse from asset filename, fix timezone offset bug
- Simplify profile status column to icon-only (play/stop) with tooltips
- Remove year from "Last Launch" date to prevent truncation
- Widen window to 1080px, use fixed table layout to prevent horizontal scrollbar
- Add column width constraints for profile and proxy tables

* feat: redesign profile editor with left nav, advanced config modes, and new fields

- Add left-side anchor navigation with scrollspy (IntersectionObserver)
- Split Fingerprint into separate Noise and Rendering sections
- Replace expansion panel with flat Advanced section layout
- Add mode toggles for Executable (kernel/custom), Cookies and Bookmarks (file/input)
- Add FPS dropdown (profile/real/custom number) instead of free-text input
- Add Save IP button in proxy section for explicit IP saving
- Add new fields: Time Seed, Proxy Bypass Regex, Cookies, Bookmarks, Custom Headers
- Put username/password on same row in proxy input
- Widen status column to prevent icon clipping

* fix: replace Save IP with Save to proxy list, unify dropdown option labels

* fix: include username and password in proxy duplicate detection

Normalize both sides with `|| ''` to handle undefined values, and add
password to the comparison so proxies with the same host:port but
different credentials are treated as distinct entries.

* fix: prevent editing running profiles and remove auto-save IP on proxy check

- Block profile editing when browser is running/launching/stopping,
  show alert dialog instead of silently darkening the background
- Remove onIpCheckResult that auto-saved checked IP to proxyIp field

* feat(launcher): add automatic self-update with GitHub commit tracking

Check for launcher updates on startup and every hour by comparing
the local commit hash against the latest launcher-specific commit
from GitHub API (path=launcher). When an update is found, silently
download, rebuild, and prompt the user to restart.

- Add UpdateService with periodic check, ZIP download, and rebuild
- Show update status (checking/downloading/building/ready) in sidebar
- Display current version (commit hash) at sidebar bottom
- Update setup scripts to save commit hash after install/build
- Fix sidebar footer layout to stay at bottom via flex container
diff --git a/launcher/scripts/setup-macos.sh b/launcher/scripts/setup-macos.sh
@@ -191,6 +191,20 @@ create_shortcuts() {
     fi
 }
 
+save_commit_hash() {
+    echo "Saving launcher version info..."
+    local commit_dir="$HOME/Library/Application Support/BotBrowser"
+    mkdir -p "$commit_dir"
+    local sha
+    sha=$(curl -fsSL -H "Accept: application/vnd.github.v3+json" "https://api.github.com/repos/botswin/BotBrowser/commits?path=launcher&sha=main&per_page=1" 2>/dev/null | grep '"sha"' | head -1 | sed 's/.*"sha": *"\([^"]*\)".*/\1/')
+    if [ -n "$sha" ]; then
+        printf '%s' "$sha" > "$commit_dir/launcher-commit"
+        echo "  Version: ${sha:0:7}"
+    else
+        echo "  Warning: Could not save version info."
+    fi
+}
+
 launch_application() {
     echo "Starting BotBrowser Launcher..."
     cd "$DIST_DIR"
@@ -216,6 +230,7 @@ if [ -f "$EXE_PATH" ]; then
         install_nodejs
         install_repository
         build_application
+        save_commit_hash
         create_shortcuts
         launch_application
     else
@@ -226,6 +241,7 @@ else
     install_nodejs
     install_repository
     build_application
+    save_commit_hash
     create_shortcuts
     launch_application
 fi
diff --git a/launcher/scripts/setup-ubuntu.sh b/launcher/scripts/setup-ubuntu.sh
@@ -109,6 +109,20 @@ Categories=Utility;Network;"
     echo "Desktop shortcut created: $DESKTOP_FILE"
 }
 
+save_commit_hash() {
+    echo "Saving launcher version info..."
+    local commit_dir="$HOME/.config/BotBrowser"
+    mkdir -p "$commit_dir"
+    local sha
+    sha=$(curl -fsSL -H "Accept: application/vnd.github.v3+json" "https://api.github.com/repos/botswin/BotBrowser/commits?path=launcher&sha=main&per_page=1" 2>/dev/null | grep '"sha"' | head -1 | sed 's/.*"sha": *"\([^"]*\)".*/\1/')
+    if [ -n "$sha" ]; then
+        printf '%s' "$sha" > "$commit_dir/launcher-commit"
+        echo "  Version: ${sha:0:7}"
+    else
+        echo "  Warning: Could not save version info."
+    fi
+}
+
 launch_application() {
     echo "Starting BotBrowser Launcher..."
     cd "$DIST_DIR"
@@ -137,6 +151,7 @@ if [ -f "$EXE_PATH" ]; then
         install_nodejs
         install_repository
         build_application
+        save_commit_hash
         create_desktop_shortcut
         launch_application
     else
@@ -147,6 +162,7 @@ else
     install_nodejs
     install_repository
     build_application
+    save_commit_hash
     create_desktop_shortcut
     launch_application
 fi
diff --git a/launcher/scripts/setup.ps1 b/launcher/scripts/setup.ps1
@@ -97,6 +97,22 @@ function New-Shortcuts {
     Write-Host "  Start Menu shortcut: $STARTMENU_SHORTCUT" -ForegroundColor Green
 }
 
+function Save-CommitHash {
+    Write-Host "Saving launcher version info..." -ForegroundColor Yellow
+    $commitDir = "$env:APPDATA\BotBrowser"
+    if (!(Test-Path $commitDir)) {
+        New-Item -ItemType Directory -Path $commitDir | Out-Null
+    }
+    try {
+        $ProgressPreference = 'SilentlyContinue'
+        $response = Invoke-RestMethod -Uri "https://api.github.com/repos/botswin/BotBrowser/commits?path=launcher&sha=main&per_page=1" -Headers @{ Accept = "application/vnd.github.v3+json" } -UseBasicParsing
+        $response[0].sha | Out-File -FilePath "$commitDir\launcher-commit" -Encoding utf8 -NoNewline
+        Write-Host "  Version: $($response[0].sha.Substring(0, 7))" -ForegroundColor Green
+    } catch {
+        Write-Host "  Warning: Could not save version info." -ForegroundColor Yellow
+    }
+}
+
 function Start-Application {
     Write-Host "Starting BotBrowser Launcher..." -ForegroundColor Green
     Start-Process -FilePath $EXE_PATH -WorkingDirectory $DIST_DIR
@@ -121,6 +137,7 @@ if (Test-Path $EXE_PATH) {
         Install-NodeJS
         Install-Repository
         Build-Application
+        Save-CommitHash
         New-Shortcuts
         Start-Application
     } else {
@@ -131,6 +148,7 @@ if (Test-Path $EXE_PATH) {
     Install-NodeJS
     Install-Repository
     Build-Application
+    Save-CommitHash
     New-Shortcuts
     Start-Application
 }
diff --git a/launcher/src/app/app.component.html b/launcher/src/app/app.component.html
@@ -17,6 +17,54 @@
         </mat-nav-list>
 
         <div class="sidenav-footer">
+            @switch (updateService.status()) {
+                @case ('checking') {
+                    <div class="download-progress">
+                        <div class="download-info">
+                            <mat-icon>sync</mat-icon>
+                            <span class="download-text">Checking for launcher update...</span>
+                        </div>
+                        <mat-progress-bar mode="indeterminate"></mat-progress-bar>
+                    </div>
+                }
+                @case ('downloading') {
+                    <div class="download-progress">
+                        <div class="download-info">
+                            <mat-icon>download</mat-icon>
+                            <span class="download-text">Downloading launcher update...</span>
+                        </div>
+                        <mat-progress-bar mode="indeterminate"></mat-progress-bar>
+                    </div>
+                }
+                @case ('building') {
+                    <div class="download-progress">
+                        <div class="download-info">
+                            <mat-icon>build</mat-icon>
+                            <span class="download-text">Building launcher update...</span>
+                        </div>
+                        <mat-progress-bar mode="indeterminate"></mat-progress-bar>
+                    </div>
+                }
+                @case ('ready') {
+                    <div class="download-progress update-ready">
+                        <div class="download-info">
+                            <mat-icon>update</mat-icon>
+                            <span class="download-text">Update ready.</span>
+                        </div>
+                        <button mat-flat-button color="primary" class="restart-button" (click)="restartApp()">
+                            Restart Now
+                        </button>
+                    </div>
+                }
+                @case ('error') {
+                    <div class="download-progress">
+                        <div class="download-error" [matTooltip]="updateService.errorMessage()">
+                            <mat-icon>error</mat-icon>
+                            <span class="error-text">Launcher update failed</span>
+                        </div>
+                    </div>
+                }
+            }
             @if (kernelService.isAutoUpdating()) {
                 <div class="download-progress">
                     <div class="download-info">
@@ -64,6 +112,9 @@
                     }
                 </div>
             }
+            @if (updateService.currentVersion()) {
+                <div class="version-label">v{{ updateService.currentVersion() }}</div>
+            }
         </div>
     </mat-sidenav>
 
diff --git a/launcher/src/app/app.component.scss b/launcher/src/app/app.component.scss
@@ -6,11 +6,14 @@
 
 .sidenav {
     width: 200px;
-    display: flex;
-    flex-direction: column;
     background: #0f172a;
     color: white;
 
+    ::ng-deep .mat-drawer-inner-container {
+        display: flex;
+        flex-direction: column;
+    }
+
     .sidenav-header {
         padding: 16px;
         font-size: 18px;
@@ -59,6 +62,7 @@
     }
 
     .sidenav-footer {
+        margin-top: auto;
         padding: 12px;
 
         .download-progress {
@@ -123,6 +127,21 @@
                 height: 4px;
                 border-radius: 2px;
             }
+
+            &.update-ready {
+                .restart-button {
+                    width: 100%;
+                    margin-top: 4px;
+                    font-size: 12px;
+                }
+            }
+        }
+
+        .version-label {
+            font-size: 11px;
+            color: rgba(255, 255, 255, 0.4);
+            text-align: center;
+            padding-top: 8px;
         }
     }
 }
diff --git a/launcher/src/app/app.component.ts b/launcher/src/app/app.component.ts
@@ -24,9 +24,11 @@ import { EditBrowserProfileComponent } from './edit-browser-profile.component';
 import { KernelManagementComponent } from './kernel-management/kernel-management.component';
 import { ProxyManagementComponent } from './proxy-management/proxy-management.component';
 import { QuickProxyChangeComponent } from './quick-proxy-change.component';
+import { AlertDialogComponent } from './shared/alert-dialog.component';
 import { BrowserLauncherService } from './shared/browser-launcher.service';
 import { BrowserProfileService } from './shared/browser-profile.service';
 import { ConfirmDialogComponent } from './shared/confirm-dialog.component';
+import { UpdateService } from './shared/update.service';
 import { KernelService } from './shared/kernel.service';
 import { StopPropagationDirective } from './shared/stop-propagation.directive';
 import { compressFolder, decompressZip, formatDateTime, formatProxyDisplay } from './utils';
@@ -63,6 +65,7 @@ export class AppComponent implements AfterViewInit {
     readonly #browserProfileService = inject(BrowserProfileService);
     readonly browserLauncherService = inject(BrowserLauncherService);
     readonly kernelService = inject(KernelService);
+    readonly updateService = inject(UpdateService);
 
     readonly AppName = AppName;
     readonly #dialog = inject(MatDialog);
@@ -113,6 +116,13 @@ export class AppComponent implements AfterViewInit {
     }
 
     editProfile(browserProfile: BrowserProfile): void {
+        const status = this.browserLauncherService.getRunningStatus(browserProfile);
+        if (status !== BrowserProfileStatus.Idle && status !== BrowserProfileStatus.LaunchFailed) {
+            this.#dialog.open(AlertDialogComponent, {
+                data: { message: 'Cannot edit a profile while it is running. Please stop the browser first.' },
+            });
+            return;
+        }
         this.#dialog
             .open(EditBrowserProfileComponent, {
                 width: '860px',
@@ -289,6 +299,12 @@ export class AppComponent implements AfterViewInit {
         await this.refreshProfiles();
         // Start kernel auto-update and auto-download tasks in the background
         this.kernelService.performStartupTasks().catch(console.error);
+        // Check for launcher updates: once now, then every hour
+        this.updateService.startPeriodicCheck();
+    }
+
+    restartApp(): void {
+        Neutralino.app.restartProcess();
     }
 
     get isAllSelected(): boolean {
diff --git a/launcher/src/app/edit-browser-profile.component.html b/launcher/src/app/edit-browser-profile.component.html
@@ -90,7 +90,6 @@ <h2 mat-dialog-title>{{ isEdit ? 'Edit' : 'Create' }} Browser Profile</h2>
                 [showCheckButton]="true"
                 [showSaveButton]="true"
                 (valueChange)="onProxyValueChange($event)"
-                (ipCheckResult)="onIpCheckResult($event)"
                 (saveToList)="onSaveProxyToList($event)"
             />
 
diff --git a/launcher/src/app/edit-browser-profile.component.ts b/launcher/src/app/edit-browser-profile.component.ts
@@ -44,7 +44,6 @@ import { AlertDialogComponent } from './shared/alert-dialog.component';
 import { BrowserLauncherService } from './shared/browser-launcher.service';
 import { BrowserProfileService } from './shared/browser-profile.service';
 import { ConfirmDialogComponent } from './shared/confirm-dialog.component';
-import type { ProxyCheckResult } from './shared/proxy-check.service';
 import { ProxyInputComponent } from './shared/proxy-input.component';
 import { ProxyParserService, type ParsedProxy } from './shared/proxy-parser.service';
 import { ProxyService } from './shared/proxy.service';
@@ -367,10 +366,6 @@ export class EditBrowserProfileComponent implements OnInit, AfterViewInit, OnDes
         this.selectedProxyId = '';
     }
 
-    onIpCheckResult(result: ProxyCheckResult): void {
-        this.proxyConfigGroup.patchValue({ proxyIp: result.ip });
-    }
-
     async onSaveProxyToList(proxy: ParsedProxy): Promise<void> {
         const duplicate = this.proxies.find(
             (p) => p.host === proxy.host && p.port === proxy.port && (p.username || '') === (proxy.username || '') && (p.password || '') === (proxy.password || '')
diff --git a/launcher/src/app/shared/update.service.ts b/launcher/src/app/shared/update.service.ts
