Skip to content

themagicteeth/umatrix-recipes

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

uMatrix Recipes

This repository is a set of uMatrix recipes that I have made and are ready to be imported into uMatrix.

Recipes are a feature being introduced to uMatrix as described on the releases page:

uMatrix will offer you the ability to import community-contributed ruleset recipes which are relevant to the current page

I am no rule making expert, but my goal with this is to update for every site that I create rules for. It is mostly for personal use so certain sites are configured for logins, and for English versions of domains.

TLDR: Add https://raw.githubusercontent.com/themagicteeth/umatrix-recipes/master/recipes.txt to your imported ruleset recipes and use them.

Requirements

  1. Firefox Nightly or Developer Edition
    • must be able to install unsigned extensions
  2. uMatrix Beta

Installing uMatrix Beta

Before installing an about:config flag must be set.

  1. Copy this into the URL bar: about:config?filter=xpinstall.signatures.required
  2. Set it to false

Currently recipes are only supported in the beta version of uMatrix which is not on the add-on store yet.

These rules expect uMatrix to be configured globally the following way:

Matrix

uMatrix Global Configuration

This translates to the following rules:

* * * block
* 1st-party css allow
* 1st-party image allow

Switches

uMatrix Global Switches

This translates to the following rules:

https-strict: * true
no-workers: * true
noscript-spoof: * true
referrer-spoof: * true

Enable and import recipes

Open the settings and go to the Assets tab. Towards the bottom is where recipe lists are added. Check the box that says Import... and paste in this URL:

https://raw.githubusercontent.com/themagicteeth/umatrix-recipes/master/recipes.txt

Import Recipes

Then click Apply changes followed by Update now. This will pull in the recipes to be used with uMatrix.

Apply and update assets

Using a recipe

To use a recipe, simply click the puzzle piece icon on a site that has a recipe. The puzzle piece will change from grey to blue on sites that have a ruleset. To view the rules click the sitename and then apply them by clicking the lock icon.

Applying a recipe

Complementary Add-ons

A web browser extension that emulates Content Delivery Networks to improve your online privacy. It intercepts traffic, finds supported resources locally, and injects them into the environment.

Download it here.

Once installed there is no additional configuration required. You can continue to use uMatrix the same way as before.

When a resource that Decentraleyes has locally is requested it will serve the local resource instead of the hosted one. You still need to allow the domain on a per site basis otherwise it will not do anything.

It is advised to not globally add rules for the sites supported by Decentraleyes, and instead allow only when required.

Resources

uMatrix Examples of Useful Rulesets
uMatrix Recipes
uMatrix Rules - Domain Level
uMatrix Rules - Site Level
Official Recipes for uMatrix
Reddit Recipes Thread
uMatrix Issue Discussion about Recipes

About

📖 Recipes for uMatrix

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published