Skip to content

Commit 797fee4

Browse files
committed
docs: improve installation and permission instructions
- add security note with xattr command to bypass Gatekeeper - update permission section to mention auto-prompt on first launch - add menu bar icon as alternative way to access permission guide - add mise tasks for resetting accessibility and removing quarantine
1 parent 35f697d commit 797fee4

File tree

3 files changed

+25
-3
lines changed

3 files changed

+25
-3
lines changed

PressViz/AppDelegate.swift

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,9 @@ final class AppDelegate: NSObject, NSApplicationDelegate {
3030
AppSettings.shared.hasCompletedOnboarding = true
3131
startVisualization()
3232
} else {
33-
// 権限がない場合は監視を開始して、付与されたら自動で開始
33+
// ネイティブダイアログを表示(BundleIDごとに1回のみ有効)
34+
permissionManager.requestAccessibility()
35+
// 権限付与を監視して、付与されたら自動で開始
3436
permissionManager.startMonitoring()
3537
}
3638
}

README.md

Lines changed: 14 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,16 @@ A native macOS app for visualizing keyboard presses.
99
3. Drag PressViz to your Applications folder
1010
4. Launch PressViz from Applications
1111

12+
### Security Note
13+
14+
PressViz is not notarized by Apple. On first launch, macOS may block the app.
15+
16+
To allow it, run this command in Terminal:
17+
18+
```bash
19+
xattr -cr /Applications/PressViz.app
20+
```
21+
1222
### Requirements
1323

1424
- macOS 26.2+
@@ -17,8 +27,10 @@ A native macOS app for visualizing keyboard presses.
1727

1828
PressViz requires **Accessibility** permission to monitor keyboard input.
1929

20-
1. Open System Settings > Privacy & Security > Accessibility
21-
2. Enable PressViz
30+
On first launch, macOS will prompt you to grant permission. If you dismissed the prompt:
31+
32+
- Click the PressViz icon in the menu bar to open the permission guide, or
33+
- Enable manually: System Settings > Privacy & Security > Accessibility
2234

2335
## Development
2436

mise.toml

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -46,3 +46,11 @@ create-dmg \
4646
4747
echo "Created ${APP_NAME}.dmg"
4848
"""
49+
50+
[tasks.reset-accessibility]
51+
description = "Reset Accessibility permission for PressViz"
52+
run = "tccutil reset Accessibility com.mfyuu.PressViz"
53+
54+
[tasks.remove-quarantine]
55+
description = "Remove quarantine attribute from PressViz.app"
56+
run = "xattr -cr /Applications/PressViz.app"

0 commit comments

Comments
 (0)