Nexus

███╗   ██╗███████╗██╗  ██╗██╗   ██╗███████╗
████╗  ██║██╔════╝╚██╗██╔╝██║   ██║██╔════╝
██╔██╗ ██║█████╗   ╚███╔╝ ██║   ██║███████╗
██║╚██╗██║██╔══╝   ██╔██╗ ██║   ██║╚════██║
██║ ╚████║███████╗██╔╝ ██╗╚██████╔╝███████║
╚═╝  ╚═══╝╚══════╝╚═╝  ╚═╝ ╚═════╝ ╚══════╝

Native macOS Safari bookmark manager and batch URL opener. Organize bookmarks, batch open URLs, and manage your browsing workflow with a modern, neon-themed interface.

---

Features

• Safari Integration — batch open URLs in Safari via AppleScript
• Hierarchical Bookmarks — drag-and-drop folder organization
• Smart URL Extraction — find valid links in any pasted text
• Private Browsing — one-click stealth/private mode support
• Export / Import — back up your collections as JSON
• Apple Silicon Native — arm64 build optimized for M1/M2/M3/M4 chips

---

Installation

1. Download the latest Nexus.dmg from Releases
2. Open the DMG and drag Nexus.app to /Applications
3. First launch — right-click the app → Open to bypass Gatekeeper on the ad-hoc signed build
4. Go to System Settings → Privacy & Security → Automation and enable Safari for Nexus

---

Usage

1. Add Bookmarks — click + or paste URLs directly
2. Organize — create folders and drag to rearrange
3. Batch Open — select multiple bookmarks → Open in Safari
4. Extract URLs — paste any block of text and Nexus finds all valid links automatically

---

Development

Requirements

• Python 3.14
• macOS 12.0+
• uv

Setup

git clone https://github.com/RazorBackRoar/Nexus.git
cd Nexus
uv sync
uv run python -m nexus.main

Build

razorbuild Nexus
# Output: dist/Nexus.dmg

Lint & Test

uv run ruff check .
uv run ty check src --python-version 3.14
uv run pytest tests/ -q

---

License

MIT License — see LICENSE for details. Copyright © 2026 RazorBackRoar

Runtime Requirements

For users:

• Download the macOS .dmg or .app release. Python does not need to be installed.

For developers:

• Primary development/build target: Python 3.14 with uv.
• Source compatibility goal: Python 3.12-3.14 (best effort).
• Setup: uv sync
• Run: uv run python -m nexus