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.

View source Store copy

Quick start

  1. Install Altreurl from a browser store or load the packaged extension in Chromium developer mode.
  2. Open the options page and create a rule with a source URL pattern and redirect target URL.
  3. Choose wildcard for simple path forwarding or regex when you need capture groups.
  4. Select a credential mode, save the rule, then trigger a matching request from your web app.
  5. Use the popup on matching tabs to enable or disable contextual rules quickly.
Source:  https://api.example.com/users/*
Target:  http://localhost:3000/users/*
Mode:    Sync from source request

Rules

A rule describes what request should be matched, where it should be redirected, and which request data may be added or replaced. Rules can be enabled, disabled, grouped, searched, imported, exported, and inspected from diagnostics.

Wildcard patterns

Use * for straightforward path forwarding, such as mirroring one API path to localhost.

Regex patterns

Use regex when the target URL needs capture groups or stricter matching.

Credentials

Credential handling is explicit per rule. Use manual mode for fixed debug values, request learning for headers from source traffic, browser storage sync for app-owned storage, or cookie sync when the local backend needs a selected session cookie.

Mode Use when
Manual You already know the Authorization value or custom headers.
Request learning The source request should teach Altreurl which headers to reuse.
Browser storage Tokens live in localStorage or sessionStorage on the source origin.
Cookies A selected Chrome cookie should be forwarded to the target request.

Import and export

Exports can include all rules or a selected scope. Before sharing JSON, choose whether credentials should be included, redacted, or removed. Imports show a preview so you can review conflicts before writing changes.

Permissions

Altreurl uses Chromium extension APIs only for its debugging purpose: dynamic request rules, request header learning, cookie reading for selected sync rules, scripting for browser storage reads, tabs for contextual popup matching, and local extension storage.

Troubleshooting

  • If a rule is not ready, check the source pattern, target URL, enabled state, and credential mode.
  • If sync mode waits forever, trigger one matching source request before testing the redirect again.
  • If browser storage sync fails, keep a source-origin tab open and reload the options page.
  • If cookies are missing, confirm the cookie domain and browser profile match the source origin.
  • Use Diagnostics for dynamic rule counts, apply errors, and privacy-safe local logs.