Skip to content
This repository was archived by the owner on Sep 19, 2020. It is now read-only.

Raw settings

Jump to bottom
gwarser edited this page Mar 4, 2020 · 31 revisions

These settings are for users who want to further customize the behavior or appearance of uMatrix.

Keep in mind that any of these raw settings may be removed in the future, more may be added, or existing ones may become mainstream settings with a dedicated UI. Some of these raw settings may exist for experimental purpose only.

To restore any one setting to its original built-in value, just remove the whole setting.

assetFetchBypassBrowserCache

Default: false

uMatrix 1.4.1b4 and above, based on uBlock Origin commit.

If set to true, uMatrix will ensure the browser cache is bypassed when fetching a remote resource.

This is for the convenience of filter list maintainers who may want to test the latest version of their lists when fetched from their remote location.

assetFetchTimeout

Default: 30 seconds.

uMatrix 1.4.1b4 and above.

The number of seconds after which uMatrix throws an error when a remote server fails to respond to a request.

autoUpdateAssetFetchPeriod

Default: 120 seconds.

uMatrix 1.4.1b4 and above.

When the auto-updater kicks in and an asset in need of update is fetched, this is the number of seconds to wait before fetching the next asset which needs to be updated. The delay helps spread the load on CPU and memory as a result of loading/parsing/compiling the filter lists which have been updated.

cacheStorageAPI

Default: unset.

uMatrix 1.4.1b4/1.4.1b6 and above.

If set to browser.storage.local, uMatrix will use WebExtensions storage as a backend to cache storage.

Additionally, should indexedDB not be available for whatever reason, uMatrix will automatically fallback to browser.storage.local.

If set to indexedDB, uMatrix will use IndexedDB as a backend to the cache storage, potentially increasing performance and reducing memory usage. See uBO #328 for details. Bad side effects - filter lists will be out of date in Chrome incognito mode - uBO #399.

If unset, uMatrix will use whatever backend storage which is optimal for the current platform.

cacheStorageCompression

Default: true.

uMatrix 1.4.1b4/1.4.1b6 and above.

If set to true, uMatrix will lz4-compress data before storing it in its cache storage. The cache storage is used for storing downloaded filter lists, compiled filter lists, selfies. This setting work when IndexedDB is used as the cache storage backend (by default with Firefox/Firefox for Android). See uBO #141 for related discussion.

cnameIgnore1stParty

Default: true.

uMatrix 1.4.1b4 and above, based on uBlock Origin commit.

Whether uMatrix should ignore to re-run a network request through the filtering engine when the CNAME hostname is 1st-party to the alias hostname.

cnameIgnoreExceptions

uMatrix 1.4.1b4 and above, based on uBlock Origin commit.

Whether to bypass the uncloaking of network requests which were excepted by filters/rules.

This is necessary so as to avoid undue breakage by having exception filters being rendered useless as a result of CNAME-uncloaking.

For example, google-analytics.com uncloaks to www-google-analytics.l.google.com and both hostnames appear in Peter Lowe's list, which means exception filters for google-analytics.com (to fix site breakage) would be rendered useless as the uncloaking would cause the network request to be ultimately blocked.

cnameIgnoreList

Default: unset.

uMatrix 1.4.1b4 and above, based on uBlock Origin commit.

Possible values:

  • Space-separated list of hostnames.
  • * - all hostnames.

This tells uMatrix to NOT re-run the network request through uMatrix filtering engine with the CNAME hostname.

This is useful to exclude commonly used actual hostnames from being re-run through uMatrix filtering engine, so as to avoid pointless overhead.

contributorMode

[TODO]

disableCSPReportInjection

  • Type: boolean
  • false (default): do inject a Content-Security-Policy-Report-Only header in response headers, as needed.
  • true: never inject a Content-Security-Policy-Report-Only header in response headers.
    • Disabling the injection of Content-Security-Policy-Report-Only will render uMatrix unable to report to you whether web workers are used by a web page when these are not to be blocked.

The Content-Security-Policy-Report-Only is currently injected by uMatrix to detect the use of web workers on a site, when web workers are not forbidden.

The main purpose of this setting is to serve as a workaround for issue #912. This setting may go away whenever the root issue is resolved in Chromium.

enforceEscapedFragment

  • Type: boolean (default to true)

Whether uMatrix should replace an instance of #! to ?_escaped_fragment_= in a document URL when first-party scripts are blocked.

See issue #940 for details.

framePlaceholder

  • Type: boolean
  • true (default): replace non-collapsed blocked frame with a placeholder.
  • false: do not replace non-collapsed blocked frame with a placeholder.

framePlaceholderBackground

  • Type: string
  • default (default): use the background value from placeholderBackground.
  • Otherwise a valid CSS background property value to be used as is.

framePlaceholderDocument

  • Type: string
  • An HTML document source with no newline character.

imagePlaceholder

  • Type: boolean
  • true (default): replace non-collapsed blocked image with a placeholder.
  • false: do not replace non-collapsed blocked image with a placeholder.

Use false to prevent the use of placeholder for blocked images and thus eliminate the ability of image placeholder styling information to be used as fingerprint information.

imagePlaceholderBackground

  • Type: string
  • default (default): use the background value from placeholderBackground.
  • Otherwise a valid CSS background property value to be used as is.

Note that using a custom value for image placeholder can make you fingerprintable.

imagePlaceholderBorder

  • Type: string
  • default (default): : use the border value from placeholderBorder.
  • Otherwise a valid CSS border property value to be used as is.

Note that using a custom value for image placeholder can make you fingerprintable.

placeholderBackground

  • Type: string
  • Default value is an internal CSS background value.
  • Otherwise a valid CSS background property to be used as placeholder background.

Override this value if you want to customize the background value for all placeholders.

Note that using a custom value for image placeholder can make you fingerprintable.

placeholderBorder

  • Type: string
  • Default value is an internal CSS border value.
  • Otherwise a valid CSS border property to be used as placeholder background.

Override this value if you want to customize the border value for all placeholders.

Note that using a custom value for image placeholder can make you fingerprintable.

uMatrix: Point and click matrix to filter net requests according to source, destination and type.

Clone this wiki locally