Go to file
Raymond Hill 59d918356b
Remove obsolete assets
2021-07-20 13:57:06 -04:00
.github Update ISSUE_TEMPLATE.md 2018-04-15 13:55:48 -04:00
assets Remove obsolete assets 2021-07-20 13:57:06 -04:00
dist New revision for dev build 2021-07-19 11:57:31 -04:00
doc µ to u (#1002) 2018-07-20 07:20:52 -04:00
platform Fix broken content scripts in Firefox 2019-12-24 11:48:04 -05:00
src Fix infinite recursion with maliciously crafted URL 2021-07-19 11:56:15 -04:00
tools Fix fetching of assets at build time 2021-07-19 11:58:09 -04:00
.gitignore add changes needed for self-hosted signed beta version 2018-03-05 17:10:39 -05:00
.jshintrc Bring uMatrix up to date 2019-12-20 12:24:18 -05:00
.travis.yml Fix packaging/publishing scripts 2019-12-25 09:30:34 -05:00
CONTRIBUTING.md Update CONTRIBUTING.md 2018-04-15 12:21:40 -04:00
LICENSE.txt a whole lot more left to do, at least popup shows 2015-04-13 12:31:55 -04:00
README.md Update README.md 2018-04-18 09:16:30 -04:00

README.md

uMatrix

Definitely for advanced users.


Keep Github issues for actual bugs. User support is /r/uMatrix.

Forked and refactored from HTTP Switchboard.

Install manually the latest release, or install from:

You may contribute with translation work:

HTTP Switchboard's documentation is still relevant, except for uMatrix's differences with HTTP Switchboard.

You may contribute with documentation: uMatrix's wiki.

Warnings

Regarding broken sites

uMatrix does not guarantee that sites will work fine: it is for advanced users who can figure how to un-break sites, because essentially uMatrix is a firewall which works in relaxed block-all/allow-exceptionally mode out of the box: it is not unexpected that sites will break.

So this means do not file issues to report broken sites when the sites are broken because uMatrix does its job as expected. I will close any such issue without further comment.

Using uMatrix logger is key to un-break sites: the logger will show you all that uMatrix does internally.

I expect there will be community driven efforts for users to help each others. If uMatrix had a home, I would probably set up a forum, but I do not plan for such thing, I really just want to code, not manage web sites. If you need help to un-break a site when using uMatrix, you can try Wilders Security, where you are likely to receive help if needed, whether by me or other users.

uMatrix can be set to work in allow-all/block-exceptionally mode with a single click on the all cell in the global scope *, if you prefer to work this way. This will of course break less sites, but you would then lose all the benefits which comes with block-all/allow-exceptionally mode -- though you will still benefit from the 62,000+ blacklisted hostnames by default.

License

GPLv3.