v1.9.24: honor OPENCUT_HOST / OPENCUT_PORT / OPENCUT_DEBUG env vars

SysAdminDoc · SysAdminDoc · commit 93b86bef0d4c · 2026-04-11T18:43:53.000-04:00
Binary smoke-test caught a real regression: OPENCUT_PORT=5789
./OpenCut-Server.exe silently ignored the env var and always bound to
5679, because server.main() only read argparse flags with hardcoded
defaults. CLAUDE.md had long advertised env-based config.

Fix: read env vars first, then use them as argparse defaults. CLI
flags still override env. Values are clamped: port must be 1-65535,
non-integer values fall back to 5679. OPENCUT_DEBUG accepts
1/true/yes/on.

Now docker-compose and the VBS launcher can configure the backend
entirely via env vars without passing CLI flags.
diff --git a/CLAUDE.md b/CLAUDE.md
@@ -181,7 +181,7 @@
 - Lint: `ruff check opencut/` — codebase is fully clean, pre-commit enforces on every commit
 
 ## Version
-- Current: **v1.9.23**
+- Current: **v1.9.24**
 - All version strings: `pyproject.toml`, `__init__.py`, `CSXS/manifest.xml` (ExtensionBundleVersion + Version), `com.opencut.uxp/manifest.json`, `com.opencut.uxp/main.js` (VERSION const), `index.html` version display, README badge, `package.json`
 - Use `python scripts/sync_version.py --set X.Y.Z` to update all 19 targets at once (including UXP files and package.json)
 - Use `python scripts/sync_version.py --check` in CI to verify all targets match
@@ -1067,6 +1067,13 @@ Comprehensive multi-phase audit across all 138 files (~82,500 lines). 103 issues
 - **4 new UXP Video features** — AI Upscale, Scene Detection, Style Transfer, Shorts Pipeline. Full HTML cards + JS handlers with job polling.
 - **UXP stale version fixed** — Settings showed "1.9.2" hardcoded. Now synced via version script.
 
+## v1.9.24 Env-var config (`OPENCUT_PORT` / `OPENCUT_HOST` / `OPENCUT_DEBUG`)
+Found during a binary smoke test — `OPENCUT_PORT=5789 ./OpenCut-Server.exe` silently ignored the env var and always bound to 5679. CLAUDE.md had long advertised env-based config, but `opencut/server.py::main()` only read `argparse` flags with hardcoded defaults. Fixed so that:
+- `OPENCUT_HOST` (default `127.0.0.1`)
+- `OPENCUT_PORT` (default 5679, clamped to 1–65535, falls back on non-int)
+- `OPENCUT_DEBUG` (default off; accepts `1`/`true`/`yes`/`on`)
+…are all read first, then argparse uses them as defaults (CLI flags still override). Docker-compose and the VBS launcher can now configure the backend entirely via env vars.
+
 ## v1.9.23 UXP a11y polish (Round-2 follow-up)
 Follow-up commit on top of v1.9.22 that lands the remaining accessibility and
 utility-class fixes found during the second audit round:
diff --git a/Install.ps1 b/Install.ps1
@@ -155,7 +155,7 @@ Write-Host "  \___/| .__/ \___|_| |_|\____\__,_|\__|" -ForegroundColor Cyan
 Write-Host "       |_|                               " -ForegroundColor Cyan
 Write-Host ""
 Write-Host "  Open Source Video Editing Automation" -ForegroundColor DarkGray
