![An permission requiring alert]({require("/img/prepareExtensionPermissionAlert@3x.png").default})
8 |
9 | > This extension will be able to read and alter webpages and see your browsing history on this website. **This could include sensitive information, including passwords, phone numbers, and credit cards.**
10 |
11 | This extension needs your permission to observe the page navigation to redirect to wherever you want to jump, and Safari displays this alert when the extension requests the related permissions. Therefore, if you don’t allow it, this extension can't work.
12 |
13 | Since we don't collect your personal information as per **[the privacy policy](./privacy-policy)**, we recommend you **always allow** it on **every website** for your convenience.
14 |
15 | But it’s not required. You can only allow it on specific websites. 👌
16 |
17 | ## Why does this extension require a new permission? \{#permission-alert-on-safari}
18 |
19 | You may see this alert in Safari after updating Redirect Web:
20 |
21 | ![An alert of disabling the app]({require("/img/safari-additional-permission-alert.webp").default})
22 |
23 | > "Redirect Web for Safari" has been updated and is requesting additional permissions. To protect your privacy, this extension has been turned off.
24 | >
25 | > You can turn this extension on in the Extensions section of Safari Settings.
26 |
27 | This is due to the [declarativeNetRequestWithHostAccess](https://developer.apple.com/documentation/safariservices/safari_web_extensions/blocking_content_with_your_safari_web_extension) permission required by the [DNR](./rule-settings#type) type introduced in version 7. Please re-enable the extension. Sorry for the inconvenience.
28 |
29 | ## Will the library's contents become paid in the future?
30 |
31 | No, it's always free. You can also find the source of all the contents [here](https://github.com/mshibanami/redirect-web/tree/main/library).
32 |
33 | ## One-time Purchase or Annual Subscription: Which is Best?
34 |
35 | We recommend the one-time purchase, as the price difference is only US$2.00.
36 | The main reason we offer the subscription is to allow you to try all the features through its free trial. Here is the expected use case:
37 |
38 | 1. Subscribe the annual subscription.
39 | 2. Immediately cancel the subscription by going to the Settings app, searching for "Subscriptions", tapping on this app, and selecting "Cancel Subscription". This lets you enjoy the free trial without any commitment.
40 | 3. Enjoy full access to all features for 7 days.
41 | 4. If you like the features, opt for the one-time purchase.
42 |
43 | Of course, there's nothing wrong with continuing with the annual subscription if you prefer!
44 |
45 | ## Why are the toggles of my redirect rules not changing or immediately reverting back?
46 |
47 | **Edit (2023-09-01)**: We fixed this bug in version 5.0.0 for both iOS and macOS.
48 |
49 | ~~It's a bug. Sorry for the inconvenience. As a workaround, try changing the sorting order of one of your redirect rules and then restoring it to the previous order.~~
50 |
51 | ## Does Redirect Web inject ads or other unrelated content into websites?
52 |
53 | No, it does not inject any such content. Only code that is necessary to provide the features described in this documentation and on the app page in the App Store is injected into websites on Safari.
54 |
55 | ## Is there any chance Redirect Web could ever be sold to someone else?
56 |
57 | 100% no. Browser extensions wield deep control over your browsing and data, and handing Redirect Web over to another owner would open the door to privacy violations. We’ve seen extensions change hands and then harvest user data or inject ads without warning—that will never happen here. For more on these risks, see Matt Frisbie’s article ["The Ugly Business of Monetizing Browser"](https://mattfrisbie.substack.com/p/the-ugly-business-of-monetizing-browser) and Brian Krebs’ investigation ["Is Your Browser Extension a Botnet Backdoor?"](https://krebsonsecurity.com/2021/03/is-your-browser-extension-a-botnet-backdoor/).
58 |
59 | Redirect Web was built on trust and responsibility. We consider it our duty to keep your information safe, and we refuse to transfer ownership under any circumstances. Redirect Web will always remain in our hands, so you can browse with complete confidence.
60 |
--------------------------------------------------------------------------------
/docs/getting-started.mdx:
--------------------------------------------------------------------------------
1 | # Getting Started
2 |
3 | This page describes common use cases for creating redirect rules in the Redirect Web app.
4 |
5 | (You can also learn the details of rule settings on the [Rule Settings](./rule-settings) page.)
6 |
7 |
8 | ## Case 1: Open another website
9 |
10 | Suppose you're addicted to Twitter, and you decide to meditate in Insight Timer whenever you accidentally open Twitter. Let's create a rule for that!
11 |
12 | ### Step 1. Set up "Redirect From"
13 |
14 | First, you should set up the *Redirect From* section in the *Edit Rule* screen in the app. The targets are URLs starting with `https://twitter.com/`.
15 |
16 | In this case, you can specify the following pattern with the [Wildcard](rule-settings?id=wildcard) mode:
17 |
18 | ```
19 | https://twitter.com/*
20 | ```
21 |
22 | In the Wildcard mode, `*` means it matches anything (= zero or more characters).
23 |
24 | However, hold on. `twitter.com` was renamed to `x.com`. You can simply replace `twitter.com` with `x.com` but no one knows when the new owner will change his mind again to roll it back. Therefore, let's target both `twitter.com` and `x.com`.
25 |
26 | To do that, switch from Wildcard to [Regular Expression](rule-settings?id=regular-expression), and set this as the pattern:
27 |
28 | ```
29 | https://(twitter|x).com/.*
30 | ```
31 |
32 | * `(twitter|x)`: it targets both `twitter` and `x`. (`|` is called *a pipe*.)
33 | * `.*`: It's the same as Wildcard's `*`. More specifically, `.` means *any character* and `*` means *anything before this symbol repeated any number of times*, resulting in it matches anything.
34 |
35 | Regular Expression is a bit complicated, but once you get used to it, it will be a powerful tool. We recommend using [RegExr](https://regexr.com) as a playground to analyze how your Regular Expression pattern works.
36 |
37 | > [!NOTE]
38 | > In Regular Expressions, `.` in `(twitter|x).com` is also treated as *any character*. Therefore, `(twitter|x).com/.*` also matches, for example, `twitter1com/` or `x_com/`.
39 | >
40 | > To avoid it, you can change it to `(twitter|x)\.com/.*`. `\` is used to escape a special character.
41 | >
42 | > However, there are no such URLs in the general internet environment. Therefore, you can leave `.` as a special character if you prefer. Your rule is for your own use, so implement it as you see fit.
43 |
44 | ### Step 2: Set up "Redirect To"
45 |
46 | Simply specify the URL as follows:
47 |
48 | ```
49 | https://insighttimer.com/saraauster/guided-meditations/calm
50 | ```
51 |
52 | Now, Redirect Web brings you to the meditation when you access Twitter!
53 |
54 | **[⬇️ Download the Rule](/rules/reduce-twitter-addiction.redirectweb)**
55 |
56 | ## Case 2: Remove Query Parameters from URL
57 |
58 | Suppose there is a query parameter `source=twitter` in a URL of `example.com`, and you decided to remove it to anonymize yourself.
59 |
60 | In this case, the **Capturing Group Processing** option is the easiest way.:
61 |
62 | * **Redirect From**: `https://example.com/*` (Wildcard)
63 | * **Redirect To**: `$0`
64 | * **Capturing Group Processing**:
65 | * **Group**: `$0`
66 | * **Process**: Replace Occurrences
67 | * **Target**: `&?source=[^&]*`
68 | * **Replacement**: *(none)*
69 | * **Text Pattern**: Regular Expression
70 |
71 | **[⬇️ Download the Rule](/rules/remove-parameters.redirectweb)**
72 |
73 | This rule works as follows:
74 |
75 | ```
76 | https://example.com/?source=twitter
77 | ↪ https://example.com/?
78 |
79 | https://example.com/?hello=world&source=twitter&foo=bar
80 | ↪ https://example.com/?hello=world&foo=bar
81 | ```
82 |
83 | If you want to remove more parameters, add more processes.
84 |
85 | ## Case 3: Add Query Parameters to URL
86 |
87 | Let's say there is a website called `example.com` that shows a mobile layout by default, but you prefer their desktop layout. Fortunately, the website supports a `layout` query parameter to specify which layout the website displays. Let's create a rule that adds `layout=desktop` automatically.
88 |
89 | Perhaps you think you could define it as follows:
90 |
91 | * **Redirect From**: `https://example.com/.*` (Regular Expression)
92 | * **Redirect To**: `$0?layout=desktop`
93 |
94 | `$0` references the target URL. If you try to access `example.com/hello`, you're redirected to `example.com/hello?layout=desktop`. This feature is called *substitution*.
95 |
96 | > [!TIP]
97 | > Substitution is also available for the Wildcard mode since it's internally converted to Regular Expression.
98 |
99 | However, there are a few problems with these settings.
100 |
101 | ### Problem 1: Infinite loop
102 |
103 | The current setting creates an infinite redirect loop since `https://example.com/.*` also targets `https://example.com/hello?layout=desktop`.
104 |
105 | In this case, you can specify an excluded URL pattern that allows you to access without redirection, like this with Regular Expression:
106 |
107 | ```
108 | .*[&?]layout=[^&]*.*
109 | ```
110 |
111 | * `.*`: Matches anything
112 | * `[&?]`: Matches either `&` or `?`
113 | * `[^&]*`: Matches anything except `&`
114 |
115 | ### Problem 2: Can't handle existing parameters properly
116 |
117 | If the target URL already has other query parameters like `example.com/hello?theme=dark`, the destination will be `example.com/hello?theme=dark?layout=desktop` (There are two `?` in the URL) but you can only join the parameters with `&`. `?` as a special character is only allowed at the beginning of the parameters. So it's not treated as a valid parameter.
118 |
119 | In this case, change the settings like this:
120 |
121 | * **Redirect From**: `(https://example.com/[^?]*)(\?(.*))?`
122 | * **Redirect To**: `$1?layout=desktop&$3`
123 |
124 | Let's take a look step by step.
125 |
126 | * `(https://example.com/[^?]*)`: Matches the part until the previous character of `?`.
127 | * `[^?]*` matches anything except `?`.
128 | * This is wrapped with `()` so you can reference it with `$1` later.
129 | * `(\?(.*))?`: Matches a string start with `?`, which means query parameters.
130 | * This also matches empty string by the `?` quantifier at the end of the pattern, which *matches zero or one time*.
131 | * The outer `()` and the inner `()` can be referenced with `$2` and `$3` later.
132 |
133 | [RegExr](https://regexr.com) may help you understand the details.
134 |
135 | > [!NOTE]
136 | > RegExr shows an error when you don't escape `/` with `\`. Although you can escape it, it's not required since Redirect Web uses a different engine by Apple that doesn't require escaping.
137 |
138 | This is not a perfect solution, as it redirects `example.com/hello` to `example.com/hello?layout=desktop&`, which includes an unnecessary `&` at the end of the URL. It's not a big deal in general, but if you wish to remove it, you can use *Capturing Group Processing*.
139 |
140 | In conclusion, this is the final output:
141 |
142 | * **Redirect From**: `(https://example.com/[^?]*)((\?(.*))?)` (Regular Expression)
143 | * **Redirect To**: `$1?layout=desktop$3`
144 | * **Excluded URL Pattern**: `.*[&?]layout=[^&]*.*` (Regular Expression)
145 | * **Capturing Group Processing**:
146 | * **Group**: `$3`
147 | * **Process**: Replace Occurrences
148 | * **Target**: `\?(.*)`
149 | * **Replacement**: `&$1`
150 |
151 | **[⬇️ Download the Rule](/rules/add-parameters.redirectweb)**
152 |
153 | This is merely an example. You can also create multiple rules to handle each problem. It can be much simpler.
154 |
--------------------------------------------------------------------------------
/docs/introduction.mdx:
--------------------------------------------------------------------------------
1 | ---
2 | slug: /
3 | ---
4 |
5 | # Introduction
6 |
7 | [](https://apps.apple.com/au/app/id1571283503)
8 |
9 | Welcome to the support website for Redirect Web, a Safari extension for iOS and macOS.
10 |
11 | This extension lets you set up redirect rules to jump to a specific website from another website. With Redirect Web, you can save time by automatically redirecting to your preferred websites, without the need to manually type the URLs or navigate through multiple pages.
12 |
13 | These are the basic usages of the iOS app and the macOS app:
14 |
15 |
16 |
17 |
18 |
19 | ## Use Cases
20 |
21 | For example, you can create these rules:
22 |
23 | - Remove unneeded parameters from a URL
24 | - Open a Google Meet link on Google Chrome
25 | - Open a Notion's link on the Notion app
26 |
27 | You can find useful rules in these:
28 |
29 | - [Library](library): This offers you many useful pre-defined rules you can easily get by tapping a Get button.
30 | - [GitHub Discussions](https://github.com/mshibanami/redirect-web/discussions/categories/redirect-rules): A community forum where the users can share their rules with others.
31 |
32 | ## Features
33 |
34 | Redirect Web comes with the following features:
35 |
36 | - Create redirect rules using Regular Expression or Wildcard pattern types
37 | - Use back-referencing to specify dynamic target URLs
38 | - Exclude URLs from redirection
39 | - Process captured text using URL encoding/decoding, base64 encoding/decoding, or replacing occurrences
40 |
41 | In addition, you can unlock the following features through either a subscription or a one-time purchase:
42 |
43 | - Enabling 2 or more redirect rules
44 | - Syncing redirect rules with your other Mac, iPhone, and iPad via iCloud
45 |
46 | Purchasing the app also supports us in maintaining Redirect Web. 😃
47 |
48 | Your purchase made on your iOS device can be used on your Mac and vice versa.
49 |
50 | ---
51 |
52 | We hope you find Redirect Web helpful in saving you time and simplifying your browsing experience.
53 |
54 | If you have any questions, feedback, or issues, please don't hesitate to [contact us](contact-us).
55 |
--------------------------------------------------------------------------------
/docs/library.mdx:
--------------------------------------------------------------------------------
1 | # Library
2 |
3 | 
4 |
5 | Welcome to our library, where you can get redirect rules for free!
6 |
7 | The library can be accessed through the Redirect Web app, as long as it's version 6.0.0 or higher.
8 |
9 | ## Add Rules to Library
10 |
11 | The current library has only a few rules, so we appreciate your contribution!
12 |
13 | There are 2 options to add your rules to the library:
14 |
15 | ### Option 1: Send a Pull Request
16 |
17 | You can send a pull request to the repository. To do that, you need to know which files to add to the repository. Please check [the instructions](https://github.com/mshibanami/redirect-web/blob/main/library/README.md) for details.
18 |
19 | ### Option 2: Post a Rule on the Forum
20 |
21 | Share your redirect rule with other users on [the forum](https://github.com/mshibanami/redirect-web/discussions/categories/redirect-rules). Then we may request if we could put your rule in the library as well.
22 |
23 | This might be easier than sending a pull request since you can leave it to us to add.
24 |
25 | ## Other Information
26 |
27 | - You can see all the contents in [the repository on GitHub](https://github.com/mshibanami/redirect-web/tree/main/library).
28 | - We host our private API server on Cloudflare for the library contents, enabling ust to provide filtering and other services. The app fetches the library contents from this server. As stated in our [our privacy policy](/privacy-policy), This server does not collect your personal information.
29 |
--------------------------------------------------------------------------------
/docs/privacy-policy.mdx:
--------------------------------------------------------------------------------
1 | # Privacy Policy
2 |
3 | **Redirect Web for Safari** does not collect your personal information.
4 |
5 | **Personal information** is information or an opinion about an identified individual or an individual who is reasonably identifiable.
6 |
7 | **Redirect Web for Safari** stores your redirect settings in your computer. Also, it may store your redirect settings in your private database on Apple's iCloud. It's only for the data sync feature.
8 |
--------------------------------------------------------------------------------
/docs/rule-settings.mdx:
--------------------------------------------------------------------------------
1 | # Rule Settings
2 |
3 | This page provides detailed information on how to set up redirect rules using Redirect Web.
4 |
5 | ## Options
6 |
7 | ### Type
8 |
9 | Specify the **Type** option to control how the app handles redirection. You can choose from these:
10 |
11 | * **Original** (Default)
12 | * This uses traditional Web APIs to control redirection. Additionally, it uses [the Tabs API](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/tabs) for a fallback.
13 | * You can use all the options other than [Resource Types](#resource-types) and [Request Methods](#request-methods).
14 | * This is slower than the *Declarative* type and may cause extra network requests.
15 | * **DNR** (Experimental):
16 | * This allows you to specify [Resource Types](#resource-types) ~~and [Request Methods](#request-methods)~~.
17 | * This type works much faster than the Original type because it doesn't initiate a network request for the source URL.
18 | * ⚠️ If you update Redirect Web to version 7 or later, you may see an alert in Safari that disables the extension due to a new permission request for this type. [Details](/faq#permission-alert-on-safari)
19 | * ⚠️ You can't use some options, such as [Capturing Group Processing](#capturing-group-processing) and [Excluded URL Patterns](#excluded-url-patterns).
20 | * ⚠️ Currently, you can't include pipes (`|`) in your Regular Expression pattern. [Details](https://github.com/mshibanami/redirect-web/issues/44)
21 | * ⚠️ Since the DNR API still has some issues, we consider that is still an experimental feature. You can find the list of all the known issues [here](https://github.com/mshibanami/redirect-web/labels/DNR).
22 |
23 | ### Redirect From
24 |
25 | The **Redirect From** option allows you to specify a URL pattern of web pages you want to redirect from. You can choose either Wildcard or Regular Expression.
26 |
27 | For example, if you specify `https://example.com/*` with Wildcard, it matches `https://example.com/` or `https://example.com/hello`.
28 |
29 | > [!NOTE]
30 | > In the Redirect To option, You can reference the entire match using `$0` or partial matches using `$1`, `$2`, ... Check the details in [URL Pattern](#url-pattern) on this page.
31 |
32 | #### Resource Types
33 |
34 | 
35 |
36 | The **Resource Types** option lets you specify the categories of web requests, such as images, JavaScripts, and style sheets, to which the rule applies.
37 | For example, if you set `script`, you can redirect the JavaScript files loaded by web pages.
38 |
39 | Currently, these are available:
40 | `main_frame`, `sub_frame`, `stylesheet`, `script`, `image`, `font`, `xmlhttprequest`, `ping`, `media`, `websocket`, `other`
41 |
42 | The default setting is `main_frame`, which is the top-level page loaded into a tab.
43 |
44 | Please check the details of each resource type in [mdn web docs](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/declarativeNetRequest/ResourceType).
45 |
46 | #### Request Methods
47 |
48 | 
49 |
50 | ~~The **Request Methods** option lets you set the target HTTP methods of the source URL.~~
51 |
52 | ~~All methods are set by default.~~
53 |
54 | ~~Please check the details of each method in [mdn web docs](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods).~~
55 |
56 | > [!WARNING]
57 | > This option is currently not available because Apple's implementation for the DNR type doesn't seem to handle it currently. We sent feedback to Apple as FB14502272.
58 |
59 | ### Redirect To
60 |
61 | The **Redirect To** option specifies a destination URL you wish to redirect to, from the source URL matched with the *Redirect From* option. You can also substitute capturing groups with `$1`, `$2`, ... or the entire match with `$0`. These help you dynamically specify the destination. Check the details in [URL Pattern](#url-pattern) in this page.
62 |
63 | For example, if you set the following rule:
64 |
65 | * **Redirect From**: `https://google.com/*` (Wildcard)
66 | * **Redirect To**: `https://apple.com/$1`
67 |
68 | and it matches `https://google.com/hello`, then the destination URL will be `https://apple.com/hello`.
69 |
70 | Additionally, You can modify the texts of `$1`, `$2`, ... before making substitutions. Check the [Capturing Group Processing](#capturing-group-processing) section for the details.
71 |
72 | > [!TIP]
73 | > You can specify a custom URL scheme to open an app. These are examples of apps that support deep linking:
74 | >
75 | > * Figma: `figma://file/Your_Figma_ID`
76 | > * Firefox: `firefox://open-url?url=https://example.com/hello`
77 | > * Google Chrome: `googlechromes://example.com`
78 | > * Microsoft Edge: `microsoft-edge://example.com`
79 | > * Notion: `notion://www.notion.so/Your_Note_ID`
80 | > * Slack: `slack://open`
81 |
82 | #### Application
83 |
84 |  
85 |
86 | If you want to specify an app you wish to open the destination URL, use the **Application** combo box. This is only available on macOS.
87 |
88 | > [!WARNING]
89 | > You can only open an app that supports [App Sandbox](https://developer.apple.com/documentation/security/app_sandbox). Also, make sure that the app supports opening the URL you want to open.
90 |
91 | ### Capturing Group Processing
92 |
93 | 
94 |
95 | The **Capturing Group Processing** option allows you to specify how to process the captured groups you can substitute in the *Redirect To* option with `$1`, `$2`...
96 |
97 | These are how to make capturing groups:
98 |
99 | * **Wildcard**: Texts matched with `*` and `?` are automatically captured.
100 | * **Regular Expression**: Texts matched with part of the pattern inside `()` are captured.
101 |
102 | You can choose one or more of the following processes:
103 |
104 | * **URL Encode/Decode**: This applies [percent-encoding](https://en.wikipedia.org/wiki/Percent-encoding) or decoding to a capturing group. For example, if you encode `https://example.com/hello`, it's converted to `https%3A%2F%2Fexample.com%2Fhello`. Decode works in an opposite way.
105 | * **Base64 Encode/Decode**: This decode/encode a text into [Base64](https://en.wikipedia.org/wiki/Base64). For example, you can encode `hello` to `aGVsbG8=`, and decode it back to `hello`.
106 | * **Replace Occurrences**: This replaces one or more characters in a group, matched by a **Target**, with a **Replacement**. For example, if the *Group* is `hello` and the *Target* is `l` and the Replacement is `y`, it is modified to `heyyo`.
107 |
108 | > [!NOTE]
109 | > This is for processing each capturing group and it doesn't affect which URLs are excluded by the [Excluded URL Patterns](#excluded-url-patterns). For instance, let's say you have this rule:
110 | >
111 | > * **Redirect From**: `https://example.com/(hello.*)`
112 | > * **Capturing Group Processing**:
113 | > * Group: `$1`
114 | > * Target: `.*` (Regular Expression)
115 | > * Replacement: `hello`
116 | > * **Excluded URL Pattern**: `https://example.com/hello`
117 | >
118 | > In this case, `https://example.com/hello_world` will not be excluded while `https://example.com/hello` will be excluded.
119 |
120 | ### Excluded URL Patterns
121 |
122 | 
123 |
124 | The **Excluded URL Patterns** option allows you to specify the URLs that are not redirected. This can be useful to avoid redirect loops or to exclude certain parts of a website from being redirected.
125 |
126 | You can specify excluded URL patterns using either Regular Expression or Wildcard pattern types.
127 |
128 | ### Examples
129 |
130 | The **Examples** option allows you to test your redirect rule by providing sample URLs. By adding a sample URL, you can check if the rule works as expected before actually applying it.
131 |
132 | ### Comments
133 |
134 | The **Comments** option allows you to add any notes or comments about your redirect rule. This can be useful for keeping track of why you created a specific rule or for providing context for others who might view your rules.
135 |
136 | ## URL Pattern
137 |
138 | There are 3 options you can specify one or more URL patterns. *Redirect From*, *Excluded URL Patterns* and *Capturing Group Processing*. To specify them, you can choose either **Wildcard** or **Regular Expression**.
139 |
140 | ### Wildcard
141 |
142 | **Wildcard** is a simpler pattern type that allows you to use `*` (matches anything) and `?` (matches any single character) as wildcards. Here are some examples:
143 |
144 | * To match `https://example.com/hello`, you can use `https://example.com/*`. This will match any string after `https://example.com/`.
145 | * To match `https://example.com/search?q=hello`, you can use `https://example.com/search?q=*`. This will match any value for the `q` parameter.
146 | * To match any URL that contains the word `blog`, you can use `*blog*`.
147 |
148 | You can also use substitution in Wildcard as well, which means you can reference portions of the matched URL using `$1`, `$2`, etc. For example, if you use `https://example.com/*-world-*`, and the URL is `https://example.com/hello-world-goodbye`, then `$1` would be "hello" and `$2` would be "goodbye". `$0` is also available to reference the entire URL matched.
149 |
150 | > [!Note]
151 | > Although substitution is a feature of Regular Expression, you can also use it for Wildcard because Redirect Web internally converts Wildcard to Regular Expression.
152 |
153 | ### Regular Expression
154 |
155 | **Regular Expression** (Regex) is a powerful tool for matching patterns in text, powered by Apple's regular expression engine which is described [here](https://developer.apple.com/documentation/foundation/nsregularexpression#1661042). It allows you to define a specific pattern that matches a set of strings. Here are some examples.
156 |
157 | - To match `https://example.com/hello`, you can use `https://example.com/(.*)`. This will match any string after `https://example.com/` and store it in a capturing group.
158 | - To match `https://example.com/search?q=hello`, you can use `https://example.com/search\?q=(.*)`. This will match the value of the `q` parameter and store it in a capturing group.
159 | - To match any URL that contains the word `blog`, you can use `.*blog.*`.
160 |
161 | You can reference the capturing groups in *Redirect To* or *Replacement* using `$1`, `$2`, ... or `$0` to reference the entire match.
162 |
163 | You can learn more about Regex syntax in resources like [RegExr](https://regexr.com/).
164 |
--------------------------------------------------------------------------------
/docs/terms-of-use.mdx:
--------------------------------------------------------------------------------
1 | # Terms of Use
2 |
3 | Effective Date: September, 2021.
4 |
5 | ## Introduction and Overview
6 |
7 | These Terms of Use ("Terms") set forth a legally binding agreement between you and Manabu Nakazawa (Founder and Developer of **Redirect Web for Safari**)), and govern your use of any online service location that posts a link to these Terms, and all features, content, and other services that we own, control and make available through such online service location (collectively, the "Service").
8 |
9 | In some instances, both these Terms and separate terms elsewhere on the Service will apply to your use of the Service ("Additional Terms"). To the extent there is a conflict between these Terms and any applicable Additional Terms, the Additional Terms will control unless they expressly state otherwise.
10 |
11 | By using the Service, you agree to these Terms, and consent to our collection, use and disclosure practices, and other activities as described in our Privacy Policy. If you do not agree and consent, discontinue use of the Service.
12 |
13 | ## Changes to these Terms
14 |
15 | We reserve the right to modify these Terms at any time. For instance, we may need to change these Terms if we come out with a new feature or for some other reason.
16 |
17 | Whenever we make changes to these Terms, the changes are effective 7 days after we post such revised Terms (indicated by revising the date at the top of these Terms) or upon your acceptance if we provide a mechanism for your immediate acceptance of the revised Terms (such as a click-through confirmation or acceptance button). It is your responsibility to check **Redirect Web for Safari** for changes to these Terms.
18 |
19 | If you continue to use the Service after the revised Terms go into effect, then you have accepted the changes to these Terms.
20 |
21 | ## Third-Party Services
22 |
23 | From time to time, we may provide you with links to third party websites or services that we do not own or control. Your use of the Service may also include the use of applications that are developed or owned by a third party. Your use of such third party applications, websites, and services is governed by that party's own terms of service or privacy policies. We encourage you to read the terms and conditions and privacy policy of any third party application, website or service that you visit or use.
24 |
25 | ## Creating Accounts
26 |
27 | When you create an account or use another service to log in to the Service, you agree to maintain the security of your password and accept all risks of unauthorized access to any data or other information you provide to the Service.
28 |
29 | If you discover or suspect any Service security breaches, please let us know as soon as possible.
30 |
31 | ## Your Content & Conduct
32 |
33 | Our Service allows you and other users to post, link and otherwise make available content. You are responsible for the content that you make available to the Service, including its legality, reliability, and appropriateness.
34 |
35 | When you post, link or otherwise make available content to the Service, you grant us the right and license to use, reproduce, modify, publicly perform, publicly display and distribute your content on or through the Service. We may format your content for display throughout the Service, but we will not edit or revise the substance of your content itself.
36 |
37 | Aside from our limited right to your content, you retain all of your rights to the content you post, link and otherwise make available on or through the Service.
38 |
39 | You can remove the content that you posted by deleting it. Once you delete your content, it will not appear on the Service, but copies of your deleted content may remain in our system or backups for some period of time. We will retain web server access logs for a maximum of 180 days and then delete them.
40 |
41 | You may not post, link and otherwise make available on or through the Service any of the following:
42 |
43 | * Content that is libelous, defamatory, bigoted, fraudulent or deceptive;
44 | * Content that is illegal or unlawful, that would otherwise create liability;
45 | * Content that may infringe or violate any patent, trademark, trade secret, copyright, right of privacy, right of publicity or other intellectual or other right of any party;
46 | * Mass or repeated promotions, political campaigning or commercial messages directed at users who do not follow you (SPAM);
47 | * Private information of any third party (e.g., addresses, phone numbers, email addresses, Social Security numbers and credit card numbers); and
48 | * Viruses, corrupted data or other harmful, disruptive or destructive files or code.
49 |
50 | Also, you agree that you will not do any of the following in connection with the Service or other users:
51 |
52 | * Use the Service in any manner that could interfere with, disrupt, negatively affect or inhibit other users from fully enjoying the Service or that could damage, disable, overburden or impair the functioning of the Service;
53 | * Impersonate or post on behalf of any person or entity or otherwise misrepresent your affiliation with a person or entity;
54 | * Collect any personal information about other users, or intimidate, threaten, stalk or otherwise harass other users of the Service;
55 | * Create an account or post any content if you are not over 13 years of age years of age; and
56 | * Circumvent or attempt to circumvent any filtering, security measures, rate limits or other features designed to protect the Service, users of the Service, or third parties.
57 |
58 | ## Manabu Nakazawa Materials
59 |
60 | We put a lot of effort into creating the Service including, the logo and all designs, text, graphics, pictures, information and other content (excluding your content). This property is owned by us or our licensors and it is protected by Australia and international copyright laws. We grant you the right to use it.
61 |
62 | However, unless we expressly state otherwise, your rights do not include: (i) publicly performing or publicly displaying the Service; (ii) modifying or otherwise making any derivative uses of the Service or any portion thereof; (iii) using any data mining, robots or similar data gathering or extraction methods; (iv) downloading (other than page caching) of any portion of the Service or any information contained therein; (v) reverse engineering or accessing the Service in order to build a competitive product or service; or (vi) using the Service other than for its intended purposes. If you do any of this stuff, we may terminate your use of the Service.
63 |
64 | ## Hyperlinks and Third Party Content
65 |
66 | You may create a hyperlink to the Service. But, you may not use, frame or utilize framing techniques to enclose any of our trademarks, logos or other proprietary information without our express written consent.
67 |
68 | Manabu Nakazawa makes no claim or representation regarding, and accepts no responsibility for third party websites accessible by hyperlink from the Service or websites linking to the Service. When you leave the Service, you should be aware that these Terms and our policies no longer govern.
69 |
70 | If there is any content on the Service from you and others, we don't review, verify or authenticate it, and it may include inaccuracies or false information. We make no representations, warranties, or guarantees relating to the quality, suitability, truth, accuracy or completeness of any content contained in the Service. You acknowledge sole responsibility for and assume all risk arising from your use of or reliance on any content.
71 |
72 | ## Unavoidable Legal Stuff
73 |
74 | THE SERVICE AND ANY OTHER SERVICE AND CONTENT INCLUDED ON OR OTHERWISE MADE AVAILABLE TO YOU THROUGH THE SERVICE ARE PROVIDED TO YOU ON AN AS IS OR AS AVAILABLE BASIS WITHOUT ANY REPRESENTATIONS OR WARRANTIES OF ANY KIND. WE DISCLAIM ANY AND ALL WARRANTIES AND REPRESENTATIONS (EXPRESS OR IMPLIED, ORAL OR WRITTEN) WITH RESPECT TO THE SERVICE AND CONTENT INCLUDED ON OR OTHERWISE MADE AVAILABLE TO YOU THROUGH THE SERVICE WHETHER ALLEGED TO ARISE BY OPERATION OF LAW, BY REASON OF CUSTOM OR USAGE IN THE TRADE, BY COURSE OF DEALING OR OTHERWISE.
75 |
76 | IN NO EVENT WILL MANABU NAKAZAWA BE LIABLE TO YOU OR ANY THIRD PARTY FOR ANY SPECIAL, INDIRECT, INCIDENTAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES OF ANY KIND ARISING OUT OF OR IN CONNECTION WITH THE SERVICE OR ANY OTHER SERVICE AND/OR CONTENT INCLUDED ON OR OTHERWISE MADE AVAILABLE TO YOU THROUGH THE SERVICE, REGARDLESS OF THE FORM OF ACTION, WHETHER IN CONTRACT, TORT, STRICT LIABILITY OR OTHERWISE, EVEN IF WE HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES OR ARE AWARE OF THE POSSIBILITY OF SUCH DAMAGES. OUR TOTAL LIABILITY FOR ALL CAUSES OF ACTION AND UNDER ALL THEORIES OF LIABILITY WILL BE LIMITED TO THE AMOUNT YOU PAID TO MANABU NAKAZAWA. THIS SECTION WILL BE GIVEN FULL EFFECT EVEN IF ANY REMEDY SPECIFIED IN THIS AGREEMENT IS DEEMED TO HAVE FAILED OF ITS ESSENTIAL PURPOSE.
77 |
78 | You agree to defend, indemnify and hold us harmless from and against any and all costs, damages, liabilities, and expenses (including attorneys' fees, costs, penalties, interest and disbursements) we incur in relation to, arising from, or for the purpose of avoiding, any claim or demand from a third party relating to your use of the Service or the use of the Service by any person using your account, including any claim that your use of the Service violates any applicable law or regulation, or the rights of any third party, and/or your violation of these Terms.
79 |
80 | ## Copyright Complaints
81 |
82 | We take intellectual property rights seriously. In accordance with the Copyright Act 1968 and other applicable law, we have adopted a policy of terminating, in appropriate circumstances and, at our sole discretion, access to the service for users who are deemed to be repeat infringers.
83 |
84 | ## Governing Law
85 |
86 | The validity of these Terms and the rights, obligations, and relations of the parties under these Terms will be construed and determined under and in accordance with the laws of the State of New South Wales, without regard to conflicts of law principles.
87 |
88 | ## Jurisdiction
89 |
90 | You expressly agree that exclusive jurisdiction for any dispute with the Service or relating to your use of it, resides in the courts of the the State of New South Wales and you further agree and expressly consent to the exercise of personal jurisdiction in the courts of the the State of New South Wales located in Sydney in connection with any such dispute including any claim involving Service. You further agree that you and Service will not commence against the other a class action, class arbitration or other representative action or proceeding.
91 |
92 | ## Termination
93 |
94 | If you breach any of these Terms, we have the right to suspend or disable your access to or use of the Service.
95 |
96 | ## Entire Agreement
97 |
98 | These Terms constitute the entire agreement between you and Manabu Nakazawa regarding the use of the Service, superseding any prior agreements between you and Manabu Nakazawa relating to your use of the Service.
99 |
100 | ## Feedback
101 |
102 | Please let us know what you think of the Service, these Terms and, in general, **Redirect Web for Safari**. When you provide us with any feedback, comments or suggestions about the Service, these Terms and, in general, **Redirect Web for Safari**, you irrevocably assign to us all of your right, title and interest in and to your feedback, comments and suggestions.
103 |
104 | ## Questions & Contact Information
105 |
106 | Questions or comments about the Service may be directed to us at the email address **mshibanami+redirectweb@gmail.com**.
107 |
--------------------------------------------------------------------------------
/docusaurus.config.ts:
--------------------------------------------------------------------------------
1 | import { themes as prismThemes } from 'prism-react-renderer';
2 | import type { Config } from '@docusaurus/types';
3 | import type * as Preset from '@docusaurus/preset-classic';
4 | import remarkGithubAdmonitionsToDirectives from "remark-github-admonitions-to-directives";
5 |
6 | const projectName = 'redirect-web';
7 |
8 | const config: Config = {
9 | title: 'Redirect Web',
10 | tagline: 'Redirect any website',
11 |
12 | url: 'https://mshibanami.github.io/',
13 | baseUrl: `/${projectName}/`,
14 |
15 | organizationName: 'mshibanami',
16 | projectName: projectName,
17 |
18 | onBrokenLinks: 'throw',
19 | onBrokenMarkdownLinks: 'warn',
20 |
21 | i18n: {
22 | defaultLocale: 'en',
23 | locales: ['en'],
24 | },
25 |
26 | presets: [
27 | [
28 | 'classic',
29 | {
30 | docs: {
31 | routeBasePath: '/',
32 | sidebarPath: './sidebars.ts',
33 | sidebarCollapsible: false,
34 | beforeDefaultRemarkPlugins: [remarkGithubAdmonitionsToDirectives],
35 | },
36 | blog: {
37 | path: 'release-notes',
38 | routeBasePath: '/release-notes',
39 | blogSidebarTitle: 'Release Notes',
40 | blogTitle: 'Release Notes',
41 | blogSidebarCount: 'ALL',
42 | blogDescription: 'Release notes for Redirect Web.',
43 | blogListComponent: '@site/src/components/ReleaseNotesList',
44 | showReadingTime: false,
45 | feedOptions: {
46 | type: ['rss', 'atom', 'json'],
47 | title: 'Redirect Web Release Notes',
48 | description: 'An RSS feed of changelogs for Redirect Web',
49 | language: 'en',
50 | },
51 | },
52 | theme: {
53 | customCss: './src/css/custom.css',
54 | },
55 | } satisfies Preset.Options,
56 | ],
57 | ],
58 | themeConfig: {
59 | // Replace with your project's social card
60 | image: 'img/docusaurus-social-card.jpg',
61 | colorMode: {
62 | disableSwitch: false,
63 | respectPrefersColorScheme: true,
64 | },
65 | navbar: {
66 | title: 'Redirect Web',
67 | logo: {
68 | alt: 'Site Logo',
69 | src: 'img/logo.svg',
70 | },
71 | items: [
72 | { to: '/', label: 'Docs', position: 'left', activeBaseRegex: `^/${projectName}/(?!release-notes).*` },
73 | { to: '/release-notes', label: 'Release Notes', position: 'left', activeBaseRegex: `^/${projectName}/release-notes/?.*` },
74 | {
75 | href: 'https://github.com/mshibanami/redirect-web',
76 | label: 'GitHub',
77 | position: 'right',
78 | },
79 | ],
80 | },
81 | footer: {
82 | style: 'dark',
83 | copyright: `© ${new Date().getFullYear()} Manabu Nakazawa`,
84 | },
85 | prism: {
86 | theme: prismThemes.github,
87 | darkTheme: prismThemes.dracula,
88 | },
89 | } satisfies Preset.ThemeConfig,
90 | };
91 |
92 | export default config;
93 |
--------------------------------------------------------------------------------
/library/README.md:
--------------------------------------------------------------------------------
1 | # Library
2 |
3 | 
4 |
5 | The library is shown in the Redirect Web apps and the data under this `library` folder may be used in the app.
6 |
7 | ## Rule Sets
8 |
9 | Rule sets within the library are managed at the [rule-sets](rule-sets) folder.
10 |
11 | Each rule is identified by a unique integer ID. All data in a rule set should be in a folder named `{id}_{short-title-of-rule-set}`. This folder should contain:
12 |
13 | - `rule-set.json`
14 | - `metadata.json`
15 | - Image files (optional)
16 |
17 | Folders of deleted rule sets remain like `8_DELETED`, ensuring that IDs remain unique.
18 |
19 | You can submit a pull request to add your rule to the library.
20 |
21 | > [!WARNING]
22 | > Old rules will persist in the Git history, although you can modify or remove your rules after creation.
23 |
24 | ### `rule-set.json`
25 |
26 | This file defines a rule set containing one or more rules. It's essentially equivalent to the `redirectweb` file you can get by exporting your rules from the Redirect Web apps.
27 |
28 | > [!NOTE]
29 | > The file extension is `json` because it's easier to browse on GitHub.
30 |
31 | Below is an example of `rule-set.json` that configures Google Meet links to open in Google Chrome:
32 |
33 | ```json
34 | {
35 | "bundleID": "io.github.mshibanami.RedirectWebForSafari",
36 | "kind": "RedirectList",
37 | "redirects": [
38 | {
39 | "appURL": "file:\/\/\/Applications\/Google%20Chrome.app",
40 | "comments": "This is a rule to open Google Meet links in Google Chrome automatically.",
41 | "destinationURLPattern": "$0",
42 | "exampleURLs": [
43 | "https:\/\/meet.google.com\/xxx-yyyy-zzz"
44 | ],
45 | "kind": "Redirect",
46 | "sourceURLPattern": {
47 | "type": "regularExpression",
48 | "value": "https:\/\/meet.google.com\/[a-z]*-[a-z]*-[a-z]*"
49 | },
50 | "title": "Google Meet: Open in Chrome"
51 | }
52 | ]
53 | }
54 | ```
55 |
56 | ### `metadata.json`
57 |
58 | This file contains metadata of a rule set.
59 |
60 | ```json
61 | {
62 | "contributorGitHubIds": [
63 | "Redirecting...
56 |You are being redirected to:
57 |If you are not redirected automatically, please click here.
58 |About
124 |This tool automatically redirects Reddit links to available Redlib instances. Redlib is a private 125 | front-end for Reddit that doesn't require JavaScript to work.
126 | 127 |How to Use
128 |-
129 |
- Add your Reddit URL as a parameter to this page using
?url=(make sure the URL is 130 | properly URL-encoded)
131 | - The redirector will find an available Redlib instance and redirect you there 132 |
- Previously working instances are cached and prioritized for faster access 133 |
Example
136 |To visit r/privacy on Redlib, use:
137 |
138 | reddit-redirector.html?url=https%3A%2F%2Freddit.com%2Fr%2Fprivacy
139 |
140 |