https://github.com/maxmilton/browser-redirect
Browser extension to automatically redirect top level domains according to predefined rules.
https://github.com/maxmilton/browser-redirect
brave brave-extension chrome chrome-extension
Last synced: 9 months ago
JSON representation
Browser extension to automatically redirect top level domains according to predefined rules.
- Host: GitHub
- URL: https://github.com/maxmilton/browser-redirect
- Owner: maxmilton
- License: mit
- Created: 2023-04-26T23:25:13.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2025-03-01T23:49:53.000Z (10 months ago)
- Last Synced: 2025-03-14T22:44:57.155Z (9 months ago)
- Topics: brave, brave-extension, chrome, chrome-extension
- Language: TypeScript
- Homepage:
- Size: 491 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/maxmilton/browser-redirect/actions)
[](https://github.com/maxmilton/browser-redirect/blob/master/LICENSE)
# Browser Redirect 
Browser 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.
The 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.
## Default Redirect Rules
The following table shows the default redirect rules included in the extension:
| From | To |
| -------------------------- | ---------------------- |
| `www.reddit.com` | `libreddit.pufe.org` |
| `old.reddit.com` | `libreddit.pufe.org` |
| `www.youtube.com` | `piped.video` |
| `www.youtube-nocookie.com` | `piped.video` |
| `m.youtube.com` | `piped.video` |
| `youtu.be` | `piped.video/watch?v=` |
| `twitter.com` | `nitter.pufe.org` |
| `imgur.com` | `rimgo.bcow.xyz` |
| `www.quora.com` | `quetre.pufe.org` |
| `imdb.com` | `libremdb.iket.me` |
| `medium.com` | `scribe.rip` |
| `*.medium.com` | `scribe.rip/@*` |
| `wikipedia.org` | `wikiless.pufe.org` |
| `en.wikipedia.org` | `wikiless.pufe.org` |
| `stackoverflow.com` | `code.whatever.social` |
## Usage
Follow these steps to use Browser Redirect:
1. Install the [Bun JavaScript runtime](https://bun.sh), if not already installed.
1. Clone the project and edit the `rules.ts` file to add custom redirect rules.
1. Build the project using `bun run build`.
1. Load the extension into your browser:
1. Navigate to .
1. Toggle "Developer mode" to the "on" position.
1. Click "Load unpacked" and select the `dist` directory.
1. To enable redirecting in private tabs, toggle "Allow in Private" to "on" in the extension's "Details" page.
### Pre-built Package
If 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.
### Optional Linting
1. Install the project dependencies: `bun install`
1. Run linting: `bun run lint`
## Browser Support
Browser Redirect is compatible with version 84 and higher of Google Chrome and other Chromium-based browsers like Brave and Edge.
## Bugs
Report any bugs you encounter on the [GitHub issue tracker](https://github.com/maxmilton/browser-redirect/issues).
### Known Issues
We are aware of the following issues:
1. 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.ts` and rebuild the project to make changes.
1. The extension is not installable via the Chrome Web Store. Build the extension with your own custom rules using the steps outlined above.
## Changelog
See [releases on GitHub](https://github.com/maxmilton/browser-redirect/releases).
## License
MIT license. See [LICENSE](https://github.com/maxmilton/browser-redirect/blob/master/LICENSE).
The [right arrow icon](https://github.com/twitter/twemoji/blob/master/assets/svg/27a1.svg) is from [twitter/twemoji](https://github.com/twitter/twemoji) which is licensed CC-BY 4.0.
---
© 2024 [Max Milton](https://maxmilton.com)