Skip to content

Commit 367ae3e

Browse files
authored
Merge pull request #21 from krasnican/master
docs: add terminal workaround for macOS Gatekeeper quarantine errors
2 parents b30307a + a603460 commit 367ae3e

1 file changed

Lines changed: 12 additions & 1 deletion

File tree

README.md

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,13 +27,24 @@ Made with PyObjC, pywebview, ApexCharts, PyInstaller.
2727

2828
### Important notes
2929

30-
Because the application is not signed, you will need to follow the steps below in order to run the application.
30+
Because the application is not signed, macOS Gatekeeper may prevent it from opening. You can bypass this using one of the following methods.
3131

32+
**Method 1: Context Menu**
3233
1. **Right-click on the app icon**,
3334
2. select "Open" from the context menu, and
3435
3. select "OK" in the dialog below.\
3536
<img src="https://user-images.githubusercontent.com/291323/179491872-3a9e6c4c-b8cb-4081-ac88-bd1817d6ba4d.png" width="300px" />
3637

38+
**Method 2: Terminal (If you only see "Move to Bin")**
39+
If macOS shows an error that it *"could not verify 'Tiny Wi-Fi Analyzer.app' is free of malware"* with no option to open it, you must manually remove the quarantine attribute.
40+
41+
1. Open **Terminal**.
42+
2. Run the following command (assuming you placed the app in your Applications folder):
43+
```sh
44+
xattr -d com.apple.quarantine /Applications/Tiny\ Wi-Fi\ Analyzer.app
45+
```
46+
3. Launch the application normally.
47+
3748
On macOS 14 Sonoma and later, Location Services permission is required to get Wi-Fi SSIDs.
3849
Please enable Location Services by following the instructions.
3950

0 commit comments

Comments
 (0)