Installation

Installation Guide

This guide will help you install Clipboard Recast on your macOS system.

System Requirements

Before installing, ensure your system meets these requirements:

• macOS 13.0 (Ventura) or later
• An API key from one of the supported AI providers

Installing via DMG

Step 1: Download the DMG

After your purchase, download the Clipboard Recast .dmg file from your download link.

Step 2: Open the DMG

1. Locate the downloaded .dmg file in your Downloads folder
2. Double-click the DMG file to mount it
3. A new window will open showing the Clipboard Recast application

Step 3: Install the Application

1. Drag the Clipboard Recast icon to the Applications folder
2. Wait for the copy to complete
3. Eject the DMG by clicking the eject button in Finder

Step 4: First Launch

Open your Applications folder and double-click Clipboard Recast.

Clipboard Recast is signed with an Apple Developer ID and notarized by Apple, so it launches normally — no special steps, no security warnings. The first time you open it, macOS may show a one-time “downloaded from the Internet, are you sure you want to open it?” dialog; just click Open.

Step 5: Grant Permissions

When you first launch Clipboard Recast, you’ll need to grant it certain permissions:

1. Accessibility Access: Required for the global hotkey (Cmd+Shift+A)

   • Go to System Settings > Privacy & Security > Accessibility
   • Enable Clipboard Recast in the list

2. Clipboard Access: Required to monitor and transform clipboard content

   • The app will request this permission on first use
   • Click “Allow” when prompted

Verifying Installation

After installation, you should see the Clipboard Recast icon in your menu bar (top-right corner of your screen). The icon looks like a clipboard.

Next Steps

Now that Clipboard Recast is installed, proceed to First-Time Setup to configure your AI provider and start using the app.

Uninstalling

To uninstall Clipboard Recast:

1. Quit the app from the menu bar icon
2. Move Clipboard Recast from Applications to Trash
3. (Optional) Remove stored preferences:

   defaults delete com.clipboardrecast.app

Troubleshooting Installation

macOS asks “are you sure you want to open it?”

This is the normal one-time prompt macOS shows for any app downloaded from the Internet. Click Open and it won’t ask again.

Icon doesn’t appear in menu bar

• Check Activity Monitor to confirm the app is running
• Try quitting and relaunching the app
• Check System Settings > General > Login Items

For more help, see the Troubleshooting section.