# blazeftl/my-filters architecture

> Architecture diagram of the GitHub repository blazeftl/my-filters, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/blazeftl/my-filters
- Repository: https://github.com/blazeftl/my-filters

## Overview

My-Filters is primarily a personal cloud backup and distribution point for uBlock Origin filters and userscripts, alongside independent browser-based tools. The main user workflow is subscribing to the static filter list in uBlock Origin, configuring trusted-source access for advanced scriptlets, and receiving updates. A separate maintenance utility reads a filter file, checks domains through public DNS-over-HTTPS services, and writes a cleaned copy. The README documents editor, thread, dashboard, and resolver tools; their internal implementation and connections were not sampled, so those are shown as standalone entry points.

Main entry points: [`tools/check_dead_domains.py`](https://github.com/blazeftl/my-filters/blob/master/tools/check_dead_domains.py) (Dead-domain checker), [`My-Filters_Static_Sites.txt`](https://github.com/blazeftl/my-filters/blob/master/My-Filters_Static_Sites.txt) (Static filter list), [`CodeMirror6V2Final.html`](https://github.com/blazeftl/my-filters/blob/master/CodeMirror6V2Final.html) (CodeMirror 6 editor), [`uAssetEditorCM6.html`](https://github.com/blazeftl/my-filters/blob/master/uAssetEditorCM6.html) (uAsset CM6 editor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_distribution["Filter distribution"]
  node_filterlist["Static filter list"]
  node_ublock["uBlock Origin"]
end

subgraph group_maintenance["Filter maintenance"]
  node_domain_checker["Dead-domain checker"]
  node_dns["DNS-over-HTTPS"]
  node_cleaned_file["Cleaned filter file"]
end

subgraph group_editors["Filter editors"]
  node_cm6_editor["CodeMirror 6 editor"]
  node_uasset_editor["uAsset CM6 editor"]
  node_live_editor["Live editor"]
end

subgraph group_utilities["Standalone tools"]
  node_dead_domain_web["Dead Domain Checker"]
  node_thread_27472["Thread manager 27472"]
  node_thread_27472_user["Thread users 27472"]
  node_thread_17361["Thread manager 17361"]
  node_thread_17361_user["Thread users 17361"]
  node_investor_dark["Investor dashboard dark"]
  node_investor_light["Investor dashboard light"]
  node_flclash["FlClash resolver"]
end

node_user(("Browser user"))

node_user -->|"subscribes to"| node_filterlist
node_ublock -->|"fetches updates"| node_filterlist
node_user -->|"opens preview"| node_cm6_editor
node_user -->|"opens preview"| node_uasset_editor
node_user -->|"opens preview"| node_live_editor
node_user -->|"opens preview"| node_dead_domain_web
node_user -->|"opens preview"| node_thread_27472
node_user -->|"opens preview"| node_thread_27472_user
node_user -->|"opens preview"| node_thread_17361
node_user -->|"opens preview"| node_thread_17361_user
node_user -->|"opens preview"| node_investor_dark
node_user -->|"opens preview"| node_investor_light
node_user -->|"opens preview"| node_flclash
node_domain_checker -->|"queries domains"| node_dns
node_domain_checker -->|"writes cleaned copy"| node_cleaned_file

click node_filterlist "https://github.com/blazeftl/my-filters/blob/master/My-Filters_Static_Sites.txt"
click node_domain_checker "https://github.com/blazeftl/my-filters/blob/master/tools/check_dead_domains.py"
click node_cm6_editor "https://github.com/blazeftl/my-filters/blob/master/CodeMirror6V2Final.html"
click node_uasset_editor "https://github.com/blazeftl/my-filters/blob/master/uAssetEditorCM6.html"
click node_live_editor "https://github.com/blazeftl/my-filters/blob/master/LiveEditorNoWrapFinal.html"
click node_dead_domain_web "https://github.com/blazeftl/my-filters/blob/master/DeadDomainChecker.html"
click node_thread_27472 "https://github.com/blazeftl/my-filters/blob/master/27472_ShortnerThreadAllComments.html"
click node_thread_27472_user "https://github.com/blazeftl/my-filters/blob/master/27472_ShortnerThreadAllCommentsUser.html"
click node_thread_17361 "https://github.com/blazeftl/my-filters/blob/master/17361_ShortnerThreadAllComments.html"
click node_thread_17361_user "https://github.com/blazeftl/my-filters/blob/master/17361_ShortnerThreadAllCommentsUser.html"
click node_investor_dark "https://github.com/blazeftl/my-filters/blob/master/investor-dashboard-dark-v1.html"
click node_investor_light "https://github.com/blazeftl/my-filters/blob/master/investor-dashboard-v2-light.html"
click node_flclash "https://github.com/blazeftl/my-filters/blob/master/flclash-resolver.html"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_filterlist,node_ublock,node_user toneBlue
class node_domain_checker,node_dns,node_cleaned_file toneAmber
class node_cm6_editor,node_uasset_editor,node_live_editor toneMint
class node_dead_domain_web,node_thread_27472,node_thread_27472_user,node_thread_17361,node_thread_17361_user,node_investor_dark,node_investor_light,node_flclash toneRose
```

## Components

### Filter distribution

- [Static filter list](https://github.com/blazeftl/my-filters/blob/master/My-Filters_Static_Sites.txt): `My-Filters_Static_Sites.txt`
- **uBlock Origin**

### Filter maintenance

- [Dead-domain checker](https://github.com/blazeftl/my-filters/blob/master/tools/check_dead_domains.py): `tools/check_dead_domains.py`
- **DNS-over-HTTPS**
- **Cleaned filter file**

### Filter editors

- [CodeMirror 6 editor](https://github.com/blazeftl/my-filters/blob/master/CodeMirror6V2Final.html): `CodeMirror6V2Final.html`
- [uAsset CM6 editor](https://github.com/blazeftl/my-filters/blob/master/uAssetEditorCM6.html): `uAssetEditorCM6.html`
- [Live editor](https://github.com/blazeftl/my-filters/blob/master/LiveEditorNoWrapFinal.html): `LiveEditorNoWrapFinal.html`

### Standalone tools

- [Dead Domain Checker](https://github.com/blazeftl/my-filters/blob/master/DeadDomainChecker.html): `DeadDomainChecker.html`
- [Thread manager 27472](https://github.com/blazeftl/my-filters/blob/master/27472_ShortnerThreadAllComments.html): `27472_ShortnerThreadAllComments.html`
- [Thread users 27472](https://github.com/blazeftl/my-filters/blob/master/27472_ShortnerThreadAllCommentsUser.html): `27472_ShortnerThreadAllCommentsUser.html`
- [Thread manager 17361](https://github.com/blazeftl/my-filters/blob/master/17361_ShortnerThreadAllComments.html): `17361_ShortnerThreadAllComments.html`
- [Thread users 17361](https://github.com/blazeftl/my-filters/blob/master/17361_ShortnerThreadAllCommentsUser.html): `17361_ShortnerThreadAllCommentsUser.html`
- [Investor dashboard dark](https://github.com/blazeftl/my-filters/blob/master/investor-dashboard-dark-v1.html): `investor-dashboard-dark-v1.html`
- [Investor dashboard light](https://github.com/blazeftl/my-filters/blob/master/investor-dashboard-v2-light.html): `investor-dashboard-v2-light.html`
- [FlClash resolver](https://github.com/blazeftl/my-filters/blob/master/flclash-resolver.html): `flclash-resolver.html`

### Other components

- **Browser user**

## Connections

- Browser user → Static filter list: subscribes to (evidence: `README.md`)
- uBlock Origin → Static filter list: fetches updates (evidence: `README.md`)
- Browser user → CodeMirror 6 editor: opens preview (evidence: `README.md`)
- Browser user → uAsset CM6 editor: opens preview (evidence: `README.md`)
- Browser user → Live editor: opens preview (evidence: `README.md`)
- Browser user → Dead Domain Checker: opens preview (evidence: `README.md`)
- Browser user → Thread manager 27472: opens preview (evidence: `README.md`)
- Browser user → Thread users 27472: opens preview (evidence: `README.md`)
- Browser user → Thread manager 17361: opens preview (evidence: `README.md`)
- Browser user → Thread users 17361: opens preview (evidence: `README.md`)
- Browser user → Investor dashboard dark: opens preview (evidence: `README.md`)
- Browser user → Investor dashboard light: opens preview (evidence: `README.md`)
- Browser user → FlClash resolver: opens preview (evidence: `README.md`)
- Dead-domain checker → DNS-over-HTTPS: queries domains (evidence: `tools/check_dead_domains.py`)
- Dead-domain checker → Cleaned filter file: writes cleaned copy (evidence: `tools/check_dead_domains.py`)
