{"id":25129564,"url":"https://github.com/xarantolus/subresource_filter_tools","last_synced_at":"2026-02-24T07:22:42.775Z","repository":{"id":41168227,"uuid":"319686944","full_name":"xarantolus/subresource_filter_tools","owner":"xarantolus","description":"Scripts that build Chromium's subresource_filter_tools (including ruleset_converter) for both Linux and Windows. These tools can be used to generate ad block filters for Bromite","archived":false,"fork":false,"pushed_at":"2025-12-14T12:58:15.000Z","size":77,"stargazers_count":13,"open_issues_count":3,"forks_count":4,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-16T18:46:53.817Z","etag":null,"topics":["bromite","chromium","chromium-adblock","converter","filterlist","ruleset","ruleset-converter","subresource-filter","subresource-filter-tool","subresource-filter-tools","subresource-indexing-tool"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xarantolus.png","metadata":{"files":{"readme":"README.md","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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2020-12-08T15:52:16.000Z","updated_at":"2025-12-14T12:58:18.000Z","dependencies_parsed_at":"2025-12-14T15:07:00.610Z","dependency_job_id":null,"html_url":"https://github.com/xarantolus/subresource_filter_tools","commit_stats":null,"previous_names":[],"tags_count":55,"template":false,"template_full_name":null,"purl":"pkg:github/xarantolus/subresource_filter_tools","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xarantolus%2Fsubresource_filter_tools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xarantolus%2Fsubresource_filter_tools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xarantolus%2Fsubresource_filter_tools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xarantolus%2Fsubresource_filter_tools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xarantolus","download_url":"https://codeload.github.com/xarantolus/subresource_filter_tools/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xarantolus%2Fsubresource_filter_tools/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28717393,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-24T05:53:42.649Z","status":"ssl_error","status_checked_at":"2026-01-24T05:53:41.698Z","response_time":89,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["bromite","chromium","chromium-adblock","converter","filterlist","ruleset","ruleset-converter","subresource-filter","subresource-filter-tool","subresource-filter-tools","subresource-indexing-tool"],"created_at":"2025-02-08T12:18:04.082Z","updated_at":"2026-01-24T06:57:30.316Z","avatar_url":"https://github.com/xarantolus.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# subresource_filter_tools\nThis is a repository for building the `subresource_filter_tools` part of [The Chromium Project](https://www.chromium.org/Home).\n\nCurrently supported are builds for both Linux and Windows on the x64 architecture. These scripts also run without problems on [Ubuntu on WSL](https://ubuntu.com/wsl), which means that you can also run both the Windows and Linux part on a Windows 10 machine.\n\nYou should run this on a SSD of sufficient size (because you'll end up with ~700k files that are ~22GB in size *per OS*, so basically twice that).\n\n### Scripts for Linux\n* `generate_everything.sh`: this is the script you want to run to build and package everything. At first it runs the install \u0026 build script, then copies all release files into a directory, which is then zipped. It automatically updates the code on subsequent builds and only creates a new release file if the build result changed. \n* `build_linux.sh`: installs all build tools (follows [this guide](https://chromium.googlesource.com/chromium/src/+/master/docs/linux/build_instructions.md)), then downloads the source code and builds `subresource_filter_tools`\n* `copy_libs.sh`: copies binaries and their required libraries to an `out/` directory\n\n### Scripts for Windows\n* `build_windows.ps1`: This scripts clones Chromium, installs dependencies and builds everything that's needed. Then it creates a release zip file. Please note that this script might do **PERMANENT CHANGES TO YOUR SYSTEM ENVIRONMENT**, so run it in a virtual machine or some other way to prevent it from doing so. Or just run it in GitHub Actions, which is what this script was made for\n\nPlease note that in both cases the initial download takes at least 30 minutes. The build is also quite slow. It might take about an hour or longer to download and build.\n\n## Use-Case\nThese tools allow generating custom ad block filters for browsers that support it, such as [Bromite](https://www.bromite.org/custom-filters) (Android).\n\nI needed some of these tools for my related project, but couldn't find any recent precompiled binaries.\nIf you want some AdBlock filter lists for Bromite and possibly other browsers, see [the `filtrite` project](https://github.com/xarantolus/filtrite).\n\n## How to use\nSee [this page](https://chromium.googlesource.com/chromium/src.git/+/master/components/subresource_filter/FILTER_LIST_GENERATION.md) \u003csup\u003e[GitHub Mirror](https://github.com/chromium/chromium/blob/master/components/subresource_filter/FILTER_LIST_GENERATION.md)\u003c/sup\u003e to find out how to use these tools.\n\nIf you want to use them for Bromite, check out [this page](https://www.bromite.org/custom-filters) for a nice guide.\n\nTL;DR:\n\n\truleset_converter --input_format=filter-list \\\n\t\t--output_format=unindexed-ruleset \\\n\t\t--input_files=easyprivacy.txt,easylist.txt \\\n\t\t--output_file=filters.dat\n\n## Download\nYou can either head over to the releases section of this repository or [click this direct link for Linux](https://github.com/xarantolus/subresource_filter_tools/releases/latest/download/subresource_filter_tools_linux-x64.zip) or [this direct link for Windows](https://github.com/xarantolus/subresource_filter_tools/releases/latest/download/subresource_filter_tools_windows-x64.zip) to get the latest release.\n\nThese releases are built by GitHub Actions every month, so they should be up to date.\n\n## License\nThe License applies to the files published in this repository.\nIt probably does **not** apply for releases, as they are a product of work others have done.\nAlso see the [Chromium license](https://chromium.googlesource.com/chromium/src/+/master/LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxarantolus%2Fsubresource_filter_tools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxarantolus%2Fsubresource_filter_tools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxarantolus%2Fsubresource_filter_tools/lists"}