Getting started4
    Installing ScreenKiteSystem RequirementsSetting Up PermissionsPermissions & Access
    Recording7
    New RecordingRecording an AreaRecording a WindowRecording Full DisplayRecording iOS DevicesWebcam & MicrophoneSystem Audio
    Editing7
    Project Editor OverviewAuto ZoomConfiguring Zoom SettingsTimeline & TracksTrimming & SplittingAppearance CustomizationDevice Frames
    Shipping16
    Export SettingsKeyboard ShortcutsCommon IssuesContinue RecordingSharing ScreenshotsB-Roll LibraryText-Based EditingScene TransitionsBackground MusicAgentic Video EditingWord-Level Generated CaptionsPreview QualityAI Chat AssistantEditor SettingsExport a Section (In/Out Range)Export to Final Cut Pro (FCPXML)
    ← ScreenKite homepage
    Guide/Getting started/Permissions & Access

    Permissions & Access

    Troubleshooting permission issues on macOS.

    Troubleshooting
    💡

    Prefer to have your agent do it? Copy this page as a prompt and paste it into Claude Code, Codex, Grok or Kimi.

    ClaudeClaudeOpenAIChatGPTGrokGrok

    Permission Not Taking Effect

    macOS sometimes requires an app restart after granting permissions.

    1. Quit ScreenKite completely (⌘+Q or right-click Dock icon → Quit)
    2. Grant or toggle the permission in System Settings → Privacy & Security
    3. Relaunch ScreenKite

    ScreenKite checks permission states on every launch and guides you through any missing permissions via the onboarding flow.

    Screen Recording Permission Keeps Resetting

    This can happen after macOS updates or if the app bundle was modified.

    1. Open System Settings → Privacy & Security → Screen Recording
    2. Remove ScreenKite from the list (minus button)
    3. Re-add it (plus button, select from Applications)
    4. Restart ScreenKite
    ⚠️

    On macOS 14+, toggling the permission off and on may not be enough. You may need to remove and re-add the app.

    Automatic Settings Navigation

    When a permission check fails, ScreenKite automatically opens the correct System Settings pane for you — no need to navigate there manually.

    Duplicate Instance Detection

    ScreenKite checks for duplicate instances on launch. If another copy is already running, the app will alert you. Quit the other instance before launching.

    Crash Reporting

    ScreenKite uses Sentry for crash reporting. If you experience a crash, diagnostic data is sent automatically (no personal data). You can share your macOS version and ScreenKite version when contacting support to help us investigate.

    Dock Visibility

    ScreenKite can run as a menu bar-only app or show in the Dock:

    • Settings → General → Show in Dock
    • When disabled, ScreenKite runs as a menu bar-only app
    • When enabled, it appears in the Dock and Cmd+Tab switcher
    ✅

    Running ScreenKite as a menu bar-only app keeps your Dock clean. Toggle this in Settings → General → Show in Dock.

    ← PreviousCommon Issues

    On this page

    Permission Not Taking EffectScreen Recording Permission Keeps ResettingAutomatic Settings NavigationDuplicate Instance DetectionCrash ReportingDock Visibility