Permissions & Accessibility
IrukaDark needs several OS-level permissions to capture your screen, read selected text, record audio, and simulate keyboard input. This page explains every permission, why it's needed, and how to enable it on each platform.
On first launch, IrukaDark automatically requests the required permissions. If you dismissed the prompts or need to change settings later, follow the guides below.
macOS
macOS requires you to explicitly grant each permission in System Settings → Privacy & Security.
Screen Recording
Required for: Screenshot Explain, AI Notetaker (system audio capture)
Without this permission, IrukaDark cannot capture any part of your screen or record system audio during meetings.
Open System Settings
Go to Apple menu → System Settings → Privacy & Security → Screen Recording.
Enable IrukaDark
Find IrukaDark in the list and toggle it on. If IrukaDark is not listed, click the + button and add it from your Applications folder.
Restart IrukaDark
macOS requires an app restart after granting Screen Recording permission. Quit IrukaDark completely and relaunch it.
Screen Recording permission changes require a restart. If you just toggled the permission on but screenshots still don't work, quit IrukaDark (Cmd+Q) and relaunch it.
Accessibility
Required for: Text selection capture, keyboard simulation (paste), window control
Without this permission, features like Text Explain, Translate & Replace, and clipboard paste will not work.
Open System Settings
Go to Apple menu → System Settings → Privacy & Security → Accessibility.
Enable IrukaDark
Find IrukaDark in the list and toggle it on. If not listed, click + and add it.
If the toggle is on but features still don't work, try removing IrukaDark from the list and re-adding it. This can fix stale permission states after app updates.
Microphone
Required for: AI Notetaker (microphone recording), voice input
Open System Settings
Go to Apple menu → System Settings → Privacy & Security → Microphone.
Enable IrukaDark
Toggle IrukaDark on.
Automation (Apple Events)
Required for: Sending scripted commands to other apps (e.g., pasting into specific applications)
This permission is usually granted automatically when IrukaDark first tries to interact with another app. If a prompt appears asking whether IrukaDark can control another application, click OK.
If you accidentally denied it:
- Go to System Settings → Privacy & Security → Automation
- Find IrukaDark and enable the target applications listed under it
macOS Permissions Summary
| Permission | Location in System Settings | Features Affected | Restart Required |
|---|---|---|---|
| Screen Recording | Privacy & Security → Screen Recording | Screenshot Explain, Notetaker (system audio) | Yes |
| Accessibility | Privacy & Security → Accessibility | Text Explain, Translate & Replace, Window Control, Clipboard Paste | No |
| Microphone | Privacy & Security → Microphone | Notetaker (mic audio), Voice Input | No |
| Automation | Privacy & Security → Automation | Paste into other apps | No |
Windows
Windows handles permissions differently — most are granted through system-level settings in Settings → Privacy & security.
Screen Capture
Required for: Screenshot Explain, AI Notetaker (screen recording)
Windows 11 does not require an explicit screen capture permission for desktop apps by default. However, if screenshots return a blank image or the Notetaker cannot list displays:
Check Graphics Driver
Outdated graphics drivers can cause screen capture failures. Update your GPU driver from the manufacturer's website (NVIDIA, AMD, or Intel).
Check "Let desktop apps access your screen" (Windows 11 24H2+)
On recent Windows 11 builds, go to Settings → Privacy & security → Screen capture and ensure the toggle is enabled.
Disable Hardware Acceleration (if blank screenshots)
Some apps use hardware acceleration that can cause captured images to appear blank. In the target app's settings, try disabling hardware acceleration.
Microphone
Required for: AI Notetaker (microphone recording), voice input
Open Settings
Go to Settings → Privacy & security → Microphone.
Enable Microphone Access
Ensure Microphone access is turned on at the top of the page, then confirm that Let desktop apps access your microphone is also enabled.
Keyboard Shortcuts Not Responding
IrukaDark registers global keyboard shortcuts. If shortcuts don't work:
- Check for conflicts — Other apps (screen recorders, clipboard managers, window managers) may have claimed the same shortcut. Close conflicting apps or remap shortcuts in IrukaDark's Settings.
- Run as Administrator — In rare cases, elevated apps block global shortcuts from non-elevated processes. Try running IrukaDark as Administrator once to confirm, then revert.
- Keyboard layout — Non-US keyboard layouts may map keys differently. Check IrukaDark's Settings to verify the bound keys match your layout.
Windows Permissions Summary
| Permission | Location in Settings | Features Affected |
|---|---|---|
| Screen Capture | Privacy & security → Screen capture | Screenshot Explain, Notetaker (screen recording) |
| Microphone | Privacy & security → Microphone | Notetaker (mic audio), Voice Input |
Common Issues
"Screen recording permission required" (macOS)
This error appears when starting the Notetaker without Screen Recording permission. Follow the Screen Recording steps above. Remember to restart IrukaDark after granting the permission.
"Microphone permission denied" (macOS / Windows)
The Notetaker cannot access your microphone.
- macOS: Check System Settings → Privacy & Security → Microphone
- Windows: Check Settings → Privacy & security → Microphone — ensure both the global toggle and the "desktop apps" toggle are on
Text Explain or Translate & Replace does nothing (macOS)
The Accessibility permission is likely missing or stale.
- Open System Settings → Privacy & Security → Accessibility
- If IrukaDark is listed but not working, remove it (click −), then re-add it (click +)
- No restart required — try the feature again immediately
Pasted text doesn't appear in the target app (macOS)
IrukaDark uses Accessibility to simulate Cmd+V in other apps. If paste doesn't work in a specific app:
- Ensure the Automation permission is granted for that app
- Some apps (e.g., Terminal, remote desktop clients) intercept paste differently. Try the regular
Cmd+Vshortcut manually to confirm paste works in that app
Shortcuts don't work after macOS update
macOS updates can reset privacy permissions. Re-enable IrukaDark in:
- Privacy & Security → Screen Recording
- Privacy & Security → Accessibility
Then restart IrukaDark.