# rookiestyle/globalsearch architecture

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

- Interactive diagram: https://gitdiagram.com/rookiestyle/globalsearch
- Repository: https://github.com/rookiestyle/globalsearch

## Overview

GlobalSearch is a KeePass plugin that extends supported searches across open databases, then preserves KeePass’s active-database entry-list behavior when displaying multi-database results. The graph combines documented product behavior with relationships visible in the excerpts and SOURCE INDEX; several individual search implementations are not sampled, so their internals are represented together rather than inferred.

Main entry points: [`src/GlobalSearch.cs`](https://github.com/Rookiestyle/GlobalSearch/blob/master/src/GlobalSearch.cs) (Plugin lifecycle and hooks), [`src/SpecialSearches/SearchHelp.cs`](https://github.com/Rookiestyle/GlobalSearch/blob/master/src/SpecialSearches/SearchHelp.cs) (Search catalog and dispatch), [`src/Options.cs`](https://github.com/Rookiestyle/GlobalSearch/blob/master/src/Options.cs) (Search options UI), [`src/Config.cs`](https://github.com/Rookiestyle/GlobalSearch/blob/master/src/Config.cs) (Plugin configuration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_integration["KeePass integration"]
  node_open_dbs[("Open databases")]
  node_plugin["Plugin lifecycle and hooks<br/>[GlobalSearch.cs]"]
  node_keepass_config[("KeePass custom config")]
end

subgraph group_search["Search and results"]
  node_search_catalog["Search catalog and dispatch<br/>[SearchHelp.cs]"]
  node_built_in_searches["Find and enhanced searches<br/>[GlobalSearch.cs]"]
  node_expired_search["Expired-entry search"]
  node_multi_search["Multi-database execution<br/>[GlobalSearch.cs]"]
  node_result_window["Combined results window<br/>[GlobalSearch.cs]"]
  node_database_activation["Database activation and filtering<br/>[GlobalSearch.cs]"]
end

subgraph group_settings["Configuration and UI"]
  node_options_ui["Search options UI<br/>[Options.cs]"]
  node_config["Plugin configuration<br/>[Config.cs]"]
end

subgraph group_support["Plugin support"]
  node_translations["Translation loader"]
  node_language_files["Translation files"]
  node_event_tools["Event-handler utilities<br/>[EventHelper.cs]"]
  node_theme_bridge["KeeTheme compatibility<br/>[KeeThemeStub.cs]"]
  node_options_tools["Options integration tools<br/>[Tools_Options.cs]"]
end

node_keepass(("KeePass user and host"))

node_keepass -.->|"loads plugin"| node_plugin
node_plugin -->|"initializes"| node_translations
node_plugin -->|"uses handlers"| node_event_tools
node_plugin -->|"uses compatibility"| node_theme_bridge
node_plugin -->|"opens options"| node_options_ui
node_options_ui -->|"updates settings"| node_config
node_config -->|"reads and writes"| node_keepass_config
node_plugin -->|"consults catalog"| node_search_catalog
node_search_catalog -->|"dispatches expired search"| node_expired_search
node_keepass -.->|"starts search"| node_built_in_searches
node_built_in_searches -.->|"runs across databases"| node_multi_search
node_open_dbs -.->|"provides search scope"| node_multi_search
node_multi_search -.->|"shows combined results"| node_result_window
node_result_window -.->|"selects entry"| node_database_activation
node_database_activation -.->|"activates matching database"| node_open_dbs
node_translations -.->|"loads translations"| node_language_files
node_plugin -.->|"uses options integration"| node_options_tools

click node_plugin "https://github.com/Rookiestyle/GlobalSearch/blob/master/src/GlobalSearch.cs"
click node_search_catalog "https://github.com/Rookiestyle/GlobalSearch/blob/master/src/SpecialSearches/SearchHelp.cs"
click node_built_in_searches "https://github.com/Rookiestyle/GlobalSearch/blob/master/src/GlobalSearch.cs"
click node_expired_search "https://github.com/Rookiestyle/GlobalSearch/blob/master/src/SpecialSearches/GlobalSearchExpired.cs"
click node_multi_search "https://github.com/Rookiestyle/GlobalSearch/blob/master/src/GlobalSearch.cs"
click node_result_window "https://github.com/Rookiestyle/GlobalSearch/blob/master/src/GlobalSearch.cs"
click node_database_activation "https://github.com/Rookiestyle/GlobalSearch/blob/master/src/GlobalSearch.cs"
click node_options_ui "https://github.com/Rookiestyle/GlobalSearch/blob/master/src/Options.cs"
click node_config "https://github.com/Rookiestyle/GlobalSearch/blob/master/src/Config.cs"
click node_translations "https://github.com/Rookiestyle/GlobalSearch/blob/master/src/PluginTranslation.cs"
click node_language_files "https://github.com/Rookiestyle/GlobalSearch/tree/master/Translations"
click node_event_tools "https://github.com/Rookiestyle/GlobalSearch/blob/master/src/Utilities/EventHelper.cs"
click node_theme_bridge "https://github.com/Rookiestyle/GlobalSearch/blob/master/src/Utilities/KeeThemeStub.cs"
click node_options_tools "https://github.com/Rookiestyle/GlobalSearch/blob/master/src/Utilities/Tools_Options.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_open_dbs,node_plugin,node_keepass_config,node_keepass toneBlue
class node_search_catalog,node_built_in_searches,node_expired_search,node_multi_search,node_result_window,node_database_activation toneAmber
class node_options_ui,node_config toneMint
class node_translations,node_language_files,node_event_tools,node_theme_bridge,node_options_tools toneRose
```

## Components

### KeePass integration

- **Open databases**
- [Plugin lifecycle and hooks](https://github.com/Rookiestyle/GlobalSearch/blob/master/src/GlobalSearch.cs): `src/GlobalSearch.cs`
- **KeePass custom config**

### Search and results

- [Search catalog and dispatch](https://github.com/Rookiestyle/GlobalSearch/blob/master/src/SpecialSearches/SearchHelp.cs): `src/SpecialSearches/SearchHelp.cs`
- [Find and enhanced searches](https://github.com/Rookiestyle/GlobalSearch/blob/master/src/GlobalSearch.cs): `src/GlobalSearch.cs`
- [Expired-entry search](https://github.com/Rookiestyle/GlobalSearch/blob/master/src/SpecialSearches/GlobalSearchExpired.cs): `src/SpecialSearches/GlobalSearchExpired.cs`
- [Multi-database execution](https://github.com/Rookiestyle/GlobalSearch/blob/master/src/GlobalSearch.cs): `src/GlobalSearch.cs`
- [Combined results window](https://github.com/Rookiestyle/GlobalSearch/blob/master/src/GlobalSearch.cs): `src/GlobalSearch.cs`
- [Database activation and filtering](https://github.com/Rookiestyle/GlobalSearch/blob/master/src/GlobalSearch.cs): `src/GlobalSearch.cs`

### Configuration and UI

- [Search options UI](https://github.com/Rookiestyle/GlobalSearch/blob/master/src/Options.cs): `src/Options.cs`
- [Plugin configuration](https://github.com/Rookiestyle/GlobalSearch/blob/master/src/Config.cs): `src/Config.cs`

### Plugin support

- [Translation loader](https://github.com/Rookiestyle/GlobalSearch/blob/master/src/PluginTranslation.cs): `src/PluginTranslation.cs`
- [Translation files](https://github.com/Rookiestyle/GlobalSearch/tree/master/Translations): `Translations`
- [Event-handler utilities](https://github.com/Rookiestyle/GlobalSearch/blob/master/src/Utilities/EventHelper.cs): `src/Utilities/EventHelper.cs`
- [KeeTheme compatibility](https://github.com/Rookiestyle/GlobalSearch/blob/master/src/Utilities/KeeThemeStub.cs): `src/Utilities/KeeThemeStub.cs`
- [Options integration tools](https://github.com/Rookiestyle/GlobalSearch/blob/master/src/Utilities/Tools_Options.cs): `src/Utilities/Tools_Options.cs`

### Other components

- **KeePass user and host**

## Connections

- KeePass user and host → Plugin lifecycle and hooks: loads plugin
- Plugin lifecycle and hooks → Translation loader: initializes (evidence: `src/GlobalSearch.cs`)
- Plugin lifecycle and hooks → Event-handler utilities: uses handlers (evidence: `src/GlobalSearch.cs`)
- Plugin lifecycle and hooks → KeeTheme compatibility: uses compatibility (evidence: `src/GlobalSearch.cs`)
- Plugin lifecycle and hooks → Search options UI: opens options (evidence: `src/GlobalSearch.cs`)
- Search options UI → Plugin configuration: updates settings (evidence: `src/Options.cs`)
- Plugin configuration → KeePass custom config: reads and writes (evidence: `src/Config.cs`)
- Plugin lifecycle and hooks → Search catalog and dispatch: consults catalog (evidence: `src/GlobalSearch.cs`)
- Search catalog and dispatch → Expired-entry search: dispatches expired search (evidence: `src/SpecialSearches/SearchHelp.cs`)
- KeePass user and host → Find and enhanced searches: starts search
- Find and enhanced searches → Multi-database execution: runs across databases (evidence: `src/GlobalSearch.cs`)
- Open databases → Multi-database execution: provides search scope
- Multi-database execution → Combined results window: shows combined results (evidence: `src/GlobalSearch.cs`)
- Combined results window → Database activation and filtering: selects entry (evidence: `src/GlobalSearch.cs`)
- Database activation and filtering → Open databases: activates matching database
- Translation loader → Translation files: loads translations
- Plugin lifecycle and hooks → Options integration tools: uses options integration
