Troubleshooting

Launch hangs, permissions that will not stick, Windows and Linux notes, and how to uninstall.

Most of this page is about macOS. Windows and Linux are new and have their own sections: Windows and Linux.

macOS will not open the app

This happens when the app came from the .dmg: it is not notarised by Apple, so macOS blocks the first launch. The simplest fix is to install with the Terminal command instead, which also replaces the copy you have:

curl -fsSL https://capture.startwellventures.com/install.sh | bash

Or open System Settings, Privacy & Security, and click Open Anyway next to Startwell Capture. Or run this once in Terminal:

xattr -dr com.apple.quarantine "/Applications/Startwell Capture.app"

The install command stops with an error on macOS

  • Needs macOS 15 or Apple silicon: Startwell Capture runs only on Macs with an Apple chip on macOS 15 Sequoia or later.
  • Does not match the SHA-512, or the signature is not the Startwell Capture certificate: the download was damaged or changed on the way. Nothing was installed. Run the command again; if it keeps happening, email us.
  • Asks for your password: your account cannot write to Applications, so moving the app there needs it. To install just for yourself instead, run:
curl -fsSL https://capture.startwellventures.com/install.sh | SWC_APP_DIR=~/Applications bash

The app does not start on macOS, or shows no window

A Keychain prompt can hold the app before its first window appears. Look for a dialog asking to use Startwell Capture Safe Storage, possibly behind other windows, and click Always Allow.

If there is no dialog and it still hangs:

  1. Quit Startwell Capture (Activity Monitor, if needed).
  2. Open Keychain Access, search for Startwell Capture Safe Storage, and delete that item.
  3. Open the app again. It creates a new item. If you had added an OpenRouter key, add it again.

A macOS permission is on but does not work

  • Screen Recording only applies after the app restarts. Use Quit and reopen in the app.
  • Permissions are kept across updates from version 0.1.2 on. Coming from 0.1.0 or 0.1.1, macOS asks once more after the first update, because those builds were signed differently. If a permission still shows as off, remove Startwell Capture from that list in System Settings, Privacy & Security, then add it again. Or reset it in Terminal and let the app ask again:
tccutil reset ScreenCapture com.startwellventures.capture
tccutil reset Accessibility com.startwellventures.capture
tccutil reset Microphone com.startwellventures.capture
  • Window titles say “Needs Accessibility”: Accessibility is off for the app.
  • Links have no address: allow Startwell Capture to control your browser in System Settings, Privacy & Security, Automation.

A shortcut does nothing

Another app may own the same keys. Change ours in Settings, Shortcuts. ⌥⌘1–9 can be turned off if they clash. On Windows and Linux, any key the system refused is marked in Settings, Shortcuts, so you can pick another. On Linux with Wayland, see below.

No transcript

On macOS 26 and later, the first transcription in a language downloads Apple’s speech model, which can take a minute. Elsewhere the app uses Whisper, whose model the install command downloads; if you skipped it, choose one in Settings. Check the language in Settings, Transcription, and that the microphone was allowed.

Windows

  • “Windows protected your PC”: this is SmartScreen, shown for a downloaded installer because the Windows build is not code-signed yet. Click More info, then Run anyway. Or install with the PowerShell command instead, which does not get the warning:
PowerShell
irm https://capture.startwellventures.com/install.ps1 | iex
  • Voice notes or meetings record silence: Windows has a switch for the microphone rather than a prompt. Open Settings, Privacy & security, Microphone, and turn on microphone access, including for desktop apps.
  • No icon in the taskbar corner: Windows may hide it behind the arrow by the clock. Drag it out, or open the app from the Start menu.
  • Logs are in %APPDATA%\Startwell Capture\logs. Attach the latest if you email us.

Linux

  • The install command says the system is too old: Startwell Capture for Linux needs glibc 2.39 or later, which means Ubuntu 24.04, Debian 13, Fedora 40 or newer. On an older release it would not start, so nothing is installed.
  • The AppImage will not start: it needs FUSE 2. Install libfuse2t64 on Ubuntu and Debian, fuse-libs on Fedora, or fuse2 on Arch. The .deb does not need it.
  • No tray icon on GNOME: GNOME shows tray icons only with the AppIndicator extension. Install it, or open the app from your app menu.
  • The desktop asks to share the screen: on Wayland that is how screen sharing works (the portal). Choose what to share and the recording starts. For screenshots during voice notes and meetings, choose it once in Settings, Capture, Choose screen; after that it doesn’t ask again, unless your desktop can’t remember the choice. X11 does not ask.
  • No page address, window names or clicks on Wayland: Wayland keeps one app from watching another. Window names come through on KDE and wlroots desktops such as Sway, and on GNOME through its accessibility service. Clicks in other apps and the names of what you click are never seen. Page addresses come through the browser add-on. Clipping selected text with a key is not available on Wayland. On X11 all of these work.
  • Shortcuts only work while the app is in front on Wayland: Wayland keeps global keys from apps. Add a custom shortcut in your desktop’s keyboard settings that runs startwell-capture --capture=screenshot (or voice, text, meeting, handoff and the rest). With the AppImage, use its path, ~/.local/opt/startwell-capture/Startwell-Capture.AppImage, in place of startwell-capture.
  • Logs are in ~/.config/Startwell Capture/logs.

Uninstall

On macOS and Linux, the install script removes the app and keeps your captures and settings. Add --purge after --uninstall to remove those and the Keychain item too; it asks first. Context packs in ~/Startwell Capture are always kept.

curl -fsSL https://capture.startwellventures.com/install.sh | bash -s -- --uninstall

On Windows, run this in PowerShell, or remove Startwell Capture in Settings, Apps. Add -Purge after -Uninstall to remove %APPDATA%\Startwell Capture too; it asks first. Context packs in %USERPROFILE%\Startwell Capture are kept.

PowerShell
& ([scriptblock]::Create((irm https://capture.startwellventures.com/install.ps1))) -Uninstall

Or by hand on macOS:

  1. Quit Startwell Capture from the menu bar.
  2. Drag Startwell Capture from Applications to the Bin.
  3. Delete ~/Library/Application Support/Startwell Capture. This removes every capture, recording and setting.
  4. Delete ~/Startwell Capture if you do not want the context packs.
  5. Optional: delete Startwell Capture Safe Storage in Keychain Access.
rm -rf "/Applications/Startwell Capture.app" \
       ~/Library/Application\ Support/Startwell\ Capture \
       ~/Startwell\ Capture

Still stuck? Email team@startwellventures.com with your system and its version, and what you see.