livedesk 0.1.591 → 0.1.593

package/bootstrap/client-process-identity.js

@@ -25,7 +25,7 @@ export function isKnownLiveDeskClientAgentProcess(processName, commandLine, exec
   // Linux TASK_COMM_LEN exposes a 15-character `comm`, so the native apphost
   // appears as `livedesk-client`. Accept that truncated name only when an
   // independently resolved executable path, or argv[0], proves the canonical
-  // packaged LiveDesk Fast binary. A matching path elsewhere in argv is not
+  // packaged VuvoDesk Fast binary. A matching path elsewhere in argv is not
   // sufficient.
   const isTruncatedLinuxFast = /^livedesk-client$/i.test(normalizedName);
   const isKnownNodeAgent = /(?:node_modules\/(?:livedesk\/client|@livedesk\/client)|packages\/(?:livedesk\/client|client))\/bin\/livedesk-client-node\.js(?:\s|["']|$)/i.test(normalizedCommandLine);

package/bootstrap/device-role.js

@@ -112,7 +112,7 @@ export function writeRoleCache(resolved, options = {}) {
   const role = normalizeRole(resolved?.role);
   const deviceId = normalizeDeviceId(resolved?.deviceId);
   if (!role || !deviceId) {
-    throw new Error('A valid device role and device id are required to write the LiveDesk role cache.');
+    throw new Error('A valid device role and device id are required to write the VuvoDesk role cache.');
   }
   const paths = getRoleStatePaths(options);
   writeJson(paths.rolePath, {

package/bootstrap/legacy-client-update.js

@@ -89,7 +89,7 @@ function safePathSegment(value, fallback = 'unknown') {
 export class LegacyClientUpdateSupersededError extends Error {
   constructor(expectedOperationId, actualOperationId) {
     super(
-      `LiveDesk Client update ${expectedOperationId || 'unknown'} was superseded by `
+      `VuvoDesk Client update ${expectedOperationId || 'unknown'} was superseded by `
       + `${actualOperationId || 'another operation'}.`
     );
     this.name = 'LegacyClientUpdateSupersededError';
@@ -114,7 +114,7 @@ export function assertLegacyClientUpdateDeadline(
 ) {
   const deadlineEpochMs = Number(config?.updateDeadlineEpochMs);
   if (!Number.isSafeInteger(deadlineEpochMs) || deadlineEpochMs <= 0) {
-    const error = new Error('LiveDesk Client update has no valid absolute deadline.');
+    const error = new Error('VuvoDesk Client update has no valid absolute deadline.');
     error.code = DEADLINE_EXPIRED_CODE;
     error.deadlineExpired = true;
     throw error;
@@ -122,7 +122,7 @@ export function assertLegacyClientUpdateDeadline(
   const currentEpochMs = Number(now());
   if (currentEpochMs < deadlineEpochMs) return deadlineEpochMs - currentEpochMs;
   const error = new Error(
-    `LiveDesk Client update deadline expired before ${checkpoint} `
+    `VuvoDesk Client update deadline expired before ${checkpoint} `
     + `(deadline=${new Date(deadlineEpochMs).toISOString()}).`
   );
   error.code = DEADLINE_EXPIRED_CODE;
@@ -140,14 +140,14 @@ export function getLegacyClientUpdateNeutralCwd(stateDir, operationId) {
 
 function prepareNeutralCwd(cwd) {
   const configuredCwd = String(cwd || '').trim();
-  if (!configuredCwd) throw new Error('LiveDesk update neutral working directory is unavailable');
+  if (!configuredCwd) throw new Error('VuvoDesk update neutral working directory is unavailable');
   const neutralCwd = resolve(configuredCwd);
   mkdirSync(neutralCwd, { recursive: true });
   const unexpectedEntry = readdirSync(neutralCwd)[0];
   if (unexpectedEntry) {
     const shadowPath = join(neutralCwd, unexpectedEntry);
     throw new Error(
-      `LiveDesk update neutral working directory is shadowed by ${shadowPath}: ${neutralCwd}`
+      `VuvoDesk update neutral working directory is shadowed by ${shadowPath}: ${neutralCwd}`
     );
   }
   return neutralCwd;
@@ -472,7 +472,7 @@ export function readLegacyProcessArguments(pid, platform = process.platform) {
   if (platform === 'darwin' || platform === 'linux' || platform === 'freebsd') {
     return processArgumentsFromPs(processId);
   }
-  throw new Error(`LiveDesk cannot snapshot Client arguments on ${platform}`);
+  throw new Error(`VuvoDesk cannot snapshot Client arguments on ${platform}`);
 }
 
 function readOptionValue(args, index, joinUntilFlag) {
@@ -579,7 +579,7 @@ function captureRestartConfiguration(config, env, readArguments = readLegacyProc
     agentArgs = readArguments(config.agentPid);
   } catch (error) {
     throw new Error(
-      `LiveDesk could not freeze the current Client options before update; `
+      `VuvoDesk could not freeze the current Client options before update; `
       + `the existing Client was left running. ${error?.message || error}`
     );
   }
@@ -637,7 +637,7 @@ export function resolveExactLocalRestoreLauncher(config, env, frozen) {
     };
   }
   throw new Error(
-    `LiveDesk could not freeze an exact local restore artifact for `
+    `VuvoDesk could not freeze an exact local restore artifact for `
     + `${config.currentProductVersion}/${config.currentAgentVersion}; the existing Client was left running.`
   );
 }
@@ -716,7 +716,7 @@ export function withLegacyClientUpdateStateLock(
       if (error?.code !== 'EEXIST') throw error;
       if (removeAbandonedUpdateStateLock(lockPath, aliveImpl, now)) continue;
       if (now() >= deadline) {
-        throw new Error(`Timed out waiting for the LiveDesk update state lock: ${lockPath}`);
+        throw new Error(`Timed out waiting for the VuvoDesk update state lock: ${lockPath}`);
       }
       waitForUpdateStateLock(Math.min(Math.max(1, pollMs), Math.max(1, deadline - now())));
     }
@@ -1008,7 +1008,7 @@ function resolveNpxInvocation(args, env = process.env) {
     : [env.LIVEDESK_NPX_EXECUTABLE, join(nodeDirectory, 'npx'), 'npx'];
   const npx = executableCandidates.find(candidate => candidate && (!candidate.includes('/') && !candidate.includes('\\') || existsSync(candidate)))
     || executableCandidates.at(-1);
-  if (!npx) throw new Error('LiveDesk npx executable was not found');
+  if (!npx) throw new Error('VuvoDesk npx executable was not found');
   if (process.platform !== 'win32') return { command: npx, args };
 
   const quote = value => `"${String(value).replaceAll('"', '""')}"`;
@@ -1021,7 +1021,7 @@ function resolveNpxInvocation(args, env = process.env) {
 export function prefetchExactNpxRestore(config, env = process.env, options = {}) {
   const version = cleanVersion(config?.currentProductVersion);
   if (!version) {
-    throw new Error('LiveDesk cannot prefetch an exact restore without the current product version.');
+    throw new Error('VuvoDesk cannot prefetch an exact restore without the current product version.');
   }
   const neutralCwd = prepareNeutralCwd(config?.neutralCwd);
   const packageSpec = `livedesk@${version}`;
@@ -1057,7 +1057,7 @@ export function prefetchExactNpxRestore(config, env = process.env, options = {})
   const output = `${result?.stdout || ''}\n${result?.stderr || ''}`.trim();
   if (result?.error || result?.status !== 0) {
     throw new Error(
-      `LiveDesk could not prefetch exact restore package livedesk@${version}; `
+      `VuvoDesk could not prefetch exact restore package livedesk@${version}; `
       + `the existing Client was left running. `
       + `${result?.error?.message || output || `exit=${result?.status ?? 'unknown'}`}`
     );
@@ -1068,7 +1068,7 @@ export function prefetchExactNpxRestore(config, env = process.env, options = {})
     .filter(Boolean);
   if (!reportedVersions.includes(version)) {
     throw new Error(
-      `LiveDesk exact restore preflight returned an unexpected version for livedesk@${version}; `
+      `VuvoDesk exact restore preflight returned an unexpected version for livedesk@${version}; `
       + `the existing Client was left running. Output: ${output || '(empty)'}`
     );
   }
@@ -1147,7 +1147,7 @@ function hasLegacyConnectedOutput(outputPath, deviceId) {
   const escapedDeviceId = String(deviceId || '').replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
   if (!escapedDeviceId) return false;
   return new RegExp(
-    `Connected to LiveDesk Hub as [^\\r\\n]*\\(${escapedDeviceId}\\)(?:\\s+via\\s+\\S+)?`
+    `Connected to VuvoDesk Hub as [^\\r\\n]*\\(${escapedDeviceId}\\)(?:\\s+via\\s+\\S+)?`
   ).test(output);
 }
 
@@ -1246,7 +1246,7 @@ async function terminateReplacementTree(child) {
     }
     const result = await drainOwnedWindowsAgentTreeUntilStopped(child, {
       reportTerminationFailure: message => console.error(
-        `[LiveDesk update] ${message}`
+        `[VuvoDesk update] ${message}`
       )
     });
     if (result?.ok === false) {

package/bootstrap/role-bootstrap-server.js

@@ -228,7 +228,7 @@ export function createRoleBootstrapServer(options = {}) {
     const filePath = resolve(webDist, requested);
     if (!filePath.startsWith(`${webDist}${process.platform === 'win32' ? '\\' : '/'}`) || !existsSync(filePath)) {
       res.writeHead(404, { 'Content-Type': 'text/plain; charset=utf-8' });
-      res.end('LiveDesk bootstrap web build is not available. Run npm run build.');
+      res.end('VuvoDesk bootstrap web build is not available. Run npm run build.');
       return;
     }
     res.writeHead(200, { 'Content-Type': requested.endsWith('.js') ? 'text/javascript; charset=utf-8' : requested.endsWith('.css') ? 'text/css; charset=utf-8' : 'text/html; charset=utf-8', 'Cache-Control': requested === 'index.html' ? 'no-store' : 'public, max-age=3600' });
@@ -253,7 +253,7 @@ export function createRoleBootstrapServer(options = {}) {
           return;
         }
         if (url.pathname === '/api/health') {
-          sendJson(req, res, 200, { ok: true, product: 'LiveDesk', role: 'bootstrap' }, port);
+          sendJson(req, res, 200, { ok: true, product: 'LiveDesk', role: 'bootstrap' }, port);
           return;
         }
         if (url.pathname === '/api/bootstrap/status' || url.pathname === '/api/runtime/status' || url.pathname === '/api/runtime') {

package/bootstrap/runtime-lock.js

@@ -48,14 +48,14 @@ function releaseOwnedLock(path, payload) {
 function updateOwnedLockRole(path, payload, nextRole) {
   const role = String(nextRole || '').trim().toLowerCase();
   if (!['hub', 'client'].includes(role)) {
-    throw new Error(`Unsupported LiveDesk runtime-lock role: ${role || '<empty>'}.`);
+    throw new Error(`Unsupported VuvoDesk runtime-lock role: ${role || '<empty>'}.`);
   }
   const current = readLock(path);
   if (Number(current?.pid) !== Number(payload?.pid)
     || current?.ownerToken !== payload?.ownerToken
     || current?.ownerInstanceMarker !== payload?.ownerInstanceMarker
     || current?.ownerStartOrder !== payload?.ownerStartOrder) {
-    throw new Error('LiveDesk runtime-lock ownership changed before its role could be updated.');
+    throw new Error('VuvoDesk runtime-lock ownership changed before its role could be updated.');
   }
   if (current.role === role) {
     payload.role = role;
@@ -80,7 +80,7 @@ function updateOwnedLockRole(path, payload, nextRole) {
       || revalidated?.ownerInstanceMarker !== payload.ownerInstanceMarker
       || revalidated?.ownerStartOrder !== payload.ownerStartOrder
       || revalidated?.role !== current.role) {
-      throw new Error('LiveDesk runtime-lock ownership changed during its role update.');
+      throw new Error('VuvoDesk runtime-lock ownership changed during its role update.');
     }
     // The path remains continuously present: contenders observe either the old
     // live role or the new live role, never a missing-lock acquisition window.
@@ -278,7 +278,7 @@ export function acquireRuntimeLock({
         acquired: false,
         path,
         existing: existing || existingTakeover,
-        error: new Error('LiveDesk runtime lock takeover is already in progress.')
+        error: new Error('VuvoDesk runtime lock takeover is already in progress.')
       };
     }
   }

package/bootstrap/runtime-shutdown.js

@@ -154,15 +154,15 @@ export function startRuntimeShutdownWatcher({
   pollMs = DEFAULT_RUNTIME_SHUTDOWN_POLL_MS,
   now = () => Date.now(),
   reportError = error => console.warn(
-    `[LiveDesk] Cooperative shutdown mailbox warning: ${error?.message || error}`
+    `[VuvoDesk] Cooperative shutdown mailbox warning: ${error?.message || error}`
   )
 } = {}) {
   const exactOwner = normalizeOwner(owner);
   if (!exactOwner) {
-    throw new Error('A cooperative LiveDesk shutdown watcher requires an exact runtime-lock owner.');
+    throw new Error('A cooperative VuvoDesk shutdown watcher requires an exact runtime-lock owner.');
   }
   if (typeof onShutdown !== 'function') {
-    throw new Error('A cooperative LiveDesk shutdown watcher requires an onShutdown handler.');
+    throw new Error('A cooperative VuvoDesk shutdown watcher requires an onShutdown handler.');
   }
 
   const paths = getRuntimeShutdownPaths(stateDir);

package/bootstrap/update-host-client.mjs

@@ -132,7 +132,7 @@ export function sendUpdateHostRequest({
   const target = String(endpoint || '').trim();
   const secret = String(token || '').trim();
   if (!target || !/^[a-f0-9]{64}$/i.test(secret)) {
-    return Promise.reject(new Error('LiveDesk Update Host endpoint or token is unavailable.'));
+    return Promise.reject(new Error('VuvoDesk Update Host endpoint or token is unavailable.'));
   }
   const request = JSON.stringify({
     protocolVersion: UPDATE_HOST_PROTOCOL_VERSION,
@@ -140,7 +140,7 @@ export function sendUpdateHostRequest({
     ...message
   });
   if (Buffer.byteLength(request, 'utf8') > UPDATE_HOST_MAX_MESSAGE_BYTES) {
-    return Promise.reject(new Error('LiveDesk Update Host request exceeded its bounded message size.'));
+    return Promise.reject(new Error('VuvoDesk Update Host request exceeded its bounded message size.'));
   }
   const boundedTimeoutMs = clampMilliseconds(
     timeoutMs,
@@ -163,13 +163,13 @@ export function sendUpdateHostRequest({
       else resolveRequest(value);
     };
     const timeout = setTimeout(() => {
-      finish(new Error(`LiveDesk Update Host request timed out after ${boundedTimeoutMs}ms.`));
+      finish(new Error(`VuvoDesk Update Host request timed out after ${boundedTimeoutMs}ms.`));
     }, boundedTimeoutMs);
     socket.once('connect', () => socket.write(`${request}\n`));
     socket.on('data', chunk => {
       responseText += chunk;
       if (Buffer.byteLength(responseText, 'utf8') > UPDATE_HOST_MAX_MESSAGE_BYTES) {
-        finish(new Error('LiveDesk Update Host response exceeded its bounded message size.'));
+        finish(new Error('VuvoDesk Update Host response exceeded its bounded message size.'));
       }
     });
     socket.once('error', error => finish(error));
@@ -178,7 +178,7 @@ export function sendUpdateHostRequest({
       try {
         const response = JSON.parse(responseText || '{}');
         if (response?.ok === false) {
-          const error = new Error(String(response.error || 'LiveDesk Update Host rejected the request.'));
+          const error = new Error(String(response.error || 'VuvoDesk Update Host rejected the request.'));
           error.code = String(response.code || 'LIVEDESK_UPDATE_HOST_REJECTED');
           error.response = response;
           finish(error);
@@ -186,7 +186,7 @@ export function sendUpdateHostRequest({
         }
         finish(null, response);
       } catch (error) {
-        finish(new Error(`LiveDesk Update Host returned invalid JSON: ${error.message}`));
+        finish(new Error(`VuvoDesk Update Host returned invalid JSON: ${error.message}`));
       }
     });
   });
@@ -309,7 +309,7 @@ export async function ensureUpdateHost({
     return {
       available: false,
       disabled: false,
-      error: `LiveDesk Update Host entry is unavailable: ${entry || '<empty>'}`,
+      error: `VuvoDesk Update Host entry is unavailable: ${entry || '<empty>'}`,
       paths
     };
   }
@@ -360,7 +360,7 @@ export async function ensureUpdateHost({
   return {
     available: false,
     disabled: false,
-    error: `LiveDesk Update Host did not become ready within ${boundedStartTimeoutMs}ms.`,
+    error: `VuvoDesk Update Host did not become ready within ${boundedStartTimeoutMs}ms.`,
     paths,
     spawnedPid: Number(child?.pid || 0),
     observedStatus: lastStatus
@@ -396,7 +396,7 @@ function currentHostConnection(hostResult) {
 
 export async function submitUpdateHostJob(hostResult, job, options = {}) {
   if (!hostResult?.available) {
-    throw new Error(hostResult?.error || 'LiveDesk Update Host is unavailable.');
+    throw new Error(hostResult?.error || 'VuvoDesk Update Host is unavailable.');
   }
   const connection = currentHostConnection(hostResult);
   return sendUpdateHostRequest({

package/bootstrap/update-host.mjs

@@ -37,7 +37,7 @@ function decodeStateDir() {
 const sourceVersion = argumentValue('--source-version');
 const replacePid = Number(argumentValue('--replace-pid') || 0);
 const stateDir = decodeStateDir();
-if (!stateDir) throw new Error('LiveDesk Update Host requires a state directory.');
+if (!stateDir) throw new Error('VuvoDesk Update Host requires a state directory.');
 const paths = getUpdateHostPaths(stateDir);
 const workingDirectory = prepareUpdateHostWorkingDirectory(paths.stateDir);
 process.chdir(workingDirectory);
@@ -396,7 +396,7 @@ function startJob(value) {
   const validatedJob = validateJob(value);
   if (currentJob && ['accepted', 'running'].includes(currentJob.state)) {
     if (currentJob.jobId === validatedJob.jobId && currentJob.operationId === validatedJob.operationId) return currentJob;
-    const error = new Error(`LiveDesk Update Host is busy with ${currentJob.operationId}.`);
+    const error = new Error(`VuvoDesk Update Host is busy with ${currentJob.operationId}.`);
     error.code = 'LIVEDESK_UPDATE_HOST_BUSY';
     throw error;
   }
@@ -458,11 +458,11 @@ function send(socket, payload) {
 async function handleMessage(socket, message) {
   requestCount += 1;
   if (message?.protocolVersion !== UPDATE_HOST_PROTOCOL_VERSION) {
-    send(socket, { ok: false, code: 'LIVEDESK_UPDATE_HOST_PROTOCOL_MISMATCH', error: 'LiveDesk Update Host protocol mismatch.' });
+    send(socket, { ok: false, code: 'LIVEDESK_UPDATE_HOST_PROTOCOL_MISMATCH', error: 'VuvoDesk Update Host protocol mismatch.' });
     return;
   }
   if (!tokensMatch(message?.token)) {
-    send(socket, { ok: false, code: 'LIVEDESK_UPDATE_HOST_UNAUTHORIZED', error: 'LiveDesk Update Host token mismatch.' });
+    send(socket, { ok: false, code: 'LIVEDESK_UPDATE_HOST_UNAUTHORIZED', error: 'VuvoDesk Update Host token mismatch.' });
     return;
   }
   switch (String(message?.type || '')) {
@@ -498,7 +498,7 @@ async function handleMessage(socket, message) {
     }
     case 'stop-host': {
       if (currentJob && ['accepted', 'running'].includes(currentJob.state)) {
-        send(socket, { ok: false, code: 'LIVEDESK_UPDATE_HOST_BUSY', error: 'LiveDesk Update Host cannot stop during an update.' });
+        send(socket, { ok: false, code: 'LIVEDESK_UPDATE_HOST_BUSY', error: 'VuvoDesk Update Host cannot stop during an update.' });
         return;
       }
       stopping = true;
@@ -508,7 +508,7 @@ async function handleMessage(socket, message) {
       return;
     }
     default:
-      send(socket, { ok: false, code: 'LIVEDESK_UPDATE_HOST_UNKNOWN_REQUEST', error: 'Unknown LiveDesk Update Host request.' });
+      send(socket, { ok: false, code: 'LIVEDESK_UPDATE_HOST_UNKNOWN_REQUEST', error: 'Unknown VuvoDesk Update Host request.' });
   }
 }
 

package/client/README.md

@@ -1,6 +1,6 @@
-# LiveDesk Client
+# VuvoDesk Client
 
-For normal users, run the unified LiveDesk application:
+For normal users, run the unified VuvoDesk application:
 
 ```powershell
 npx -y --prefer-online livedesk@latest
@@ -20,7 +20,7 @@ aligned.
 The default flow lets the local Client runtime own Google authorization,
 callback exchange, and saved authentication as one path. The browser only
 shows progress; it does not maintain a second session that must be transferred
-back to the Client. LiveDesk then waits for the active Hub published by the
+back to the Client. VuvoDesk then waits for the active Hub published by the
 same account and connects locally. If the Hub is not
 ready yet, the client waits for a Hub-online event and polls the registry at
 most every six seconds as a fallback. Missing a wake event can never leave a
@@ -34,10 +34,10 @@ On Windows, check **Start with Windows** on the connection page to reconnect thi
 client automatically after reboot. The startup entry reuses the saved Google
 session and only opens the connection page again if sign-in is needed.
 
-On the Hub computer, open the LiveDesk dashboard, sign in, and run **Sync
+On the Hub computer, open the VuvoDesk dashboard, sign in, and run **Sync
 Server** once. The dashboard transfers the signed-in session to the local Hub;
 the Hub process then keeps its own local address and private pair token
-refreshed in the LiveDesk Supabase registry. The dashboard can be closed after
+refreshed in the VuvoDesk Supabase registry. The dashboard can be closed after
 that while the Hub remains running.
 
 Supabase Auth must allow the CLI callback URL:
@@ -55,12 +55,12 @@ can receive safe task-only instructions. The C# RemoteFast engine also supports
 keyboard/mouse control on Windows, macOS, and Linux/X11, file transfer, and
 system-audio playback from Windows, macOS, and Linux. Linux captures the default
 output through PipeWire `pw-record` or PulseAudio `parec`. macOS control requires Accessibility
-permission for the terminal app that started LiveDesk; screen streaming and
-system-audio capture require Screen Recording permission. LiveDesk checks these
+permission for the terminal app that started VuvoDesk; screen streaming and
+system-audio capture require Screen Recording permission. VuvoDesk checks these
 permissions without opening repeated system dialogs and prints the matching
 System Settings path when access is missing; after granting access, restart the
 client. When file transfer is enabled by the Hub, received files are saved
-to `Desktop/LiveDeskFiles` unless the Hub sets another destination folder.
+to `Desktop/VuvoDeskFiles` unless the Hub sets another destination folder.
 
 By default, the launcher uses the packaged C# RemoteFast engine when supported.
 It falls back to the Node engine only when a compatible RemoteFast runtime is
@@ -80,7 +80,7 @@ npx -y --prefer-online livedesk@latest client 3
 npx -y --prefer-online livedesk@latest client --no-thumbnail
 npx -y --prefer-online livedesk@latest client --no-live
 npx -y --prefer-online livedesk@latest client --no-audio
-npx -y --prefer-online livedesk@latest client --files-dir "D:\LiveDeskFiles"
+npx -y --prefer-online livedesk@latest client --files-dir "D:\VuvoDeskFiles"
 npx -y --prefer-online livedesk@latest client --engine node
 npx -y --prefer-online livedesk@latest client --engine fast --trace-frames
 npx -y --prefer-online livedesk@latest client --auth-port 5200
@@ -91,7 +91,7 @@ Frame pipeline roadmap:
 
 - Mode 1: `mode1-jpeg` - current test path using screen capture, resize, and JPEG binary frames.
 - Mode 2: `mode2-lzo` - cross-platform wall path using independent RGB565LE frames capped at 320x180 and compressed as LZO1X blocks. The wall defaults to 8 fps. macOS and Linux keep one persistent local capture helper per client process. Legacy `mode2-lz4` settings migrate to this mode.
-- Mode 3: `mode3-h264-hw` - OS-specific H.264 path. Windows tries Media Foundation/NVENC/QSV/AMF, macOS prefers ScreenCaptureKit plus VideoToolbox, and Linux tries NVENC/VAAPI/QSV before falling back to the bundled ffmpeg `libx264` encoder. Linux users do not need to install ffmpeg separately when starting LiveDesk through the published npm package. macOS emits one startup key frame and then an approximately half-second recovery GOP. The launcher uses bundled ffmpeg for fallback paths unless `LIVEDESK_FFMPEG` points to a custom binary. On macOS, set `LIVEDESK_FFMPEG_AVFOUNDATION_INPUT` only when the ScreenCaptureKit helper is unavailable and the AVFoundation fallback input is not `1:none`.
+- Mode 3: `mode3-h264-hw` - OS-specific H.264 path. Windows tries Media Foundation/NVENC/QSV/AMF, macOS prefers ScreenCaptureKit plus VideoToolbox, and Linux tries NVENC/VAAPI/QSV before falling back to the bundled ffmpeg `libx264` encoder. Linux users do not need to install ffmpeg separately when starting VuvoDesk through the published npm package. macOS emits one startup key frame and then an approximately half-second recovery GOP. The launcher uses bundled ffmpeg for fallback paths unless `LIVEDESK_FFMPEG` points to a custom binary. On macOS, set `LIVEDESK_FFMPEG_AVFOUNDATION_INPUT` only when the ScreenCaptureKit helper is unavailable and the AVFoundation fallback input is not `1:none`.
 
 Legacy mode names such as `remote-fast` and `remote-quality` are treated as
 Mode 1 aliases.

package/client/THIRD_PARTY_NOTICES.md

@@ -2,7 +2,7 @@
 
 ## lzokay
 
-LiveDesk's LZO1X block encoder and decoder follow the instruction layout of
+VuvoDesk's LZO1X block encoder and decoder follow the instruction layout of
 [lzokay](https://github.com/AxioDL/lzokay), Copyright (c) 2018 Jack Andersen.
 
 The MIT License

package/client/bin/client-version.js

@@ -19,5 +19,5 @@ export function formatClientVersionBanner(env = process.env) {
     const launcherVersion = String(env.LIVEDESK_NPM_LAUNCHER_VERSION || '').trim();
     const productName = launcherName || 'livedesk';
     const productVersion = launcherVersion || readClientPackageVersion();
-    return `[LiveDesk Client] ${productName}@${productVersion}`;
+    return `[VuvoDesk Client] ${productName}@${productVersion}`;
 }