thomasthanos/nexusmods-bypass

Chrome, Edge, Brave, Opera

1. Download the latest nexus.mods.bypass-<version>.zip from the Releases page.
2. Extract the .zip file into a new folder.
3. Open chrome://extensions (or edge://extensions).
4. Enable Developer mode in the top right.
5. Click Load unpacked and select the folder you just extracted.

Firefox 140 or newer

1. Download the latest nexus.mods.bypass-<version>-firefox.zip from the Releases page.
2. Open about:debugging#/runtime/this-firefox.
3. Click Load Temporary Add-on and select the .zip file directly (no need to extract it).

Temporary installation: A temporary add-on is unloaded when Firefox closes. Installing it permanently requires downloading from the official AMO store.

• Quick setup: presets Vortex user, Browser downloads and Minimal (a mix shows as Custom).
• Download flow: auto-start, close the extra tab after sending to Vortex, check that Vortex opens (turn off for another mod manager that handles nxm:// links), skip requirements, error popups, hide ads and Premium panels, archived file buttons, Wabbajack import, smallest files first.
• Files: browser download folder. Optional .meta files for Mod Organizer 2 beside each file saved in the browser, from a mod page or a collection, so MO2 shows the mod's description and opens its Nexus page (off by default).
• Official Nexus API: use the documented API for collection, mod and file details (on), follow curator update policy (off), endorse and track buttons (on). See docs/nexus-site-map.md.
• Advanced: request timeout (at least 15 seconds), close-tab delay, Vortex download speed and pause between files, official API, open a page when Nexus asks for a browser check (on by default, also for collections; turning it off asks first).
• Language: Always use English.

Settings, history and logs stay in local extension storage; no analytics or accounts. Reports are opt-in and show the exact redacted JSON first. Details: PRIVACY.md.

• Send bug report (popup → Help & Bugs, or Add details on an error): describe it, review the redacted JSON, then send through the relay, save/copy it, or open a prefilled GitHub issue.
• Ideas and questions (Help & Bugs → Report on GitHub → Idea or suggestion or Question, or Suggest an idea in the settings): open a new GitHub discussion in Ideas or Q&A, where others can upvote and answer. Bug reports stay issues.
• Debug log (Help & Bugs → Debug log): opt-in live log with filters, search and export.
• Automatic error reports: off by default. A one-time, keyboard-accessible invitation on Nexus Mods after an update lets you opt in with one click, without another browser permission. New extension faults send minimal technical diagnostics; repeated faults are grouped, failed sends retry, and you can switch reporting off at any time.

Downloads do not start

Sign in to Nexus Mods and enable Start downloads automatically in Page settings.

Vortex does not receive the file

Start Vortex first, and sign it in to the same Nexus account as this browser: Vortex refuses links made for another account. In Vortex, Settings → Download → Handle Mod Manager Download buttons on nexusmods.com must be on (on Linux, whichever mod manager registered for nxm:// last receives the links). If Vortex stays in the background, look in its Downloads tab: the file may already be there.

The collection queue pauses or runs slowly

Rate limits pause the queue temporarily; it resumes automatically. Keep the collection tab open and Hide ads and Premium panels enabled, so its ad-timer cookie stays current for the background queue.

Already downloaded files start again

Choose Skip Downloaded when the history dialog appears. Cleared history cannot identify files already on disk.

Files are saved in the wrong folder

Browser download folder in Page settings is a folder inside the browser's download location, such as NexusMods; a browser lets an extension save nowhere else, so a full path like D:\mods cannot go there. To save to D:\mods, choose it as the download location in the browser's own settings and leave Browser download folder empty (the default since 3.3.2). Vortex keeps its own download folder.

Opera: a file in a folder set here goes inside the system Downloads folder, not the location chosen in Opera's settings. Leave Browser download folder empty and Opera saves each file where it saves its own downloads.

npm ci && npm run lint
npm run build          # regression checks, then Chrome and Firefox zips
npm run test:visual    # Playwright tests

See CONTRIBUTING.md, docs/nexus-site-map.md and SECURITY.md.

The independent private diagnostics service and mobile dashboard live in workers/diagnostics/, with their own dependencies and tests. Deployment and extension-client integration are separate setup steps; the shipped extension continues to use the existing reporting relay and consent settings.