OpenLogiSettings and updates
Configure OpenLogi application preferences, permissions, assets, network access, and updates in the Settings window.
The Settings window holds application-wide preferences. It opens on General. Every stored preference in this page belongs to [app_settings] in config.toml; action buttons do not write a setting. See the configuration reference for the complete file.
Open the window
Choose Settings… from the application menu. The macOS menu-bar agent also opens this window from Settings…. The Settings sidebar has General, Updates, Permissions where supported, Appearance, Assets, and About. macOS adds Diagnostics.
General
General selects the application used for mouse profiles, scrolling behavior, startup, notification indicators, and the visible agent icon.
| Control | What it does | Config key | Platforms |
|---|---|---|---|
| Mouse button profiles | Uses Mouse pointer or Focused application as the profile target. Keyboard profiles always follow focus. | mouse_profile_target | macOS, Windows, Linux; unsupported pointer targets use focus. |
| Smooth scrolling | Replaces eligible physical mouse-wheel input with a finite smooth animation. Trackpad and other continuous pixel input stay native. | smooth_scroll | macOS, Windows, Linux |
| Vertical scroll sensitivity | Sets traditional vertical-wheel distance from 1 to 100. The default 14 is 1×. | vertical_scroll_sensitivity | macOS, Windows, Linux |
| Thumb Wheel sensitivity | Sets thumb-wheel scroll speed and the threshold for discrete thumb-wheel actions from 1 to 100. The default 14 is 1×. | thumbwheel_sensitivity | macOS, Windows, Linux |
| Launch at login | Starts the background agent after login. | launch_at_login | macOS, Windows, Linux |
| Login item disabled in System Settings | Appears on macOS when System Settings has disabled the login item. Open Login Items opens the place where you re-enable it. | No config key | macOS |
| Show in menu bar | Shows or hides the agent's menu-bar item after the agent restarts. | show_in_menu_bar | macOS |
| Show in the notification area | Shows or hides the agent's notification-area icon after the agent restarts. | show_in_menu_bar | Windows |
| Low battery notifications | Shows a bottom-screen notice when a connected device has low battery. | low_battery_notifications | macOS, Windows, Linux |
| Lock key notifications | Shows an on-screen lock-key state. macOS shows Caps Lock only. Windows and Linux can also show Num Lock and Scroll Lock. | lock_key_notifications | macOS, Windows, Linux |
capture_mouse_events exists in the configuration. The current General page has no control for it. When it is false, the agent does not install its OS mouse hook, so button remapping stops while HID++ features such as DPI and SmartShift remain available.
Appearance
Appearance changes the interface language and presentation. Changes to mode, theme, radius, and scale apply in the running app.
| Control | What it does | Config key | Platforms |
|---|---|---|---|
| Language | Chooses Follow system or a shipped interface locale. | language | macOS, Windows, Linux |
| Appearance mode | Selects Light, Dark, or Follow system. | appearance | macOS, Windows, Linux |
| Color theme | Selects a theme for its light or dark slot. A system-following mode remains system-following. | theme_light or theme_dark | macOS, Windows, Linux |
| App icon | Chooses the OpenLogi or Prism icon for the Dock, Finder, and Launchpad. | app_icon | macOS |
| Corner radius | Selects Sharp (0), Default (the theme value), or Round (12). | ui_radius | macOS, Windows, Linux |
| Interface scale | Scales text and rem-based interface spacing to 90%, 100%, 110%, or 125%. | ui_scale | macOS, Windows, Linux |
The language picker ships these locale codes: be, cs, da, de, en, es, fr, it, nl, nb, pl, pt-PT, pt-BR, fi, sv, tr, el, ru, uk, ja, zh-CN, zh-HK, zh-TW, and ko.
Updates
Updates displays the running version, its update status, and the detected installation source. Update checks are off by default. The first-run Check for updates? dialog records either answer in update_prompt_seen. Choosing Enable also runs one check immediately.
| Control | What it does | Config key | Platforms |
|---|---|---|---|
| Check for updates | Checks once per launch when enabled. It does not download an update by itself. | check_for_updates | macOS, Windows, Linux |
| Automatically download and install | After a check finds an update, downloads and stages it in the background. The update applies when OpenLogi next restarts. | auto_install_updates | macOS, Windows, Linux |
| Check for Updates | Runs a user-requested check, regardless of the automatic-check setting. The action can change to Download & Install or Restart to Update. | No config key | macOS, Windows, Linux |
| Installation source | Shows a detected macOS bundle, Windows MSI or portable ZIP, Homebrew cask, Linux package, Nix store, or an unrecognized source. | No config key | macOS, Windows, Linux |
| Update source | Opens GitHub Releases through View changelog. | No config key | macOS, Windows, Linux |
A macOS release bundle that embeds Sparkle uses Sparkle. Sparkle checks its appcast and installs on quit. This is the macOS update path added in v0.8.14. Windows uses the built-in updater with MSI release artifacts. The same built-in updater is also the fallback for Linux, unbundled builds, and macOS bundles without working Sparkle.
The updater detects Homebrew, DEB, RPM, Arch, Nix, and Windows installation sources for display. It does not select a package-manager-specific updater from that detection. For a Homebrew or Linux package installation, use the installation owner's update path. A release Flatpak is a one-time bundle with no remote, so flatpak update cannot find a newer release; install a newer .flatpak bundle instead.
Assets
Assets manages device-image mirrors and the per-user image cache. Automatic device-image download is enabled by default.
| Control | What it does | Config key | Platforms |
|---|---|---|---|
| Asset source | Selects Automatic (recommended), OpenLogi, Cloudflare, or Fastly. Automatic races the built-in mirrors and uses the first healthy one. OPENLOGI_ASSETS overrides this choice. | asset_source | macOS, Windows, Linux |
| Automatically download device images | Downloads images for connected devices from the selected source. Turning it back on refreshes immediately. | auto_download_assets | macOS, Windows, Linux |
| Refresh assets | Re-downloads images for connected devices now. | No config key | macOS, Windows, Linux |
| Clear cache | Deletes the per-user cache, then re-fetches the current devices. | No config key | macOS, Windows, Linux |
| Cache location | Opens the downloaded-images folder in the file manager. | No config key | macOS, Windows, Linux |
The cache root is OpenLogi's data directory plus assets. If no home directory resolves, it falls back to ./assets.
Permissions
Permissions appears on macOS and Linux. Windows does not show a Permissions page.
| Control | What it does | Config key | Platforms |
|---|---|---|---|
| Accessibility | Grants the background agent access required for gesture and button remapping. | No config key | macOS |
| Input Monitoring | Allows HID++ data access, including Bluetooth-direct mice. | No config key | macOS |
| Bluetooth | Allows CoreBluetooth use. HID access does not require this permission. | No config key | macOS |
| Camera | Allows a Logitech webcam preview. The page shows this row only while a Logitech webcam is present. | No config key | macOS |
| Input device access | Reports access to input devices and describes the required udev rules when access is denied. | No config key | Linux |
Diagnostics
Diagnostics appears on macOS. Input interception reports known applications that gate the mouse event stream. Such interception can cause pointer lag or duplicated button actions.
| Control | What it does | Config key | Platforms |
|---|---|---|---|
| Input interception | Checks current macOS event taps for known input conflicts. | No config key | macOS |
About
About identifies the running build and provides support destinations.
| Control | What it does | Config key | Platforms |
|---|---|---|---|
| GitHub, Changelog, Documentation, and Report an issue | Open the repository, releases, documentation, or issue tracker. | No config key | macOS, Windows, Linux |
| Copy Diagnostics | Copies a Markdown diagnostics report to the clipboard. | No config key | macOS, Windows, Linux |
| Show in file manager | Opens the directory that contains config.toml. | No config key | macOS, Windows, Linux |
Network access
OpenLogi has no continuous update poller. The update label states that update checks are the only optional outbound request, but the asset code also makes configurable asset requests. The following is the precise behavior of the current release.
| Network request | When OpenLogi makes it | Default |
|---|---|---|
| Update manifest or Sparkle appcast check | Once per launch only when Check for updates is enabled, or when you choose Check for Updates. | Off |
| Update artifact download | After you choose Download & Install, or after an enabled automatic check finds an update and Automatically download and install is enabled. | Off |
| Asset index and device-image downloads | For automatic sync only when automatic device images are enabled and the build permits automatic sync. Release builds with no populated app bundle and debug builds permit it. OPENLOGI_SYNC can force it on or off. | auto_download_assets is on |
| Asset index and device-image downloads | When you enable automatic device images, change the asset source while automatic images are enabled, choose Refresh assets, or choose Clear cache. Manual refresh and clear bypass the automatic-download and bundle gates. | User action |
The assets request fetches an asset index first. It then fetches only the files for connected device models that are absent or stale. Selecting an asset mirror pins that source, unless OPENLOGI_ASSETS overrides it.
Menu bar and notification area
The background agent owns these menus. The GUI can be closed while the agent continues to run.
| Host | Menu items |
|---|---|
| macOS menu bar | Show Main Window, Settings…, About OpenLogi, Check for Updates…, Quit OpenLogi |
| Windows notification area | Show Main Window, Quit OpenLogi |
The Windows icon opens Show Main Window on left click. The current Windows menu has no Settings… or update item.