# lin-ycv/everythingpowertoys architecture

> Architecture diagram of the GitHub repository lin-ycv/everythingpowertoys, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lin-ycv/everythingpowertoys
- Repository: https://github.com/lin-ycv/everythingpowertoys

## Overview

Everything for PowerToys Run is a plugin that exposes Everything-backed file and folder search in the PowerToys Run launcher. The main workflow is launcher input → plugin query processing → Everything’s native search interface → launcher results and file actions. Separate branches provide configurable search behavior, context-menu actions, and optional update checks. The graph reflects relationships shown in excerpts, the SOURCE INDEX, or README; some internal query and settings details were not fully sampled.

Main entry points: [`Main.cs`](https://github.com/lin-ycv/everythingpowertoys/blob/main/Main.cs) (Plugin entry), [`Everything.cs`](https://github.com/lin-ycv/everythingpowertoys/blob/main/Everything.cs) (Query engine), [`ContextMenu/ContextMenuLoader.cs`](https://github.com/lin-ycv/everythingpowertoys/blob/main/ContextMenu/ContextMenuLoader.cs) (Context actions), [`Update/UpdateChecker.cs`](https://github.com/lin-ycv/everythingpowertoys/blob/main/Update/UpdateChecker.cs) (Update checker)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_plugin["Plugin workflow"]
  node_main["Plugin entry<br/>[Main.cs]"]
  node_settings["Plugin settings<br/>[Settings.cs]"]
  node_filter_config["Filter config<br/>[settings.toml]"]
end

subgraph group_search["Search and results"]
  node_everything["Query engine<br/>[Everything.cs]"]
  node_native["Native bindings<br/>[NativeMethods.cs]"]
  node_everything_service["Everything service"]
  node_search_result["File result data<br/>[SearchResult.cs]"]
end

subgraph group_actions["File actions"]
  node_context_loader["Context actions"]
  node_shell_menu["Shell menu"]
end

subgraph group_updates["Updates"]
  node_update_checker["Update checker<br/>[UpdateChecker.cs]"]
  node_update_settings["Update preferences<br/>[UpdateSettings.cs]"]
end

node_ptr(("PowerToys Run"))
node_windows_shell["Windows Shell"]
node_github["GitHub releases"]

node_ptr -->|"invokes plugin"| node_main
node_main -->|"queries"| node_everything
node_main -->|"configures"| node_settings
node_main -->|"initializes"| node_context_loader
node_main -->|"starts check"| node_update_checker
node_main -->|"loads"| node_update_settings
node_settings -->|"reads filters"| node_filter_config
node_everything -->|"calls"| node_native
node_native -.->|"queries"| node_everything_service
node_everything -->|"uses options"| node_settings
node_everything -->|"creates context data"| node_search_result
node_context_loader -->|"reads selection"| node_search_result
node_context_loader -->|"updates run count"| node_native
node_context_loader -->|"opens menu"| node_shell_menu
node_shell_menu -.->|"invokes shell"| node_windows_shell
node_update_checker -->|"checks releases"| node_github
node_update_checker -->|"reads options"| node_settings
node_update_checker -->|"reads skip version"| node_update_settings

click node_main "https://github.com/lin-ycv/everythingpowertoys/blob/main/Main.cs"
click node_settings "https://github.com/lin-ycv/everythingpowertoys/blob/main/Settings.cs"
click node_filter_config "https://github.com/lin-ycv/everythingpowertoys/blob/main/settings.toml"
click node_everything "https://github.com/lin-ycv/everythingpowertoys/blob/main/Everything.cs"
click node_native "https://github.com/lin-ycv/everythingpowertoys/blob/main/Interop/NativeMethods.cs"
click node_search_result "https://github.com/lin-ycv/everythingpowertoys/blob/main/SearchHelper/SearchResult.cs"
click node_context_loader "https://github.com/lin-ycv/everythingpowertoys/blob/main/ContextMenu/ContextMenuLoader.cs"
click node_shell_menu "https://github.com/lin-ycv/everythingpowertoys/blob/main/ContextMenu/ShellContextMenu.cs"
click node_update_checker "https://github.com/lin-ycv/everythingpowertoys/blob/main/Update/UpdateChecker.cs"
click node_update_settings "https://github.com/lin-ycv/everythingpowertoys/blob/main/Update/UpdateSettings.cs"

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_main,node_settings,node_filter_config toneBlue
class node_everything,node_native,node_everything_service,node_search_result toneAmber
class node_context_loader,node_shell_menu toneMint
class node_update_checker,node_update_settings toneRose
class node_ptr,node_windows_shell,node_github toneIndigo
```

## Components

### Plugin workflow

- [Plugin entry](https://github.com/lin-ycv/everythingpowertoys/blob/main/Main.cs): `Main.cs`
- [Plugin settings](https://github.com/lin-ycv/everythingpowertoys/blob/main/Settings.cs): `Settings.cs`
- [Filter config](https://github.com/lin-ycv/everythingpowertoys/blob/main/settings.toml): `settings.toml`

### Search and results

- [Query engine](https://github.com/lin-ycv/everythingpowertoys/blob/main/Everything.cs): `Everything.cs`
- [Native bindings](https://github.com/lin-ycv/everythingpowertoys/blob/main/Interop/NativeMethods.cs): `Interop/NativeMethods.cs`
- **Everything service**
- [File result data](https://github.com/lin-ycv/everythingpowertoys/blob/main/SearchHelper/SearchResult.cs): `SearchHelper/SearchResult.cs`

### File actions

- [Context actions](https://github.com/lin-ycv/everythingpowertoys/blob/main/ContextMenu/ContextMenuLoader.cs): `ContextMenu/ContextMenuLoader.cs`
- [Shell menu](https://github.com/lin-ycv/everythingpowertoys/blob/main/ContextMenu/ShellContextMenu.cs): `ContextMenu/ShellContextMenu.cs`

### Updates

- [Update checker](https://github.com/lin-ycv/everythingpowertoys/blob/main/Update/UpdateChecker.cs): `Update/UpdateChecker.cs`
- [Update preferences](https://github.com/lin-ycv/everythingpowertoys/blob/main/Update/UpdateSettings.cs): `Update/UpdateSettings.cs`

### Other components

- **PowerToys Run**
- **Windows Shell**
- **GitHub releases**

## Connections

- PowerToys Run → Plugin entry: invokes plugin
- Plugin entry → Query engine: queries (evidence: `Main.cs`)
- Plugin entry → Plugin settings: configures (evidence: `Main.cs`)
- Plugin entry → Context actions: initializes (evidence: `Main.cs`)
- Plugin entry → Update checker: starts check (evidence: `Main.cs`)
- Plugin entry → Update preferences: loads (evidence: `Main.cs`)
- Plugin settings → Filter config: reads filters (evidence: `Settings.cs`)
- Query engine → Native bindings: calls (evidence: `Everything.cs`)
- Native bindings → Everything service: queries
- Query engine → Plugin settings: uses options (evidence: `Everything.cs`)
- Query engine → File result data: creates context data (evidence: `Everything.cs`)
- Context actions → File result data: reads selection (evidence: `ContextMenu/ContextMenuLoader.cs`)
- Context actions → Native bindings: updates run count (evidence: `ContextMenu/ContextMenuLoader.cs`)
- Context actions → Shell menu: opens menu (evidence: `ContextMenu/ContextMenuLoader.cs`)
- Shell menu → Windows Shell: invokes shell
- Update checker → GitHub releases: checks releases (evidence: `Update/UpdateChecker.cs`)
- Update checker → Plugin settings: reads options (evidence: `Update/UpdateChecker.cs`)
- Update checker → Update preferences: reads skip version (evidence: `Update/UpdateChecker.cs`)
