Release v1.4.2

Downloads

macOS (Universal) - Supports both Apple Silicon and Intel

Option 1: Installation Script (Recommended)

Install with a single command (version v1.4.2):

curl -fsSL https://raw.githubusercontent.com/Leadaxe/singbox-launcher/develop/scripts/install-macos.sh | bash -s -- v1.4.2

The script will:

• Download the release archive
• Extract and install to /Applications/
• Fix macOS quarantine attributes and permissions
• Launch the application automatically

Option 2: Manual Installation

1. Download: singbox-launcher-v1.4.2-macos.zip
2. Extract the ZIP file
3. Remove quarantine attribute (required):

   xattr -cr "singbox-launcher.app" && chmod +x "singbox-launcher.app/Contents/MacOS/singbox-launcher"

4. Double-click singbox-launcher.app to run
   • If macOS blocks the app, go to System Settings → Privacy & Security and click "Open Anyway"
   • Alternatively, right-click the app and select "Open" (first time only)

Windows (amd64)

1. Download: singbox-launcher-v1.4.2-win64.zip
2. Extract the ZIP file to a folder, for example: C:\Program Files\singbox-launcher\
3. Run singbox-launcher.exe from that folder
   • You may need administrator rights to install to Program Files
   • The launcher will automatically download sing-box and wintun.dll on first launch

Windows 7 (x86, legacy)

1. Download: singbox-launcher-v1.4.2-win7-32.zip
2. Extract the ZIP file to a folder and run singbox-launcher-win7-32.exe
   • For Windows 7 / 32-bit or legacy compatibility only

Linux Support

⚠️ Linux build temporarily unavailable - мы ищем тестировщика для ручного тестирования перед включением автоматической сборки.

Checksums

See checksums.txt for SHA256 checksums of all files.

v1.4.2

EN

Highlights

• The window now opens over RDP and on GPU-less servers/VMs (issue #105). The launcher UI needs OpenGL 2.1+, but an RDP session on Windows Server without a GPU only provides the "GDI Generic" OpenGL 1.1 — the window silently failed to render while the tray stayed alive. On Windows the launcher now probes the OpenGL version before starting the UI; when hardware OpenGL 2.1 is missing, a native dialog offers to download the Mesa3D (llvmpipe) software renderer (~24 MB) from this repository's mesa3d-26.2.0 release (ghproxy fallback for networks where GitHub is blocked). The DLLs are extracted next to singbox-launcher.exe and the window renders immediately — no restart needed. On subsequent starts the Windows loader picks the local opengl32.dll by itself and the probe is skipped. Manual install stays possible for offline servers — see docs/RDP_OPENGL.md.
• Rollback: delete opengl32.dll, libgallium_wgl.dll, dxil.dll from the launcher folder. Escape hatches: SINGBOX_LAUNCHER_NO_MESA=1 disables the probe entirely, SINGBOX_LAUNCHER_FORCE_MESA=1 forces the offer (debugging aid).

Technical / Internal

• Internal -gl-probe flag: the launcher re-runs itself to measure the WGL version in a subprocess, so the parent process never loads the system opengl32.dll and can preload Mesa by full path (the Windows loader then reuses the module by base name for GLFW's LoadLibrary("opengl32.dll")). The gate runs before the first Fyne window is created.
• Win7 32-bit build: no auto-install (modern Mesa needs Windows 10+) — a native dialog points to the manual docs/WIN7_OPENGL.md guide instead.
• Docs: docs/DAEMON_AND_REMOTE(.ru).md caught up with SPEC 100 (Remote in Debug API: stateless addressing, deploy parity, snapshot streams, raw passthrough, /daemon/*, capabilities manifest) and the 1.4.1 Remote-tab fixes (Restart ↻, node-list self-healing, resilient gRPC streams).

RU

Основное

• Окно теперь открывается по RDP и на серверах/ВМ без GPU (issue #105). UI лаунчера нужен OpenGL 2.1+, а RDP-сессия на Windows Server без GPU отдаёт только «GDI Generic» OpenGL 1.1 — окно молча не отрисовывалось, живым оставался лишь трей. Теперь на Windows лаунчер проверяет версию OpenGL до старта UI; если аппаратного 2.1 нет, нативный диалог предлагает скачать программный рендерер Mesa3D (llvmpipe, ~24 МБ) с релиза mesa3d-26.2.0 этого репозитория (фолбэк через ghproxy для сетей, где GitHub заблокирован). DLL распаковываются рядом с singbox-launcher.exe, окно отрисовывается сразу — перезапуск не нужен. На следующих стартах локальный opengl32.dll подхватывает сам загрузчик Windows, проверка пропускается. Ручная установка остаётся для серверов без интернета — см. docs/RDP_OPENGL.ru.md.
• Откат: удалить opengl32.dll, libgallium_wgl.dll, dxil.dll из папки лаунчера. Служебные переменные: SINGBOX_LAUNCHER_NO_MESA=1 полностью отключает проверку, SINGBOX_LAUNCHER_FORCE_MESA=1 принудительно предлагает установку (для отладки).

Техническое / Внутреннее

• Служебный флаг -gl-probe: лаунчер перезапускает сам себя и меряет WGL-версию в подпроцессе — родительский процесс не грузит системный opengl32.dll и может подгрузить Mesa по полному пути (дальше загрузчик Windows переиспользует модуль по базовому имени для GLFW-шного LoadLibrary("opengl32.dll")). Гейт отрабатывает до создания первого окна Fyne.
• Win7 32-bit сборка: автозагрузки нет (современной Mesa нужна Windows 10+) — вместо этого нативный диалог со ссылкой на ручную инструкцию docs/WIN7_OPENGL.ru.md.
• Docs: docs/DAEMON_AND_REMOTE(.ru).md догнал SPEC 100 (Remote в Debug API: stateless-адресация, паритет деплоя, снапшот-стримы, raw passthrough, /daemon/*, манифест capabilities) и фиксы вкладки Remote из 1.4.1 (Restart ↻, самолечение списка узлов, живучие gRPC-подписки).