Skip to content

docs: Update installation guide with download option #4

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
RAKKUNN merged 1 commit into from
Apr 4, 2026
+31 −6
Merged

docs: Update installation guide with download option #4

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 15 additions & 2 deletions GUIDE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,20 @@ DualClip is a multi-slot clipboard manager that lives in the macOS menu bar. It

## 1. Installation

### Building with Xcode (Recommended)
### Option A: Download from GitHub Releases (Recommended)

1. Go to the [latest release](https://github.com/RAKKUNN/DualClip/releases/latest)
2. Download `DualClip-x.x.x-arm64.zip`
3. Unzip the file
4. Move `DualClip.app` to your `/Applications` folder
5. Double-click to launch

> **⚠️ First Launch Security Warning**: Since DualClip is not notarized with Apple, macOS will block the app on first launch. To allow it:
> 1. Open **System Settings → Privacy & Security**
> 2. Scroll down and click **"Open Anyway"** next to the DualClip message
> 3. Click **"Open"** in the confirmation dialog

### Option B: Building with Xcode

```bash
# 1. Clone the repository
Expand All @@ -41,7 +54,7 @@ open Package.swift
# - Press ⌘R to build & run
```

### Building with Command Line Tools Only
### Option C: Building with Command Line Tools Only

You can build without Xcode (requires Swift 5.9+ Command Line Tools):

Expand Down
20 changes: 16 additions & 4 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,19 @@ All shortcuts are fully customizable in **Settings > Shortcuts**.
- macOS 13.0 (Ventura) or later
- Accessibility permission (required for keystroke simulation)

## Building from Source
## Installation

### Download (Recommended)

1. Go to the [latest release](https://github.com/RAKKUNN/DualClip/releases/latest)
2. Download `DualClip-x.x.x-arm64.zip`
3. Unzip and move `DualClip.app` to `/Applications`
4. On first launch: **System Settings → Privacy & Security → "Open Anyway"**
5. Grant Accessibility permission when prompted

> **Note**: This app is not notarized. macOS will show a security warning on first launch — this is expected for open-source apps without an Apple Developer certificate.

### Building from Source

```bash
# Clone the repository
Expand All @@ -54,11 +66,11 @@ cd DualClip
# Open in Xcode
open Package.swift

# Or build from command line (requires Xcode)
xcodebuild -scheme DualClip -configuration Release
# Or build from command line
swift build -c release
```

> **Note**: Xcode is required to build the app. The project uses Swift Package Manager for dependency management.
> **Note**: Building from source requires Xcode or Swift 5.9+ Command Line Tools.

## Dependencies

Expand Down
Loading