{"id":16776273,"url":"https://github.com/maxmilton/browser-redirect","last_synced_at":"2026-05-11T09:26:36.407Z","repository":{"id":156828113,"uuid":"633164648","full_name":"maxmilton/browser-redirect","owner":"maxmilton","description":"Browser extension to automatically redirect top level domains according to predefined rules.","archived":false,"fork":false,"pushed_at":"2025-03-01T23:49:53.000Z","size":503,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-14T22:44:57.155Z","etag":null,"topics":["brave","brave-extension","chrome","chrome-extension"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/maxmilton.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2023-04-26T23:25:13.000Z","updated_at":"2025-03-01T23:49:31.000Z","dependencies_parsed_at":"2023-11-05T14:32:06.981Z","dependency_job_id":"fc61144e-e76f-4881-a52f-53265ddbadb4","html_url":"https://github.com/maxmilton/browser-redirect","commit_stats":null,"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxmilton%2Fbrowser-redirect","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxmilton%2Fbrowser-redirect/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxmilton%2Fbrowser-redirect/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxmilton%2Fbrowser-redirect/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/maxmilton","download_url":"https://codeload.github.com/maxmilton/browser-redirect/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243910749,"owners_count":20367545,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["brave","brave-extension","chrome","chrome-extension"],"created_at":"2024-10-13T07:09:25.679Z","updated_at":"2026-05-11T09:26:36.401Z","avatar_url":"https://github.com/maxmilton.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![CI status](https://badgen.net/github/checks/maxmilton/browser-redirect?label=ci)](https://github.com/maxmilton/browser-redirect/actions)\n[![Licence](https://badgen.net/github/license/maxmilton/browser-redirect)](./LICENSE)\n\n# Browser Redirect ![](./static/icon48.png)\n\nBrowser Redirect is a browser extension that redirects top level domains according to predefined rules. It uses the [`declarativeNetRequest` API](https://developer.chrome.com/docs/extensions/reference/declarativeNetRequest/), which provides a faster and more secure way to handle redirects than other [alternatives](https://github.com/libredirect/browser_extension), as it cannot read the content of web pages.\n\nThe extension comes with a predefined set of static rules that are geared towards privacy friendly alternative frontends. You can customize it to meet your specific needs.\n\n## Default Redirect Rules\n\n\u003e See [rules.config.ts](./rules.config.ts).\n\nThe following table shows the default redirect rules included in the extension:\n\n| From                       | To                                      |\n| -------------------------- | --------------------------------------- |\n| `www.reddit.com`           | `redlib.privacyredirect.com`            |\n| `old.reddit.com`           | `redlib.privacyredirect.com`            |\n| `www.youtube.com`          | `piped.video`                           |\n| `www.youtube-nocookie.com` | `piped.video`                           |\n| `m.youtube.com`            | `piped.video`                           |\n| `youtu.be`                 | `piped.video/watch?v=`                  |\n| `x.com`                    | `nitter.privacyredirect.com`            |\n| `twitter.com`              | `nitter.privacyredirect.com`            |\n| `imgur.com`                | `rimgo.privacyredirect.com`             |\n| `i.imgur.com`              | `rimgo.privacyredirect.com`             |\n| `www.quora.com`            | `quetre.privacyredirect.com`            |\n| `www.imdb.com`             | `libremdb.privacyredirect.com`          |\n| `medium.com`               | `scribe.privacyredirect.com`            |\n| `*.medium.com`             | `scribe.privacyredirect.com/@*`         |\n| `wikipedia.org`            | `wikiless.privacyredirect.com`          |\n| `*.wikipedia.org`          | `wikiless.privacyredirect.com`          |\n| `stackoverflow.com`        | `anonymousoverflow.privacyredirect.com` |\n| `www.pinterest.com`        | `binternet.privacyredirect.com`         |\n| `i.pinimg.com`             | `binternet.privacyredirect.com`         |\n| `www.goodreads.com`        | `biblioreads.privacyredirect.com`       |\n| `translate.google.com`     | `translate.privacyredirect.com`         |\n| `www.twitch.tv`            | `safetwitch.privacyredirect.com`        |\n| `player.twitch.tv`         | `safetwitch.privacyredirect.com`        |\n\n## Usage\n\nFollow these steps to use Browser Redirect:\n\n1. Install the [Bun JavaScript runtime](https://bun.sh), if not already installed.\n1. Clone the project and edit the `rules.ts` file to add custom redirect rules.\n1. Build the project using `bun run build`.\n1. Load the extension into your browser:\n   1. Navigate to \u003cchrome://extensions/\u003e.\n   1. Toggle \"Developer mode\" to the \"on\" position.\n   1. Click \"Load unpacked\" and select the `dist` directory.\n1. To enable redirecting in private tabs, toggle \"Allow in Private\" to \"on\" in the extension's \"Details\" page.\n\n### Pre-built Package\n\nIf you are satisfied with the default rules, you can download `chrome-extension.zip` from the [latest release](https://github.com/maxmilton/browser-redirect/releases/latest). Then follow the instructions above starting from step 4, except instead of the `dist` directory, select the downloaded `zip` file.\n\n### Optional Linting\n\n1. Install the project dependencies: `bun install`\n1. Run linting: `bun run lint`\n\n### Debugging Rules\n\n1. Uncomment `declarativeNetRequestFeedback` permissions in manifest.\n1. Uncomment `background.service_worker` in manifest.\n1. Rebuild the project and reload the extension in your browser.\n1. Open devtools for the background page and observe the console for feedback.\n\n## Browser Support\n\nBrowser Redirect is compatible with version 84 and higher of Google Chrome and other Chromium-based browsers like Brave and Edge.\n\n## Bugs\n\nReport any bugs you encounter on the [GitHub issue tracker](https://github.com/maxmilton/browser-redirect/issues).\n\n### Known Issues\n\nWe are aware of the following issues:\n\n1. User's cannot dynamically add new rules. This is by design, as the extension uses a static rule set to simplify the implementation. You need to edit `rules.config.ts` and rebuild the project to make changes.\n1. The extension is not installable via the Chrome Web Store. Build the extension with your own custom rules using the steps outlined above.\n\n## Changelog\n\nSee [releases on GitHub](https://github.com/maxmilton/browser-redirect/releases).\n\n## License\n\nMIT license. See [LICENSE](./LICENSE).\n\nThe [right arrow curving left icon](https://github.com/twitter/twemoji/blob/master/assets/svg/21aa.svg) is from [twitter/twemoji](https://github.com/twitter/twemoji) which is licensed CC-BY 4.0.\n\n---\n\n© [Max Milton](https://maxmilton.com)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaxmilton%2Fbrowser-redirect","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaxmilton%2Fbrowser-redirect","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaxmilton%2Fbrowser-redirect/lists"}