# Install warnings: macOS Gatekeeper, Windows SmartScreen, Linux AppImage. Dimmy Help.

> Install warnings: macOS Gatekeeper, Windows SmartScreen, Linux AppImage. Step-by-step help for Dimmy, the native voice dictation app for macOS, Windows, and Linux.

Source: https://dimmy.app/help/install-issues/

[← Back to Help center](https://dimmy.app/help/)

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

info

Notarisation is on the roadmap. Until then, this two-step bypass is the standard workflow for new indie macOS apps.

## 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`

info

Some distros sandbox AppImages by default (e.g. Fedora with bubblewrap). If Dimmy can't open the microphone, integrate it via your DE's AppImage launcher or run with --no-sandbox.

Was this helpful? 

## In this category

[ TroubleshootingMic or hotkey not workingCheck OS permissions first. Then check hotkey conflicts. The pill tells you which one of the two is failing.](https://dimmy.app/help/mic-and-hotkey/) [ TroubleshootingEmpty, wrong, or slow transcriptionThree different problems, three checks: silence in the audio, wrong language detected, model or provider mismatch.](https://dimmy.app/help/transcription-issues/)

Last updated: 2026-05-22

On this page

1. [01 macOS: "Dimmy can't be opened" (Gatekeeper)](#macos-dimmy-cant-be-opened-gatekeeper)
2. [02 Windows: SmartScreen "Windows protected your PC"](#windows-smartscreen-windows-protected-your-pc)
3. [03 Linux: AppImage permission denied](#linux-appimage-permission-denied)