Nexus

Native macOS Safari bookmark manager and batch URL opener.

Organize bookmarks, batch open URLs, and manage your browsing workflow with a dark native interface.

↓ Download Nexus.dmg · All releases

Features

• Safari Integration — batch open URLs in Safari via AppleScript
• Quick Save — dated URL blocks with notes (Ctrl+Shift+S); copy or delete via right-click
• Bookmark Groups — save named groups under any tab; draggable group rows
• Copy Rich Links — Apple Notes–friendly HTML links to the clipboard
• Smart URL Extraction — paste text or drop .txt/.csv/.md onto the URL table
• Hierarchical Bookmarks — drag-and-drop folder organization across nine columns
• Private Browsing — one-click stealth/private mode support
• Export / Import — back up your collections as JSON
• Apple Silicon Native — arm64 build optimized for M-series Macs

---

Install

1. Download Nexus.dmg
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 +, paste URLs, or drop a text file onto the URL table
2. Quick Save — press Ctrl+Shift+S to capture the current URL block with a timestamp
3. Organize — create folders, save groups, and drag to rearrange
4. Batch Open — select bookmarks → Open in Safari
5. Rich Links — copy formatted links for Apple Notes

Data files live under ~/Library/Application Support/Nexus/: bookmarks_v2.json and bookmark_groups.json.

---

Development

Requirements

• Python 3.14
• macOS 12.0+
• uv

Setup

git clone https://github.com/RazorBackRoar/Nexus.git
cd Nexus
# Workspace layout: sibling Apps/.razorcore provides editable razorcore
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

---

Community & docs

• docs/ARCHITECTURE.md — persistence model, modules, testing
• BUILD_AND_RELEASE.md — prerequisites, build, packaging, release, versioning
• CONTRIBUTING.md — how to contribute
• SECURITY.md — vulnerability reporting
• CODE_OF_CONDUCT.md — community standards

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/build target: Python 3.14 only.
• Setup: uv sync
• Run: uv run python -m nexus.main