Skip to content

Commit 32df0cb

Browse files
gHashTagona-agent
gHashTag
and
ona-agent
committed
feat: Add macOS installation script and guide
- Add install-mac.sh for one-command installation - Add MAC_INSTALLATION.md with detailed instructions - Support Chrome, Firefox, Arc, Brave, Edge on Apple Silicon - Recommend Arc browser for M4 Macs Install command: curl -fsSL https://raw.githubusercontent.com/.../install-mac.sh | bash Co-authored-by: Ona <no-reply@ona.com>
1 parent 038ea6e commit 32df0cb

2 files changed

Lines changed: 204 additions & 0 deletions

File tree

‎extension/MAC_INSTALLATION.md‎

Lines changed: 121 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,121 @@
1+
# NeoDetect Installation on MacBook Pro M4
2+
3+
## Quick Install (One Command)
4+
5+
Open Terminal and run:
6+
7+
```bash
8+
curl -fsSL https://raw.githubusercontent.com/gHashTag/trinity/main/extension/install-mac.sh | bash
9+
```
10+
11+
This will:
12+
1. Download Chrome and Firefox extensions
13+
2. Extract to `~/Applications/NeoDetect/`
14+
3. Open Chrome extensions page
15+
16+
## Manual Installation
17+
18+
### Chrome / Arc / Brave / Edge
19+
20+
1. **Download**: [neodetect-chrome-v2.0.0.zip](https://github.com/gHashTag/trinity/releases/download/ext-v2.0.0/neodetect-chrome-v2.0.0.zip)
21+
22+
2. **Extract**: Double-click the ZIP file to extract
23+
24+
3. **Install**:
25+
- Open Chrome (or Arc/Brave/Edge)
26+
- Go to `chrome://extensions/` (or `arc://extensions/`, `brave://extensions/`, `edge://extensions/`)
27+
- Enable **Developer mode** (toggle in top right)
28+
- Click **Load unpacked**
29+
- Select the extracted folder
30+
31+
4. **Verify**: Click the NeoDetect icon in toolbar
32+
33+
### Firefox
34+
35+
1. **Download**: [neodetect-firefox-v2.0.0.zip](https://github.com/gHashTag/trinity/releases/download/ext-v2.0.0/neodetect-firefox-v2.0.0.zip)
36+
37+
2. **Install**:
38+
- Open Firefox
39+
- Go to `about:debugging#/runtime/this-firefox`
40+
- Click **Load Temporary Add-on**
41+
- Select the ZIP file (or manifest.json inside)
42+
43+
3. **Note**: Firefox temporary add-ons are removed when Firefox closes. For permanent installation, submit to Firefox Add-ons.
44+
45+
### Safari
46+
47+
Safari requires extensions to be packaged as native macOS apps. This is not currently supported.
48+
49+
**Workaround**: Use Chrome, Arc, or Brave on your MacBook Pro M4.
50+
51+
## Recommended Browser for M4
52+
53+
For best performance on Apple Silicon (M4):
54+
55+
| Browser | Recommendation |
56+
|---------|----------------|
57+
| **Arc** | ⭐ Best - Native Apple Silicon, Chrome extensions |
58+
| **Chrome** | ✅ Good - Native Apple Silicon |
59+
| **Brave** | ✅ Good - Native Apple Silicon, privacy-focused |
60+
| **Firefox** | ✅ Good - Native Apple Silicon |
61+
| **Safari** | ❌ Extension not supported |
62+
63+
## Verify Installation
64+
65+
1. Click the NeoDetect icon in your browser toolbar
66+
2. You should see the popup with:
67+
- Protection status (Enabled)
68+
- OS/Hardware/GPU dropdowns
69+
- Protection toggles
70+
71+
3. Test fingerprint protection:
72+
- Go to https://browserleaks.com/canvas
73+
- Your fingerprint should be different from your real one
74+
75+
## Troubleshooting
76+
77+
### Extension not loading
78+
79+
1. Make sure Developer mode is enabled
80+
2. Check that you selected the correct folder (containing `manifest.json`)
81+
3. Check Chrome console for errors: `chrome://extensions/` → Details → Errors
82+
83+
### WASM not loading
84+
85+
1. Check that `wasm/neodetect.wasm` exists in the extension folder
86+
2. Try reloading the extension
87+
88+
### Popup not opening
89+
90+
1. Click the puzzle icon in Chrome toolbar
91+
2. Pin NeoDetect extension
92+
3. Click the NeoDetect icon
93+
94+
## Uninstall
95+
96+
### Chrome / Arc / Brave / Edge
97+
98+
1. Go to `chrome://extensions/`
99+
2. Find NeoDetect
100+
3. Click **Remove**
101+
102+
### Firefox
103+
104+
1. Go to `about:addons`
105+
2. Find NeoDetect
106+
3. Click **Remove**
107+
108+
### Remove files
109+
110+
```bash
111+
rm -rf ~/Applications/NeoDetect
112+
```
113+
114+
## Support
115+
116+
- **Issues**: https://github.com/gHashTag/trinity/issues
117+
- **Releases**: https://github.com/gHashTag/trinity/releases
118+
119+
---
120+
121+
**KOSCHEI IS IMMORTAL | GOLDEN CHAIN IS CLOSED**

‎extension/install-mac.sh‎

Lines changed: 83 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,83 @@
1+
#!/bin/bash
2+
# NeoDetect Extension Installer for macOS
3+
# Works on MacBook Pro M4 and all Apple Silicon Macs
4+
5+
set -e
6+
7+
echo "═══════════════════════════════════════════════════════════"
8+
echo " NeoDetect Anti-Detect Browser Extension Installer"
9+
echo " Version: 2.0.0"
10+
echo "═══════════════════════════════════════════════════════════"
11+
echo ""
12+
13+
# Colors
14+
GREEN='\033[0;32m'
15+
YELLOW='\033[1;33m'
16+
CYAN='\033[0;36m'
17+
NC='\033[0m' # No Color
18+
19+
INSTALL_DIR="$HOME/Applications/NeoDetect"
20+
CHROME_EXT_DIR="$INSTALL_DIR/chrome"
21+
FIREFOX_EXT_DIR="$INSTALL_DIR/firefox"
22+
23+
# Create installation directory
24+
echo -e "${CYAN}Creating installation directory...${NC}"
25+
mkdir -p "$INSTALL_DIR"
26+
mkdir -p "$CHROME_EXT_DIR"
27+
mkdir -p "$FIREFOX_EXT_DIR"
28+
29+
# Download latest release
30+
RELEASE_URL="https://github.com/gHashTag/trinity/releases/download/ext-v2.0.0"
31+
CHROME_ZIP="neodetect-chrome-v2.0.0.zip"
32+
FIREFOX_ZIP="neodetect-firefox-v2.0.0.zip"
33+
34+
echo -e "${CYAN}Downloading Chrome extension...${NC}"
35+
curl -L -o "$INSTALL_DIR/$CHROME_ZIP" "$RELEASE_URL/$CHROME_ZIP"
36+
37+
echo -e "${CYAN}Downloading Firefox extension...${NC}"
38+
curl -L -o "$INSTALL_DIR/$FIREFOX_ZIP" "$RELEASE_URL/$FIREFOX_ZIP"
39+
40+
# Extract extensions
41+
echo -e "${CYAN}Extracting Chrome extension...${NC}"
42+
unzip -o "$INSTALL_DIR/$CHROME_ZIP" -d "$CHROME_EXT_DIR"
43+
44+
echo -e "${CYAN}Extracting Firefox extension...${NC}"
45+
unzip -o "$INSTALL_DIR/$FIREFOX_ZIP" -d "$FIREFOX_EXT_DIR"
46+
47+
# Clean up zip files
48+
rm "$INSTALL_DIR/$CHROME_ZIP"
49+
rm "$INSTALL_DIR/$FIREFOX_ZIP"
50+
51+
echo ""
52+
echo -e "${GREEN}═══════════════════════════════════════════════════════════${NC}"
53+
echo -e "${GREEN} Installation Complete!${NC}"
54+
echo -e "${GREEN}═══════════════════════════════════════════════════════════${NC}"
55+
echo ""
56+
echo -e "Extensions installed to: ${YELLOW}$INSTALL_DIR${NC}"
57+
echo ""
58+
echo -e "${CYAN}To install in Chrome:${NC}"
59+
echo " 1. Open Chrome"
60+
echo " 2. Go to chrome://extensions/"
61+
echo " 3. Enable 'Developer mode' (top right)"
62+
echo " 4. Click 'Load unpacked'"
63+
echo " 5. Select: $CHROME_EXT_DIR"
64+
echo ""
65+
echo -e "${CYAN}To install in Firefox:${NC}"
66+
echo " 1. Open Firefox"
67+
echo " 2. Go to about:debugging#/runtime/this-firefox"
68+
echo " 3. Click 'Load Temporary Add-on'"
69+
echo " 4. Select: $FIREFOX_EXT_DIR/manifest.json"
70+
echo ""
71+
echo -e "${CYAN}To install in Safari:${NC}"
72+
echo " Safari requires a native app wrapper (not supported yet)"
73+
echo ""
74+
echo -e "${CYAN}To install in Arc/Brave/Edge:${NC}"
75+
echo " Use the Chrome extension - same process as Chrome"
76+
echo ""
77+
78+
# Open Chrome extensions page
79+
echo -e "${YELLOW}Opening Chrome extensions page...${NC}"
80+
open "chrome://extensions/" 2>/dev/null || echo "Could not open Chrome automatically"
81+
82+
echo ""
83+
echo "KOSCHEI IS IMMORTAL | GOLDEN CHAIN IS CLOSED"

0 commit comments

Comments
 (0)