Skip to content

Commit 92a9593

Browse files
docs: add detailed first launch instructions and ad-hoc signing note to README and release workflow
1 parent 2f8d4f6 commit 92a9593

2 files changed

Lines changed: 23 additions & 3 deletions

File tree

.github/workflows/release.yml

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -66,10 +66,19 @@ jobs:
6666
- **Apple Silicon** (M1, M2, M3): Download the `aarch64` version
6767
- **Intel Mac**: Download the `x64` version
6868
2. Open the DMG and drag Better Shot to Applications
69-
3. **First Launch**: Right-click the app → **Open** → Click **Open** again to bypass Gatekeeper
69+
3. **First Launch** - Choose one method (recommended):
70+
71+
**Option A: Right-Click Method** (Easiest)
72+
- Right-click the app → **Open** → Click **Open** in the dialog
73+
74+
**Option B: Terminal Method** (One command, no dialogs) (recommended)
75+
```bash
76+
xattr -d com.apple.quarantine /Applications/bettershot.app
77+
```
78+
7079
4. Grant Screen Recording permission when prompted in System Settings
7180
72-
**Note**: This app uses ad-hoc signing. You'll need to right-click and select "Open" on first launch.
81+
> **Note**: This is an ad-hoc signed indie app. macOS shows a warning for apps not notarized through Apple's $99/year developer program. The app is completely safe and open source.
7382
7483
## What's New
7584

README.md

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -65,9 +65,20 @@ Better Shot is a fast, lightweight screenshot tool built with Tauri and React. I
6565
- **Apple Silicon** (M1, M2, M3): `bettershot_*_aarch64.dmg`
6666
- **Intel Mac**: `bettershot_*_x64.dmg`
6767
3. Open the DMG and drag Better Shot to Applications
68-
4. On first launch, right-click the app and select "Open" to bypass Gatekeeper
68+
4. **First Launch** (choose one method):
69+
70+
**Option A: Right-Click Method** (Easiest)
71+
- Right-click the app → **Open** → Click **Open** in the dialog
72+
73+
**Option B: Terminal Method** (One command, no dialogs) (recommended)
74+
```bash
75+
xattr -d com.apple.quarantine /Applications/bettershot.app
76+
```
77+
6978
5. Grant Screen Recording permission when prompted
7079

80+
> **Note**: Better Shot is ad-hoc signed (free indie app). macOS Gatekeeper shows a warning for apps not notarized through Apple's $99/year developer program. The app is safe - you can [view the source code](https://github.com/KartikLabhshetwar/better-shot) and build it yourself.
81+
7182
### From Source
7283

7384
```bash

0 commit comments

Comments
 (0)