Troubleshooting Checklist

Check permissions, shortcut conflicts, app overrides and device registration.

Pro, Sync & TroubleshootingCaptured interfaces · 0:08 loop

Captured client interfaces with sample data; blue outlines are guide annotations.

Key Highlights

5-Step Selection & Trigger Diagnostic

Verify Enable SwiftBiu is on, Hold-to-Ignore isn’t held, the frontmost app isn’t disabled/overridden in App Configuration, cursor is inside Effective Control Area, and Accessibility TCC cache is fresh.

One-Screen Shortcut & Prefix Conflict Fix

Use Shortcut Overview to spot red Hard Conflicts, or switch Single Modifier Response Mode to Compatible when mixing single-modifier and chord shortcuts.

Sandbox & Folder Write Fixes

When file output fails, authorize the actual working folder and check output paths and supported file types.

Seat & Sync Self-Recovery

Free old seats in Manage Devices, use Reactivate This Mac if previously removed, and confirm macOS 14+ for Clipboard History iCloud sync.

Custom Configuration

View all 4 custom options & thresholds
Setting / Control What it controls
Enable SwiftBiu Check first in General or Menu Bar that SwiftBiu wasn’t paused via the pause shortcut.
App Configuration Verify the current app isn’t turned off or using a Custom override hiding your expected action.
Shortcut Overview Inspect Conflicts & Shared to clear colliding global shortcuts.
Folder Authorization Add working directories so file actions can read/write without repeated macOS dialogs.

Settings Path & Prerequisites

  • Avoid running the website and App Store editions at the same time.

Troubleshooting

Expand common questions & fixes (4)

Triggers stopped working right after updating SwiftBiu?

Open System Settings → Privacy & Security → Accessibility, select SwiftBiu, click '-' to remove stale TCC signature cache, then click '+' to add /Applications/SwiftBiu.app again.

Why does SwiftBiu work everywhere except one specific app?

Check App Configuration for that app (enable switch, Effective Control Area margins, or Custom trigger override). For Electron/cross-platform apps without native AX text exposure, use Copy Trigger (⌘C) or Slide-to-OCR.

Why can enable only one File Action or Extension at a time?

Free tier allows manual switching with 1 active advanced File/Shortcut/Extension slot; upgrading to SwiftBiu Pro unlocks enabling unlimited actions simultaneously.

Where can I send logs or feedback if an issue persists?

Open About → Forum (forum.swiftbiu.com) or Feedback (support@swiftbiu.com) with your macOS version and edition.