← Back to Help center
Troubleshooting

Install warnings: macOS Gatekeeper, Windows SmartScreen, Linux AppImage

The OS may warn the first time you run Dimmy. These warnings are expected for indie apps. Here's how to bypass them safely.

macOS: "Dimmy can't be opened" (Gatekeeper)

Dimmy is built with a free Apple Developer ID, not yet notarised. Gatekeeper shows a warning the first time. To allow it:

  1. Right-click Dimmy.app in Applications (or the DMG) → Open.
  2. A second dialog appears with an Open button. Click it. Future launches will not warn.
  3. If you only see a Cancel button, open System Settings → Privacy & Security and click Open Anyway at the bottom.
image · placeholder
Right-click → Open dialog on macOS

Windows: SmartScreen "Windows protected your PC"

  1. The installer is signed by KonradDallaOrg, but the certificate is new. SmartScreen learns to trust new signatures over a few weeks of installs.
  2. Click More info at the top of the dialog.
  3. Click Run anyway.
  4. Installation continues normally.
image · placeholder
SmartScreen dialog with More info link

Linux: AppImage permission denied

AppImages need execute permission before they can run. Do it once:

bash
chmod +x Dimmy-linux-x86_64.AppImage
./Dimmy-linux-x86_64.AppImage
Was this helpful?

In this category

Troubleshooting
Mic or hotkey not working
Check OS permissions first. Then check hotkey conflicts. The pill tells you which one of the two is failing.
Troubleshooting
Empty, wrong, or slow transcription
Three different problems, three checks: silence in the audio, wrong language detected, model or provider mismatch.
Last updated: 2026-05-22