Ophel Atlas 🚀

Browser Extension

1. Download & unzip from Releases
2. Open browser extensions page, enable Developer mode
3. Click Load unpacked and select the unzipped folder

Userscript

1. Install Tampermonkey
2. Download .user.js file from Releases
3. Drag into browser or click the link to install

Userscript managers cannot let Ophel add new @match entries automatically. After adding a custom site under Settings → Site Packs, copy every rule shown in the userscript access notice and add it through your manager:

• Tampermonkey: open the Ophel script, select Settings → Includes/Excludes → User matches, add the copied rules, and save.
• Violentmonkey: open the Ophel script settings and add the rules under its custom @match rules.
• ScriptCat: open the script settings and add the rules under user/custom match rules; the label can vary by ScriptCat version.

Reload each target site after saving. Prefer manager-side custom rules over editing Ophel's metadata header directly: custom rules are retained when the userscript updates.

Requirements: Node.js >= 18.x, pnpm >= 9.x

# 1. Clone the repo and enter the project directory
git clone https://github.com/urzeye/ophel.git
cd ophel

# 2. Install dependencies
pnpm install

# 3. Start development server (supports browser extension HMR)
pnpm dev

# ======== Build and Package ========

# Build production versions for respective browsers
pnpm build              # Build Chrome extension
pnpm build:firefox      # Build Firefox extension
pnpm build:all          # Build for all platforms

# Package into distributeable archives (.zip)
pnpm package            # Package Chrome extension from existing build
pnpm package:firefox    # Package Firefox extension from existing build
pnpm package:all        # Package all platforms

# ======== Userscript Development ========

pnpm build:userscript:local    # Build userscript for local debugging
pnpm serve:userscript:assets   # Serve static assets locally