@iamsamuelrodda/dictate 2026.5.18-1

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@iamsamuelrodda/dictate",
+  "version": "2026.5.18-1",
+  "description": "Installer shim for Dictate desktop dictation.",
+  "license": "MIT",
+  "type": "module",
+  "homepage": "https://github.com/arcforgelabs/dictate#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/arcforgelabs/dictate.git"
+  },
+  "bugs": {
+    "url": "https://github.com/arcforgelabs/dictate/issues"
+  },
+  "bin": {
+    "dictate-install": "npm/dictate-lifecycle.mjs",
+    "dictate-update": "npm/dictate-lifecycle.mjs",
+    "dictate-uninstall": "npm/dictate-lifecycle.mjs"
+  },
+  "files": [
+    "install.ps1",
+    "update.ps1",
+    "install-windows.ps1",
+    "install-windows-wizard.ps1",
+    "update-windows.ps1",
+    "uninstall.ps1",
+    "uninstall-windows.ps1",
+    "install.sh",
+    "update.sh",
+    "uninstall.sh",
+    "config/default-config.yaml",
+    "assets/dictate.ico",
+    "assets/dictate.png",
+    "assets/dictate-listening.ico",
+    "assets/dictate-listening.png",
+    "npm/",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "pack:check": "npm pack --dry-run"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/uninstall-windows.ps1

@@ -0,0 +1,83 @@
+param(
+    [switch]$Quiet,
+    [switch]$RemoveUserData
+)
+
+$ErrorActionPreference = "Stop"
+
+function Remove-IfExists {
+    param([string]$Path)
+    if (Test-Path $Path) {
+        Remove-Item -Force -Path $Path
+    }
+}
+
+function Stop-DictateProcesses {
+    $currentPid = $PID
+    $matches = Get-CimInstance Win32_Process |
+        Where-Object {
+            $_.ProcessId -ne $currentPid -and (
+                $_.Name -in @("dictate.exe", "dictate-controls.exe") -or
+                $_.CommandLine -like '*dictate.exe* --type-backend pynput*' -or
+                $_.CommandLine -like '*pythonw.exe* -m dictate --type-backend pynput*' -or
+                $_.CommandLine -like '*dictate-daemon.cmd*' -or
+                $_.CommandLine -like '*dictate-controls*'
+            )
+        }
+    foreach ($match in $matches) {
+        Stop-Process -Id $match.ProcessId -Force -ErrorAction SilentlyContinue
+    }
+    Start-Sleep -Milliseconds 500
+}
+
+$programsDir = Join-Path $env:APPDATA "Microsoft\Windows\Start Menu\Programs"
+if (-not $env:APPDATA) {
+    $programsDir = Join-Path $HOME "AppData\Roaming\Microsoft\Windows\Start Menu\Programs"
+}
+$startupDir = Join-Path $programsDir "Startup"
+
+Remove-IfExists -Path (Join-Path $programsDir "Dictate.lnk")
+Remove-IfExists -Path (Join-Path $programsDir "Dictate Controls.lnk")
+Remove-IfExists -Path (Join-Path $startupDir "Dictate.lnk")
+
+$uninstallKey = "HKCU:\Software\Microsoft\Windows\CurrentVersion\Uninstall\Dictate"
+if (Test-Path $uninstallKey) {
+    Remove-Item -Recurse -Force -Path $uninstallKey
+}
+
+Stop-DictateProcesses
+
+$venvDir = Join-Path $PSScriptRoot ".venv"
+if (Test-Path $venvDir) {
+    Remove-Item -Recurse -Force -Path $venvDir
+}
+
+$localAppData = $env:LOCALAPPDATA
+if (-not $localAppData) {
+    $localAppData = Join-Path $HOME "AppData\Local"
+}
+$appData = $env:APPDATA
+if (-not $appData) {
+    $appData = Join-Path $HOME "AppData\Roaming"
+}
+$dataDir = Join-Path $localAppData "dictate"
+$configDir = Join-Path $appData "dictate"
+
+if ($RemoveUserData) {
+    if (Test-Path $dataDir) {
+        Remove-Item -Recurse -Force -Path $dataDir
+    }
+    if (Test-Path $configDir) {
+        Remove-Item -Recurse -Force -Path $configDir
+    }
+}
+
+if (-not $Quiet) {
+    Write-Host "Dictate shortcuts, startup entry, app registration, and runtime venv removed."
+    if ($RemoveUserData) {
+        Write-Host "User config/data removed."
+    } else {
+        Write-Host "User config/data preserved. Re-run with -RemoveUserData to remove it."
+    }
+    Write-Host "Install source files were left in place: $PSScriptRoot"
+}

package/uninstall.ps1

@@ -0,0 +1,51 @@
+param(
+    [string]$InstallRoot,
+    [switch]$Quiet,
+    [switch]$RemoveUserData
+)
+
+$ErrorActionPreference = "Stop"
+
+if (-not $InstallRoot) {
+    $base = $env:LOCALAPPDATA
+    if (-not $base) {
+        $base = Join-Path $HOME "AppData\Local"
+    }
+    $InstallRoot = Join-Path $base "Dictate"
+}
+
+$installRootPath = [System.IO.Path]::GetFullPath($InstallRoot)
+$sourceDir = Join-Path $installRootPath "source"
+$uninstaller = Join-Path $sourceDir "uninstall-windows.ps1"
+
+if (Test-Path $uninstaller) {
+    $args = @("-NoProfile", "-ExecutionPolicy", "Bypass", "-File", $uninstaller)
+    if ($Quiet) { $args += "-Quiet" }
+    if ($RemoveUserData) { $args += "-RemoveUserData" }
+    & powershell @args
+    if ($LASTEXITCODE -ne 0) {
+        throw "Dictate Windows uninstaller failed with exit code $LASTEXITCODE."
+    }
+} else {
+    if (-not $Quiet) {
+        Write-Host "Dictate source uninstaller not found: $uninstaller"
+        Write-Host "Removing known Start Menu, startup, and Installed Apps entries."
+    }
+    $programsDir = Join-Path $env:APPDATA "Microsoft\Windows\Start Menu\Programs"
+    if (-not $env:APPDATA) {
+        $programsDir = Join-Path $HOME "AppData\Roaming\Microsoft\Windows\Start Menu\Programs"
+    }
+    Remove-Item -Force -ErrorAction SilentlyContinue -Path `
+        (Join-Path $programsDir "Dictate.lnk"), `
+        (Join-Path $programsDir "Dictate Controls.lnk"), `
+        (Join-Path $programsDir "Startup\Dictate.lnk")
+    Remove-Item -Recurse -Force -ErrorAction SilentlyContinue -Path "HKCU:\Software\Microsoft\Windows\CurrentVersion\Uninstall\Dictate"
+}
+
+if (Test-Path $installRootPath) {
+    Remove-Item -Recurse -Force -Path $installRootPath
+}
+
+if (-not $Quiet) {
+    Write-Host "Dictate removed from: $installRootPath"
+}

package/uninstall.sh

@@ -0,0 +1,92 @@
+#!/usr/bin/env bash
+# Remove Dictate launchers/autostart and installed runtime files.
+set -euo pipefail
+
+INSTALL_DIR="$HOME/.local/share/dictate"
+BIN_PATH="$HOME/.local/bin/dictate"
+DESKTOP_DIR="${XDG_DATA_HOME:-$HOME/.local/share}/applications"
+AUTOSTART_DIR="${XDG_CONFIG_HOME:-$HOME/.config}/autostart"
+CONFIG_DIR="${XDG_CONFIG_HOME:-$HOME/.config}/dictate"
+REMOVE_USER_DATA=0
+QUIET=0
+
+usage() {
+  cat <<EOF
+Usage: $0 [--remove-user-data] [--quiet]
+
+Removes Dictate launcher/autostart entries, ~/.local/bin/dictate, and the
+installed runtime venv/icons. User config, logs, history, and downloaded models
+are preserved unless --remove-user-data is passed.
+EOF
+}
+
+while [ "$#" -gt 0 ]; do
+  case "$1" in
+    --remove-user-data)
+      REMOVE_USER_DATA=1
+      ;;
+    --quiet)
+      QUIET=1
+      ;;
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    *)
+      usage
+      exit 1
+      ;;
+  esac
+  shift
+done
+
+say() {
+  if [ "$QUIET" -eq 0 ]; then
+    printf '%s\n' "$1"
+  fi
+}
+
+remove_file() {
+  local path="$1"
+  if [ -e "$path" ] || [ -L "$path" ]; then
+    rm -f "$path"
+    say "Removed $path"
+  fi
+}
+
+remove_dir_if_empty() {
+  local path="$1"
+  if [ -d "$path" ]; then
+    rmdir "$path" 2>/dev/null || true
+  fi
+}
+
+remove_file "$DESKTOP_DIR/dictate.desktop"
+remove_file "$DESKTOP_DIR/dictate-settings.desktop"
+remove_file "$AUTOSTART_DIR/dictate.desktop"
+
+if [ -L "$BIN_PATH" ]; then
+  target="$(readlink "$BIN_PATH" || true)"
+  if [ "$target" = "$INSTALL_DIR/venv/bin/dictate" ]; then
+    remove_file "$BIN_PATH"
+  else
+    say "Leaving $BIN_PATH because it points to $target"
+  fi
+elif [ -e "$BIN_PATH" ]; then
+  say "Leaving $BIN_PATH because it is not a Dictate-managed symlink"
+fi
+
+rm -rf "$INSTALL_DIR/venv" "$INSTALL_DIR/share/icons"
+remove_dir_if_empty "$INSTALL_DIR/share"
+say "Removed installed runtime files from $INSTALL_DIR"
+
+if [ "$REMOVE_USER_DATA" -eq 1 ]; then
+  rm -rf "$CONFIG_DIR" "$INSTALL_DIR"
+  say "Removed user config/data: $CONFIG_DIR and $INSTALL_DIR"
+else
+  say "Preserved user config/data: $CONFIG_DIR and $INSTALL_DIR"
+fi
+
+update-desktop-database "$DESKTOP_DIR" 2>/dev/null || true
+
+say "Dictate uninstall complete."

package/update-windows.ps1

@@ -0,0 +1,70 @@
+param(
+    [switch]$NoVerify,
+    [switch]$NoPrepareTurbo,
+    [switch]$NoShortcut,
+    [switch]$NoStartup,
+    [switch]$ForceStartup,
+    [switch]$RecreateVenv,
+    [switch]$SkipGitPull
+)
+
+$ErrorActionPreference = "Stop"
+
+function Get-StartMenuProgramsDir {
+    $programsDir = Join-Path $env:APPDATA "Microsoft\Windows\Start Menu\Programs"
+    if (-not $env:APPDATA) {
+        $programsDir = Join-Path $HOME "AppData\Roaming\Microsoft\Windows\Start Menu\Programs"
+    }
+    return $programsDir
+}
+
+function Remove-LegacyEntries {
+    $programsDir = Get-StartMenuProgramsDir
+    Remove-Item -Force -ErrorAction SilentlyContinue -Path (Join-Path $programsDir "Dictate Controls.lnk")
+}
+
+function Get-StartupShortcutPath {
+    $programsDir = Get-StartMenuProgramsDir
+    return (Join-Path (Join-Path $programsDir "Startup") "Dictate.lnk")
+}
+
+function Stop-DictateProcesses {
+    $currentPid = $PID
+    $matches = Get-CimInstance Win32_Process |
+        Where-Object {
+            $_.ProcessId -ne $currentPid -and (
+                $_.Name -in @("dictate.exe", "dictate-controls.exe") -or
+                $_.CommandLine -like '*dictate.exe* --type-backend pynput*' -or
+                $_.CommandLine -like '*pythonw.exe* -m dictate --type-backend pynput*' -or
+                $_.CommandLine -like '*dictate-daemon.cmd*' -or
+                $_.CommandLine -like '*dictate-controls*'
+            )
+        }
+    foreach ($match in $matches) {
+        Stop-Process -Id $match.ProcessId -Force -ErrorAction SilentlyContinue
+    }
+    Start-Sleep -Milliseconds 500
+}
+
+if ((-not $SkipGitPull) -and (Test-Path (Join-Path $PSScriptRoot ".git"))) {
+    Write-Host "==> Updating source checkout"
+    & git -C $PSScriptRoot pull --ff-only
+    if ($LASTEXITCODE -ne 0) {
+        throw "git pull failed with exit code $LASTEXITCODE."
+    }
+}
+
+Remove-LegacyEntries
+Stop-DictateProcesses
+
+$installerArgs = @("-ExecutionPolicy", "Bypass", "-File", (Join-Path $PSScriptRoot "install-windows.ps1"))
+if ($NoVerify) { $installerArgs += "-NoVerify" }
+if ($NoPrepareTurbo) { $installerArgs += "-NoPrepareTurbo" }
+if ($NoShortcut) { $installerArgs += "-NoShortcut" }
+if ($NoStartup -or ((-not $ForceStartup) -and (-not (Test-Path (Get-StartupShortcutPath))))) { $installerArgs += "-NoStartup" }
+if ($RecreateVenv) { $installerArgs += "-RecreateVenv" }
+
+& powershell @installerArgs
+if ($LASTEXITCODE -ne 0) {
+    throw "Dictate Windows update failed with exit code $LASTEXITCODE."
+}

package/update.ps1

@@ -0,0 +1,115 @@
+param(
+    [string]$InstallRoot,
+    [string]$ArchiveUrl,
+    [switch]$NoVerify,
+    [switch]$NoPrepareTurbo,
+    [switch]$NoShortcut,
+    [switch]$NoStartup,
+    [switch]$ForceStartup,
+    [switch]$RecreateVenv
+)
+
+$ErrorActionPreference = "Stop"
+$DictateVersion = "2026.5.18-1"
+
+if (-not $ArchiveUrl) {
+    $ArchiveUrl = "https://github.com/arcforgelabs/dictate/archive/refs/tags/v$DictateVersion.zip"
+}
+
+if (-not $InstallRoot) {
+    $currentDirectory = [System.IO.Directory]::GetCurrentDirectory()
+    $candidateSource = Join-Path $currentDirectory "source"
+    if (
+        (Test-Path (Join-Path $candidateSource "update-windows.ps1")) -and
+        (Test-Path (Join-Path $candidateSource "pyproject.toml")) -and
+        (Test-Path (Join-Path $candidateSource "src\dictate"))
+    ) {
+        $InstallRoot = $currentDirectory
+    } else {
+        $base = $env:LOCALAPPDATA
+        if (-not $base) {
+            $base = Join-Path $HOME "AppData\Local"
+        }
+        $InstallRoot = Join-Path $base "Dictate"
+    }
+}
+
+$installRootPath = [System.IO.Path]::GetFullPath($InstallRoot)
+$sourceDir = Join-Path $installRootPath "source"
+$stagingRoot = Join-Path $env:TEMP ("dictate-update-" + [guid]::NewGuid().ToString("N"))
+$archivePath = Join-Path $stagingRoot "dictate.zip"
+
+function Stop-DictateProcesses {
+    $currentPid = $PID
+    $matches = Get-CimInstance Win32_Process |
+        Where-Object {
+            $_.ProcessId -ne $currentPid -and (
+                $_.Name -in @("dictate.exe", "dictate-controls.exe") -or
+                $_.CommandLine -like '*dictate.exe* --type-backend pynput*' -or
+                $_.CommandLine -like '*pythonw.exe* -m dictate --type-backend pynput*' -or
+                $_.CommandLine -like '*dictate-daemon.cmd*' -or
+                $_.CommandLine -like '*dictate-controls*'
+            )
+        }
+    foreach ($match in $matches) {
+        Stop-Process -Id $match.ProcessId -Force -ErrorAction SilentlyContinue
+    }
+    Start-Sleep -Milliseconds 500
+}
+
+Write-Host "==> Updating Dictate in $installRootPath"
+New-Item -ItemType Directory -Force -Path $stagingRoot | Out-Null
+New-Item -ItemType Directory -Force -Path $installRootPath | Out-Null
+
+try {
+    if (Test-Path -LiteralPath $ArchiveUrl) {
+        Write-Host "==> Copying local archive $ArchiveUrl"
+        Copy-Item -Force -LiteralPath $ArchiveUrl -Destination $archivePath
+    } else {
+        Write-Host "==> Downloading $ArchiveUrl"
+        Invoke-WebRequest -UseBasicParsing -Uri $ArchiveUrl -OutFile $archivePath
+    }
+
+    Write-Host "==> Expanding source archive"
+    Expand-Archive -Force -Path $archivePath -DestinationPath $stagingRoot
+    $expanded = Get-ChildItem -Path $stagingRoot -Directory |
+        Where-Object { Test-Path (Join-Path $_.FullName "update-windows.ps1") } |
+        Select-Object -First 1
+    if (-not $expanded) {
+        throw "Downloaded archive did not contain update-windows.ps1."
+    }
+
+    if (Test-Path $sourceDir) {
+        Stop-DictateProcesses
+        Write-Host "==> Replacing existing managed source: $sourceDir"
+        Remove-Item -Recurse -Force $sourceDir
+    }
+    Move-Item -Path $expanded.FullName -Destination $sourceDir
+
+    $updaterArgs = @(
+        "-ExecutionPolicy",
+        "Bypass",
+        "-File",
+        (Join-Path $sourceDir "update-windows.ps1"),
+        "-SkipGitPull"
+    )
+    if ($NoVerify) { $updaterArgs += "-NoVerify" }
+    if ($NoPrepareTurbo) { $updaterArgs += "-NoPrepareTurbo" }
+    if ($NoShortcut) { $updaterArgs += "-NoShortcut" }
+    if ($NoStartup) { $updaterArgs += "-NoStartup" }
+    if ($ForceStartup) { $updaterArgs += "-ForceStartup" }
+    if ($RecreateVenv) { $updaterArgs += "-RecreateVenv" }
+
+    Write-Host "==> Running Dictate Windows updater"
+    & powershell @updaterArgs
+    if ($LASTEXITCODE -ne 0) {
+        throw "Dictate Windows updater failed with exit code $LASTEXITCODE."
+    }
+} finally {
+    if (Test-Path $stagingRoot) {
+        Remove-Item -Recurse -Force $stagingRoot
+    }
+}
+
+Write-Host ""
+Write-Host "Dictate updated from: $sourceDir"

package/update.sh

@@ -0,0 +1,34 @@
+#!/usr/bin/env bash
+# Update Dictate and migrate old launcher/icon names from previous installs.
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+INSTALL_DIR="$HOME/.local/share/dictate"
+DESKTOP_DIR="${XDG_DATA_HOME:-$HOME/.local/share}/applications"
+AUTOSTART_DIR="${XDG_CONFIG_HOME:-$HOME/.config}/autostart"
+ICON_DIR="$INSTALL_DIR/share/icons"
+AUTOSTART_PATH="$AUTOSTART_DIR/dictate.desktop"
+
+cleanup_legacy_entries() {
+  rm -f "$DESKTOP_DIR/dictate-settings.desktop"
+  rm -f "$ICON_DIR/dictate-controls.png" "$ICON_DIR/dictate.png"
+}
+
+if [ -d "$SCRIPT_DIR/.git" ]; then
+  git -C "$SCRIPT_DIR" pull --ff-only
+fi
+
+cleanup_legacy_entries
+
+args=("$@")
+startup_option_seen=0
+for arg in "${args[@]}"; do
+  if [ "$arg" = "--no-startup" ]; then
+    startup_option_seen=1
+  fi
+done
+if [ "$startup_option_seen" -eq 0 ] && [ ! -e "$AUTOSTART_PATH" ]; then
+  args+=("--no-startup")
+fi
+
+"$SCRIPT_DIR/install.sh" "${args[@]}"