Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 13 additions & 12 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,16 @@
# SimpleModifyHeaders V 1.8.1

Extension for Firefox and Chrome. (The extension can be installed via [this link](https://addons.mozilla.org/firefox/addon/simple-modify-header/) for Firefox and via [this link](https://chrome.google.com/webstore/detail/simple-modify-headers/gjgiipmpldkpbdfjkgofildhapegmmic) for Chrome)
Extension for Firefox and Chrome.
The extension can be installed via [this link](https://addons.mozilla.org/firefox/addon/simple-modify-header/) for Firefox and [this link](https://chrome.google.com/webstore/detail/simple-modify-headers/gjgiipmpldkpbdfjkgofildhapegmmic) for Chrome.

The extension rewrites the headers based on a rules table.

The extension can be started and stopped via the button on the top right.

To save and apply the modification, you need to click on the save button.
To save and apply the modification, you need to click the save button.

It's possible to:
- export the configuration into a file (json format)
- export the configuration into a file (JSON format)
- import the configuration from a file. It supports the format of the Modifyheaders plugin. It is possible to append rules instead of replacing the configuration.

## Rules table
Expand All @@ -22,32 +23,32 @@ The rules table contains lines with the following parameters:
- status: on if the modification is active, off otherwise
- export: if set to value "To export" the rule is exported when using the export function

## Url pattern
## URL pattern
We can choose the URLs on which the modifications are applied by modifying the URL pattern :
- The URL pattern must follow the syntax defined by https://developer.chrome.com/extensions/match_patterns
- Putting an empty string on the field will select all URLs
- It's possible to select multiple URL patterns using a semicolon (;) separator
- It's not possible to define a specific port number https://stackoverflow.com/questions/11425591/match-port-in-chrome-extension-pattern
- It's not possible to specify a specific port number https://stackoverflow.com/questions/11425591/match-port-in-chrome-extension-pattern

## Parameters
The parameters button permits to:
The parameters button allows you to:
- Activate debug mode: shows detailed log messages in the extension debugging console of the browser.
- Show comments: show comments field on the config panel
- Filter URL by rules: activate the possibility to filter URL for each rule in the config panel. The header field will be modified only if the URL contains the configured value.


## Firefox-specific issue
According to the version of Firefox, the addition of a new header behaves differently. In the latest version, when you choose the "add" action and the header exists, it appends the value, while in the old version, it replaces it. If you want to modify an exiting header, you should use "modify" instead of "add"
Depending on the version of Firefox, the addition of a new header behaves differently. In the latest Firefox versions, when you choose the "add" action, and the header exists, it appends the value, whereas in old Firefox versions, it replaces it. If you want to modify an exiting header, you should use "modify" instead of "add"

## Limitation

Due to limitations in the webRequest API of browsers, headers of requests, which are invoked by Javascript, could not be modified.
Due to limitations in the webRequest API of browsers, headers of requests, which are invoked by JavaScript, cannot be modified.

## Extension permissions
In order to work, the following browser permissions are needed for the extension:
- storage: needed to store the configuration and the rules
- activeTab, tabs: needed to show the configuration screen in the browser tab.
- webRequest, webRequestBlocking ,<all_urls>: needed to modify the headers according to the rules table.
The following browser permissions are needed for this extension:
- storage: needed to store the configuration and rules
- activeTab, tabs: needed to show the configuration screen in the browser tab
- webRequest, webRequestBlocking ,<all_urls>: needed to modify the headers according to the rules table

## License
The code is Open Source under Mozilla Public License 2.0