Documentation

Get started with Altreurl

Altreurl is a Chromium MV3 extension for redirecting configured request URLs, forwarding selected headers, Authorization values, and cookies, and keeping local backend debugging close to the browser.

Quick start

  1. Install Altreurl from a browser store and open the options page.
  2. Create a rule with a source URL pattern and a redirect target URL.
  3. Select a credential mode (e.g., Storage, Cookies, Request Learning).
  4. Save the rule to activate it instantly. Use the popup menu on matching tabs to toggle it.

Rules & Engine

Altreurl converts your configuration into Chrome's native Declarative Net Request (DNR) rules for zero-latency redirects.

Exact & Wildcard

Use literal URLs for exact matches (automatically forwards query strings), or use * to mirror an entire path prefix to localhost. Regex is available for capture groups.

Tab Isolation

Normal and Incognito tabs are completely isolated. Rules are generated twice under the hood to ensure synced credentials never leak across contexts.

Credential Hydration

Credential handling is explicit per rule. Below are the 4 supported modes:

Mode How it works
Manual Provide fixed Authorization tokens or custom headers directly in the rule editor.
Request Learning Sniffs headers from live network requests. Requires a "double-refresh": the first request teaches Altreurl the headers, and subsequent requests will inject them. Features 401 Auto-Reset: if the target server returns 401, Altreurl automatically clears the saved credentials to force a re-sync.
Browser Storage Instantly injects scripts into an open tab matching the source origin to extract tokens from localStorage or sessionStorage. Redirects work immediately without double-refreshing.
Cookies Extracts cookies from the browser's native cookie store per tab context. Does not require an active tab to be open.

Swagger Generator

Altreurl can auto-generate redirect rules from a standard Swagger/OpenAPI v2/v3 JSON specification.

  • Specific Mode: Generates one precise regex rule for every single endpoint defined in the spec.
  • Simple Mode (Unique Path): Generates one wildcard rule for every unique path, automatically stripping dynamic path parameters.
  • Simple Mode (Tags): Groups multiple endpoints by their Swagger Tag (e.g., "Users"), finds their common URL prefix, and creates exactly one wildcard rule for the entire group.

Import, Export & Diagnostics

Altreurl prioritizes safe distribution and visibility into your configuration.

Smart Imports

Import JSON configs with 4 distinct conflict resolution modes: Draft, Skip, Disable, or Replace. You can review all duplicate conflicts before applying.

Privacy-Safe Export

When exporting rules to share with a team, you can choose to Redact or Remove credential values, preventing accidental token leaks.

Diagnostics & Logging

The built-in Diagnostics dialog displays live DNR rule counts and the last 100 internal application logs. Logs are automatically sanitized to ensure active Authorization tokens or Cookies are never recorded.