From 822e82d989d653aa16e6ed13d88ac0ae36a87b74 Mon Sep 17 00:00:00 2001
From: RAKKUNN <woojinim64@gmail.com>
Date: Sat, 4 Apr 2026 20:12:02 +0900
Subject: [PATCH] Update installation docs with GitHub Releases download option

- README: Add Download section as recommended install method
- GUIDE: Restructure as Option A (download) / B (Xcode) / C (CLI)
- Include Gatekeeper security warning instructions
---
 GUIDE.md  | 17 +++++++++++++++--
 README.md | 20 ++++++++++++++++----
 2 files changed, 31 insertions(+), 6 deletions(-)

diff --git a/GUIDE.md b/GUIDE.md
index cc31782..47defc6 100644
--- a/GUIDE.md
+++ b/GUIDE.md
@@ -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
@@ -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):
 
diff --git a/README.md b/README.md
index 0596e17..dd26f58 100644
--- a/README.md
+++ b/README.md
@@ -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
@@ -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