{"id":16027025,"url":"https://github.com/ashwinvis/umatrix2ublock","last_synced_at":"2025-03-18T03:32:06.229Z","repository":{"id":43485745,"uuid":"243297357","full_name":"ashwinvis/umatrix2ublock","owner":"ashwinvis","description":"Migrate rulesets from uMatrix to uBlock-Origin","archived":false,"fork":false,"pushed_at":"2021-07-20T10:38:14.000Z","size":13,"stargazers_count":22,"open_issues_count":0,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-15T04:55:21.176Z","etag":null,"topics":["ublock-origin","umatrix"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ashwinvis.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-02-26T15:31:58.000Z","updated_at":"2024-10-31T22:38:54.000Z","dependencies_parsed_at":"2022-09-14T20:03:03.892Z","dependency_job_id":null,"html_url":"https://github.com/ashwinvis/umatrix2ublock","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashwinvis%2Fumatrix2ublock","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashwinvis%2Fumatrix2ublock/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashwinvis%2Fumatrix2ublock/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashwinvis%2Fumatrix2ublock/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ashwinvis","download_url":"https://codeload.github.com/ashwinvis/umatrix2ublock/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243901428,"owners_count":20366252,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ublock-origin","umatrix"],"created_at":"2024-10-08T20:04:38.205Z","updated_at":"2025-03-18T03:32:05.963Z","avatar_url":"https://github.com/ashwinvis.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"umatrix2ublock\n==============\n\nMigrate rulesets from uMatrix_ to uBlock-Origin_.\n\n.. warning::\n\n   Websites are very likely to break with this setup, so have uBlock-Origin disabled\n   in private windows such that you have a fallback option.\n\nAn effort is made to retain similar functionality and blocking as before.\n\nUsage\n-----\n\n1. Opt-in under uBlock-Origin_ settings: \"I am an advanced_ user\". Then block_\n   3rd-party scripts and frames globally. Alternatively block only 3rd-party\n   frames_ (less breakage).\n\n   .. image:: https://user-images.githubusercontent.com/9155111/75366608-44884300-58bf-11ea-88ff-8ca3252fd763.png\n\n2. Either enable \"Custom\" Firefox Enhanced Tracking protection to block all\n   third-party cookies, or use Cookie-AutoDelete_.\n\n3. Export your existing uMatrix_ and uBlock-Origin_ rules into text files.\n   Execute it something similar to::\n\n     cd examples/\n     python ../umatrix2ublock.py my-umatrix-rules.txt my-ublock-dynamic-rules_2020-02-26_14.07.25.txt\n\n   to obtain a merged ruleset ``my-ublock-dynamic-rules.txt`` compatible with\n   uBlock-Origin_.\n\n4. Import the merged ruleset into uBlock-Origin_.\n\nBackground\n----------\n\nIn my browser, I originally had uBlock-Origin_ (with its default settings) and\nuMatrix_.\n\nI started using uMatrix_ to block all third-party requests by default (except\ncss and images), and whitelisting a few requests to make the website is\nfunctional.\n\n.. image:: https://user-images.githubusercontent.com/585534/33213085-ff74afd8-d0f3-11e7-8232-4c204925d274.png\n\nI realized later that most of the time, I was just whitelisting scripts and\nXHRs. Which meant in principle, I can rely on custom settings as mentioned\nabove. I simply needed to migrate my uMatrix_ rules that I had aggregated over\nseveral months to serve the same purpose.\n\n\n.. _advanced: https://github.com/gorhill/uBlock/wiki/Advanced-user-features\n.. _block: https://github.com/gorhill/uBlock/wiki/Dynamic-filtering:-Benefits-of-blocking-3rd-party-script-and-iframe-tags\n.. _frames: https://github.com/gorhill/uBlock/wiki/Dynamic-filtering:-Benefits-of-blocking-3rd-party-iframe-tags\n.. _uMatrix: https://github.com/gorhill/uMatrix\n.. _uBlock-Origin: https://github.com/gorhill/uBlock\n.. _Cookie-AutoDelete: https://github.com/Cookie-AutoDelete/Cookie-AutoDelete\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fashwinvis%2Fumatrix2ublock","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fashwinvis%2Fumatrix2ublock","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fashwinvis%2Fumatrix2ublock/lists"}