-Write-Host "  Installer v1.9.23" -ForegroundColor DarkGray
+Write-Host "  Installer v1.9.24" -ForegroundColor DarkGray
 
 $isAdmin = Test-IsAdmin
 if ($isAdmin) {
diff --git a/OpenCut.iss b/OpenCut.iss
@@ -2,7 +2,7 @@
 ; Fully self-contained installer — bundles server exe, ffmpeg, and CEP extension
 
 #define MyAppName "OpenCut"
-#define MyAppVersion "1.9.23"
+#define MyAppVersion "1.9.24"
 #define MyAppPublisher "SysAdminDoc"
 #define MyAppURL "https://github.com/SysAdminDoc/OpenCut"
 
diff --git a/extension/com.opencut.panel/CSXS/manifest.xml b/extension/com.opencut.panel/CSXS/manifest.xml
@@ -2,11 +2,11 @@
 <ExtensionManifest xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                    Version="7.0"
                    ExtensionBundleId="com.opencut.panel"
-                   ExtensionBundleVersion="1.9.23"
+                   ExtensionBundleVersion="1.9.24"
                    ExtensionBundleName="OpenCut">
 
     <ExtensionList>
-        <Extension Id="com.opencut.panel.main" Version="1.9.23" />
+        <Extension Id="com.opencut.panel.main" Version="1.9.24" />
     </ExtensionList>
 
     <ExecutionEnvironment>
diff --git a/extension/com.opencut.panel/client/index.html b/extension/com.opencut.panel/client/index.html
@@ -3524,7 +3524,7 @@ <h3 class="media-sidecar-title">No media in the workspace yet.</h3>
                     <div class="card-header"><div class="card-title" data-i18n="settings.about">About OpenCut</div></div>
                     <div class="settings-row">
                         <span class="settings-label">Version</span>
-                        <span class="settings-value">1.9.23</span>
+                        <span class="settings-value">1.9.24</span>
                     </div>
                     <div class="about-links">
                         <a href="https://github.com/SysAdminDoc/opencut" class="about-link" target="_blank">GitHub</a>
diff --git a/extension/com.opencut.panel/client/main.js b/extension/com.opencut.panel/client/main.js
@@ -1,5 +1,5 @@
 /* ============================================================
-   OpenCut CEP Panel - Main Controller v1.9.23
+   OpenCut CEP Panel - Main Controller v1.9.24
    6-Tab Professional Toolkit
    ============================================================ */
 (function () {
diff --git a/extension/com.opencut.panel/client/style.css b/extension/com.opencut.panel/client/style.css
@@ -1,5 +1,5 @@
 /* ============================================================
-   OpenCut CEP Panel v1.9.23 - ULTRA PREMIUM EDITION
+   OpenCut CEP Panel v1.9.24 - ULTRA PREMIUM EDITION
    Next-Generation AI Editing Suite for Adobe Premiere Pro
    ============================================================ */
 
diff --git a/extension/com.opencut.panel/package.json b/extension/com.opencut.panel/package.json
@@ -1,6 +1,6 @@
 {
   "name": "opencut-panel",
-  "version": "1.9.23",
+  "version": "1.9.24",
   "private": true,
   "description": "OpenCut CEP Panel for Adobe Premiere Pro",
   "scripts": {
diff --git a/extension/com.opencut.uxp/index.html b/extension/com.opencut.uxp/index.html
@@ -16,7 +16,7 @@
           <path d="M4 2.5a3 3 0 00-1.76 5.43L7.33 11l-5.09 3.07A3 3 0 104.8 19.5a3 3 0 001.76-5.43L8.93 12.6 16.5 17V5L8.93 9.4 6.56 7.93A3 3 0 004 2.5z" fill="var(--accent)"/>
         </svg>
         <span class="oc-logo">OpenCut</span>
-        <span class="oc-version">v1.9.23</span>
+        <span class="oc-version">v1.9.24</span>
       </div>
       <div class="oc-header-right">
         <div class="oc-connection" id="connectionStatus" title="Backend connection status">
diff --git a/extension/com.opencut.uxp/main.js b/extension/com.opencut.uxp/main.js
@@ -26,7 +26,7 @@ const HEALTH_CHECK_MS  = 8000;
 const HEALTH_MAX_MS    = 60000;
 const MEDIA_SCAN_MS    = 30000;
 const SSE_AVAILABLE    = typeof EventSource !== "undefined";
-const VERSION          = "1.9.23";
+const VERSION          = "1.9.24";
 
 async function detectBackend() {
   // Try ports 5679-5689 like CEP panel does
diff --git a/extension/com.opencut.uxp/manifest.json b/extension/com.opencut.uxp/manifest.json
@@ -1,7 +1,7 @@
 {
   "id": "com.opencut.uxp",
   "name": "OpenCut UXP",
-  "version": "1.9.23",
+  "version": "1.9.24",
   "main": "index.html",
   "host": [
     {
diff --git a/install.py b/install.py
@@ -10,7 +10,7 @@
 import subprocess
 import platform
 
-VERS = "1.9.23"
+VERS = "1.9.24"
 CEP_EXT = "com.opencut.panel"
 WIN_CEP_DIR = os.path.expandvars(r"%APPDATA%\Adobe\CEP\extensions")
 MAC_CEP_DIR = os.path.expanduser("~/Library/Application Support/Adobe/CEP/extensions")
diff --git a/installer/src/OpenCut.Installer/Models/AppConstants.cs b/installer/src/OpenCut.Installer/Models/AppConstants.cs
@@ -3,7 +3,7 @@ namespace OpenCut.Installer.Models;
 public static class AppConstants
 {
     public const string AppName = "OpenCut";
-    public const string AppVersion = "1.9.23";
+    public const string AppVersion = "1.9.24";
     public const string AppDisplayName = $"{AppName} v{AppVersion}";
     public const string AppPublisher = "SysAdminDoc";
     public const string AppUrl = "https://github.com/SysAdminDoc/OpenCut";
diff --git a/installer/src/OpenCut.Installer/OpenCut.Installer.csproj b/installer/src/OpenCut.Installer/OpenCut.Installer.csproj
@@ -7,8 +7,8 @@
     <RootNamespace>OpenCut.Installer</RootNamespace>
     <AssemblyName>OpenCut-Setup</AssemblyName>
     <ApplicationIcon>Assets\logo.ico</ApplicationIcon>
-    <Version>1.9.23</Version>
-    <FileVersion>1.9.23.0</FileVersion>
+    <Version>1.9.24</Version>
+    <FileVersion>1.9.24.0</FileVersion>
     <AssemblyVersion>1.3.0.0</AssemblyVersion>
     <Company>SysAdminDoc</Company>
     <Product>OpenCut Installer</Product>
diff --git a/installer/src/OpenCut.Installer/Properties/app.manifest b/installer/src/OpenCut.Installer/Properties/app.manifest
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <assembly manifestVersion="1.0" xmlns="urn:schemas-microsoft-com:asm.v1">
-  <assemblyIdentity version="1.9.23.0" name="OpenCut.Installer" />
+  <assemblyIdentity version="1.9.24.0" name="OpenCut.Installer" />
   <trustInfo xmlns="urn:schemas-microsoft-com:asm.v2">
     <security>
       <requestedPrivileges xmlns="urn:schemas-microsoft-com:asm.v3">
diff --git a/opencut/__init__.py b/opencut/__init__.py
@@ -5,6 +5,6 @@
 and more. Exports Premiere Pro / DaVinci Resolve / FCP XML.
 """
 
-__version__ = "1.9.23"
+__version__ = "1.9.24"
 __author__ = "OpenCut Contributors"
 __license__ = "MIT"
diff --git a/opencut/server.py b/opencut/server.py
@@ -763,13 +763,31 @@ def __init__(self, *args, **kwargs):
 
 
 def main():
-    """Entry point for `opencut-server` console script (pyproject.toml)."""
+    """Entry point for `opencut-server` console script (pyproject.toml).
+
+    CLI flags override env vars; env vars override the built-in defaults.
+    Supported env vars:
+        OPENCUT_HOST   — bind address (default 127.0.0.1)
+        OPENCUT_PORT   — listen port (default 5679)
+        OPENCUT_DEBUG  — enable Flask debug mode when set to "true"/"1"
+    """
     try:
         import argparse
+
+        # Env var defaults — let docker-compose / launchers configure without --flags.
+        env_host = os.environ.get("OPENCUT_HOST", "127.0.0.1").strip() or "127.0.0.1"
+        try:
+            env_port = int(os.environ.get("OPENCUT_PORT", "5679"))
+            if not (1 <= env_port <= 65535):
+                env_port = 5679
+        except ValueError:
+            env_port = 5679
+        env_debug = os.environ.get("OPENCUT_DEBUG", "").strip().lower() in ("1", "true", "yes", "on")
+
         parser = argparse.ArgumentParser(description="OpenCut Backend Server")
-        parser.add_argument("--host", default="127.0.0.1", help="Host to bind to")
-        parser.add_argument("--port", type=int, default=5679, help="Port to listen on")
-        parser.add_argument("--debug", action="store_true", help="Enable debug mode")
+        parser.add_argument("--host", default=env_host, help="Host to bind to")
+        parser.add_argument("--port", type=int, default=env_port, help="Port to listen on")
+        parser.add_argument("--debug", action="store_true", default=env_debug, help="Enable debug mode")
         parser.add_argument("--download-models", nargs="?", const="base", default=None,
                             metavar="MODEL",
                             help="Download Whisper model (tiny/base/small/medium/large-v3/turbo)")
diff --git a/pyproject.toml b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "opencut"
-version = "1.9.23"
+version = "1.9.24"
 description = "Open-source AI video editing automation for Adobe Premiere Pro - captions, audio processing, visual effects, and more"
 readme = "README.md"
 license = {text = "MIT"}
diff --git a/requirements.txt b/requirements.txt
@@ -1,4 +1,4 @@
-# OpenCut v1.9.23 Requirements
+# OpenCut v1.9.24 Requirements
 # Install: pip install -r requirements.txt
 # For GPU: pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu121
 

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "opencut-panel",`
`3`		`- "version": "1.9.23",`
	`3`	`+ "version": "1.9.24",`
`4`	`4`	`"private": true,`
`5`	`5`	`"description": "OpenCut CEP Panel for Adobe Premiere Pro",`
`6`	`6`	`"scripts": {`