All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

• llama.cpp installation with Latest selected. Fixed installation and updates failing with “No matching asset found” after llama.cpp changed how it publishes releases. Desktop now finds the download belonging to the selected release (#334).
• AMD llama.cpp downloads on Windows and Linux. Fixed downloads failing because Desktop requested outdated filenames. The ROCm option now recognizes the renamed downloads and still opens previously installed versions without an internet connection (#334).
• llama.cpp offering an older version as an update. If you already have a newer numbered build installed, checking for updates no longer offers an older build from the latest release.
• llama.cpp stopping when an update has no matching download. Desktop now checks that the selected download exists before stopping llama.cpp. If it is missing, the running model server stays running.
• macOS installer creation. Fixed the signing password error that prevented macOS installers from being created. Apple signing and security checks are still required before publishing.

• Model folder display. In Settings → Models, the folder path now has its own full-width button below the description. Long paths shorten to fit the window; hover to see the full path or click to open the folder.
• Get Started button. Its arrow now moves slightly to the right on hover. The animation respects your system's reduced-motion setting.
• Windows releases when signing fails. Desktop still attempts to sign Windows installers, but a signing failure no longer blocks publishing. An unsigned installer may show an unknown-publisher or Windows SmartScreen warning.

• Linux graphics staying slow after an update. Desktop now tries normal graphics again after its built-in browser is updated. A past graphics crash no longer keeps it permanently in software rendering. If graphics crashes again, Desktop still retries with software rendering.

• Debian, Ubuntu, and Linux Mint downloads. Added direct installer links and instructions for AppImage users whose app fails to open with a chrome-sandbox error.

• Folder uploads and syncing. Selecting a folder in Workspace → Knowledge no longer fails with “Directory selection was cancelled.” Desktop allows reading the folder you selected while keeping write access blocked (#271).
• Slow Linux interface. Desktop no longer forces every Linux computer to draw the interface without GPU acceleration. Software rendering remains available after a graphics crash, and explicit graphics choices are respected (#273).
• Linux tray clicks. Clicking the tray icon now brings Desktop forward, restores a minimized window, or opens a new window if the previous one was closed (#203).
• GNOME Flatpak shortcuts. Updated shortcut support and corrected the app identity sent to GNOME so the desktop shortcut can register and bring the window forward (#126).

• Optional automatic Desktop updates. Enable Automatic desktop updates in Settings → About to download new versions in the background and install them when you quit. It is off by default. Desktop now checks at launch and every six hours, and shows a dismissible notification when an update is available or ready to install (#100).
• Start with the window hidden. Added Start minimized to tray in Settings → General, off by default. Open Desktop from the tray or your global shortcut when you need it. A previously maximized window stays hidden until you open it (#235).
• Hide the macOS menu bar icon. Turn off Show Open WebUI in menu bar in Settings → General. The icon hides or returns immediately, without restarting Desktop (#213).
• Copy and save images. Right-click an image in Open WebUI to choose Copy Image or Save Image As… (#230).
• Bulgarian language. Added Български to Desktop's language selector, with translations for setup, settings, and status messages (#261).

• Local models keep the installed llama.cpp version. Starting llama.cpp now reuses the newest compatible version already on your computer without checking for a newer release. Use Update in its settings when you want to upgrade. A failed update download keeps the previously installed version available (#193).
• Clearer Linux update options. Snap and Flatpak installations now explain how to update through your package manager or download a newer package, instead of showing an update check that never finishes.
• Simpler download links. The README groups downloads under macOS, Windows, and Linux, and fixes the broken Intel/AMD Linux AppImage link (#239).
• Windows shortcuts. The Windows installer explicitly enables both desktop and Start menu shortcuts by default (#232).

• Screen sharing inside Open WebUI. Fixed screen capture requests failing inside the Desktop window (#206).
• Open WebUI left broken after an interrupted update. Desktop now stops Open WebUI before updating, prevents overlapping installations, and does not try to start it after an update fails. Retrying Install or Update in Settings repairs an interrupted installation without deleting chats or settings (#220).
• NVIDIA acceleration on Windows. Installing the CUDA version of llama.cpp now also downloads the matching NVIDIA support files. Existing installations missing those files are repaired on the next start (#198).
• Update progress disappearing. Closing and reopening Settings → About now retains the available version, download progress, and Restart to Update action.
• Linux ARM64 update checks. Fixed the missing update information that prevented ARM64 installations from finding new Desktop releases.
• Snap failing to open. Fixed the Linux Snap package closing before showing a window because its bundled components required newer system libraries than the package provided (#176).
• macOS header changing height. The top bar now stays the same slim height while Open WebUI starts or stops.
• Windows release builds. Fixed a build failure that prevented the Windows installer from being created with the newer Windows build tools.

• Check downloads before using them. Desktop now verifies that Python, llama.cpp, and Hugging Face model downloads match the original files, rejecting incomplete or changed downloads. Large setup downloads also use less memory.
• Restrict links and model file locations. Only web and email links can open outside Desktop. Model filenames that try to save or delete files outside the model folder are rejected.
• Require release signing checks. Release preparation now stops if Windows signing or Apple's signing and security checks fail, instead of falling back to publishing unsigned installers.

• Focused on your own computer. Desktop now focuses on setting up Open WebUI on your computer and opening it whenever you need it. Get Started installs and opens your local copy. If you use Open WebUI on another server, Open WebUI Tether is the companion app for extending what you can do with it.
• More room for Open WebUI. Removed the desktop connection sidebar and replaced the old toolbar with a slim header showing the current page title. The header follows Open WebUI's light, dark, and OLED themes. Windows keeps its familiar minimize, maximize, and close buttons. The window can now shrink to 360 pixels wide, including a square layout.
• Controls in the bottom bar. Settings now sits at the bottom left, with the app version and page refresh on the right. Click Open WebUI to show or hide its activity log, restart it from the open panel, or use the arrow beside its name to open it in your browser when the panel is closed. Refresh reloads the page without restarting Open WebUI.
• Startup progress you can inspect. The loading screen shows the latest startup message beneath “Loading…”. Click that message to open the full log. Logs remain available if startup fails, and the panel can be resized and its output copied.
• Settings that match Open WebUI. Added search to find the relevant settings section, grouped navigation, a Back button, and stronger text contrast in both themes. Tabs scroll horizontally in narrow windows. Text uses your system font, with smaller icons and tooltips throughout the app.
• New default shortcut. Press Cmd+Shift+O on macOS or Ctrl+Shift+O on Windows and Linux to bring Desktop forward. Existing saved shortcuts stay unchanged.
• Optional local models. The llama.cpp option is now off by default during installation. You can choose to enable it during setup or later in Settings.

• Remote server connections. Desktop no longer adds, opens, or switches between Open WebUI servers hosted elsewhere, including previously saved connections.
• Desktop chat overlays and shortcuts. Removed the floating Spotlight chat bar, its screenshot capture and clipboard auto-paste, system-wide voice input, and the shortcut for starting a call.
• Built-in Open Terminal. Desktop no longer installs, starts, or manages Open Terminal. Its setup option, settings, and status controls have been removed.

• Custom ports and local network sharing. Desktop follows the running server's actual port after a restart and connects through loopback when LAN sharing is enabled. Port selection now checks whether the server can bind, including on Windows (#250, #207).
• Open WebUI stuck on its splash screen. Fixed loading inside Desktop and kept Open WebUI's regular interface without the extra server selector.
• Starting, stopping, and restarting. Repeated starts no longer launch duplicate copies of Open WebUI or llama.cpp. Stopping during startup cancels the pending start, and an older copy exiting no longer marks a newer copy as stopped. Quitting Desktop waits for both to shut down.
• Incorrect running status. A failed start or unexpected exit now updates the controls and shows the failure instead of continuing to report that everything is running.
• Logs during long sessions. Limited the amount of old output kept in memory and stopped closed log views from leaving unused connections behind. Opening another log view no longer disconnects the first one.
• Local model startup preference. Fixed the llama.cpp “Start on Launch” switch so changing it saves your choice.
• Desktop settings protected from page requests. Pages shown inside the app can no longer request changes to desktop settings, stop local services, or reset the app.
• Linux updates. Fixed release packaging so the update download list includes ARM64 builds alongside Intel and AMD builds.

• Blank Webview on Linux. Replaced the --in-process-gpu Chromium flag with SwiftShader software rendering (--use-gl=angle --use-angle=swiftshader). The in-process GPU flag broke <webview> guest compositing entirely, leaving connection views blank on all Linux configurations. SwiftShader keeps the GPU process out-of-process (required for webview compositing) while avoiding driver-level crashes (#178).

• Spotlight Pulls to First Desktop on macOS. Spotlight no longer switches Spaces when triggered from a non-primary desktop. The window is now visible on all workspaces, and app.focus({ steal: true }) — which activated the entire app and caused the Space switch — has been replaced with targeted window-level focus (#179).
• Gray Screen When Connecting to Server on Linux. Replaced the --disable-gpu Chromium flag with --in-process-gpu, which keeps the display compositor alive so <webview> guest surfaces actually paint instead of showing a gray rectangle. The previous flag fixed GPU process crashes but broke webview rendering on Debian and Ubuntu (#178).
• Open Terminal Fails Silently Without Python. Open Terminal now automatically installs Python when it's missing instead of throwing an opaque error. Progress status is surfaced in the UI during installation.
• Corrupt Auto-Update Manifests. Fixed the release workflow to deduplicate artifact entries during manifest merging, preventing SHA512 checksum mismatches that caused updates to fail silently.

• Downloaded Models Not Recognized by llama.cpp. Models downloaded from Hugging Face are now stored directly under the models/ directory instead of a nested models/huggingface/ subdirectory, so llama-server's model scanner discovers them without manual symlinks. Existing models in the old location are automatically migrated on startup (#177).

• Webview Context Menu. Right-clicking inside the webview now shows a native context menu with Cut, Copy, Paste, Undo/Redo, spell-check suggestions, and "Open Link in Browser" — enabling system autofill and password manager integration on login pages (#161).

• Windows OpenSSL Compatibility. The bundled Python's directory is now prepended to PATH on Windows so its own OpenSSL DLLs are loaded before any conflicting system-wide installations (Git for Windows, Anaconda, Strawberry Perl, etc.), preventing the OPENSSL_Uplink: no OPENSSL_Applink crash on startup (#167).
• Links Open in Default Browser on Windows. Added allowpopups to the webview so that target="_blank" link clicks correctly propagate to the main process handler and open in the default browser instead of being silently blocked (#165, #170).
• Linux System Requirements. Documentation now specifies glibc 2.28+ as a minimum requirement for Linux installations.

• Links Open in Default Browser. Clicking links in chat responses now opens them in the user's default browser instead of navigating within the app or spawning a new Electron window (#165).

• ARM64 Support for Linux and Windows. Native ARM64 builds are now produced for Linux (.deb, AppImage) and Windows (NSIS installer), enabling support for Raspberry Pi, NVIDIA DGX Spark, Snapdragon laptops, and other ARM64 devices (#140).

• Grey/Blank Screen on Linux. Disabled GPU compositing entirely on Linux to prevent shared memory allocation crashes that caused a grey or blank screen on systems with restricted /dev/shm or /tmp permissions.
• Spotlight Dismiss Behavior. Pressing Escape or the toggle shortcut to dismiss Spotlight no longer erroneously brings the main application window to the foreground (#158).

• Grey/Blank Webview on Linux. Disabled GPU compositing on Linux to prevent silent compositor failures that produce a grey rectangle instead of rendered content on systems with problematic Intel/NVIDIA drivers or certain Wayland compositors (#119).
• Renderer Crash Recovery. The main window now automatically reloads when the renderer process dies unexpectedly, preventing a permanent blank/grey screen.
• Webview Crash Diagnostics. Added logging for guest webview renderer crashes to aid debugging connectivity and rendering issues.
• macOS Notarization. Resolved Apple notarization failure caused by an expired Developer Program agreement, restoring signed and notarized macOS builds.

• Copy Button on Linux (GNOME/Wayland/Flatpak). Fixed the "Copy" button in the Open WebUI interface not actually writing to the system clipboard on Linux. The webview session was missing the clipboard-sanitized-write permission required by Electron for navigator.clipboard.writeText() to work.

• Toggleable Clipboard Auto-Paste for Spotlight. Spotlight's automatic clipboard pasting is now optional and can be toggled in Settings, so the input bar starts empty when preferred.
• Persistent Window Size and Position. The app now remembers your window dimensions, position, and maximized state across restarts, with safe fallback when a saved display is disconnected.

• Linux .deb Crash. Fixed app failing to launch on Linux with Failed to load native module: pty.node by enabling native module rebuilds and unpacking node-pty from the asar archive during packaging.
• Grey Screen on Connection Failure. The webview now shows an error overlay with retry and open-in-browser options instead of a blank grey screen when a connection fails to load or crashes.
• Global Shortcuts on Wayland/Flatpak. Global shortcuts now work on Wayland desktops via xdg-desktop-portal, with clear user-facing notifications when a shortcut cannot be registered.

• macOS Launch Crash. Fixed app failing to launch with "different Team IDs" error by adding the missing disable-library-validation entitlement to the build signing configuration.
• Self-Signed SSL Connections. The app now trusts all SSL certificates, allowing connections to Open WebUI instances behind self-signed or untrusted certificates without errors.

• Concurrent Model Downloads. Multiple Hugging Face models can now be downloaded simultaneously, each with independent progress tracking and per-file cancel buttons.

• Models Settings UI. Cleaner layout with inline progress bars, hover-reveal download buttons, and breadcrumb-style repo navigation.

• GPU Process Crash Recovery. The app now automatically detects GPU process crashes (common with certain NVIDIA/Intel drivers on Windows) and relaunches with the GPU sandbox disabled, instead of closing immediately. No manual shortcut edits required.

• Open Terminal API Key Persistence. The Open Terminal API key is now saved in config.json and reused across restarts instead of being regenerated on every startup, which was breaking existing integrations.

• Voice Input. System-wide push-to-talk voice transcription. Press the shortcut from any app to record audio, which is automatically transcribed and sent to your active chat.
• Voice Input Settings. Configurable global hotkey and enable/disable toggle in Settings, with a default of Shift+Cmd+Space (macOS) or Shift+Ctrl+Space (Windows/Linux).
• Audio Feedback. Bundled start and stop chime sounds play when recording begins and ends.

• Shortcut Recorder on macOS. Shortcut inputs now use physical key codes instead of character values, fixing Alt key combinations producing unicode characters like √ instead of V.

• macOS Auto-Update. Auto-update now works correctly on macOS. Previously, the updater tried to download a zip file with a versioned filename that did not exist in the release.

• Spotlight Screenshot Capture. Drag anywhere on the Spotlight overlay to select a region of your screen. Screenshots appear as inline thumbnails and are sent alongside your message.
• Multiple Screenshots. Attach several screenshots in a single Spotlight query. Each one can be individually removed before sending.
• Click-to-Dismiss Spotlight. Clicking the background outside the input bar dismisses Spotlight, in addition to pressing Escape.
• Screen Recording Permission Prompt (macOS). If screen capture permission hasn't been granted, a notification guides you to the correct System Settings page.
• Screenshot Hint. A "Drag anywhere to capture a screenshot" hint appears when Spotlight opens.
• Offline Mode for llama.cpp. Previously downloaded llama.cpp binaries are automatically detected on startup, so local models work without an internet connection.
• Auto-Connect on Startup. The app pre-connects to your default connection when launched, so Spotlight queries work immediately.

• Fullscreen Spotlight Overlay. Spotlight now opens as a fullscreen transparent overlay on your active display rather than a small floating window, enabling screenshot capture and multi-display support.
• Faster Remote Connections. Switching to a remote server is now instant with no loading delay.
• Smarter Loading Indicator. The loading spinner only appears when the local server is actually starting, instead of showing on every connection switch.
• Clearer Sidebar Selection. Active connections are more visually distinct with bolder text and stronger highlights. Inactive connections are subtler for better contrast.
• Safer llama.cpp Updates. The app verifies internet connectivity before removing the current installation, preventing accidental data loss when updating offline.

• Tray Menu Connections. Clicking a connection from the system tray menu now correctly opens it in the app.
• Dark Mode Context Menus. Sidebar right-click menus no longer appear incorrectly highlighted in dark mode.
• Local Server Always Accessible. The local connection in the sidebar is no longer grayed out when the server isn't running. Clicking it will start the server.
• Open Terminal Install Errors. If automatic installation of Open Terminal fails, you now see a clear error message instead of a silent failure.
• Network Timeout Handling. Requests for llama.cpp releases now time out after 10 seconds instead of hanging indefinitely on slow networks.

• Two-Way Theme Sync. Theme changes in Open WebUI are now mirrored to the desktop app and vice versa, so your light/dark preference stays consistent everywhere.
• Seamless Spotlight Queries. Spotlight prompts now appear directly in your already-open chat without triggering a full page reload.

• Auto-Default Connection. Selecting a connection now automatically saves it as your default for Spotlight and app startup.
• Smooth Connection Switching. Switching between already-open connections no longer causes unnecessary page reloads.
• Connection Switch Race Condition. Clicking a remote connection while the local server is still starting no longer gets overridden when the local server finishes loading.

• Spotlight Focus. Spotlight now reliably appears after interacting with the main window. Previously could fail to show on macOS.
• Spotlight Search Passthrough. Searches submitted from Spotlight now correctly load in already-open connections instead of being silently ignored.

• Spotlight Input Bar. Lightweight quick-chat bar (⇧⌘I) for submitting queries without opening the full app.
• Spotlight Shortcut. Dedicated configurable shortcut for Spotlight, independent from the global app shortcut.
• Draggable Spotlight. Spotlight bar can be dragged to any position on screen.
• Persistent Spotlight Position. Spotlight position is saved and restored across app restarts.
• Spotlight Settings. Shortcut recorder in Settings → General for the Spotlight shortcut.

• System Theme Sync. The app now responds to OS dark/light mode changes in real-time when set to "Auto". Previously only checked once at startup.

• Local Server Management. Install, start, stop, and restart Open WebUI directly from the desktop app.
• Connection Manager. Connect to multiple Open WebUI servers with sidebar quick-switch.
• Status Bar. Real-time status indicators for Open WebUI, Open Terminal, and llama.cpp services.
• Log Viewer. Live terminal log viewer for all services with copy, refresh, and resize.
• Open Terminal Integration. Built-in terminal server for AI-powered shell access.
• llama.cpp Integration. Local inference engine with model management and Hugging Face downloads.
• Settings. General, Open WebUI, Terminal, Inference, Models, Connections, and About panels.
• Global Shortcut. Configurable system-wide hotkey to bring the app to the foreground.
• Auto-Update. Built-in update checker with one-click download and install.
• Tray Support. System tray icon with quick actions and optional background mode.
• Factory Reset. One-click removal of all installed components, data, and connections.
• Disk Space Check. Pre-install check requiring at least 5 GB of free storage.
• Internationalization. English, Japanese, Chinese (Simplified & Traditional) translations.
• In-App Changelog. Accessible from the About settings page.
• Cross-Platform. macOS, Windows, and Linux support.