# exe-cuute/universalsearchlauncher architecture

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

- Interactive diagram: https://gitdiagram.com/exe-cuute/universalsearchlauncher
- Repository: https://github.com/exe-cuute/universalsearchlauncher

## Overview

Universal Search Launcher is a Windows desktop launcher: a global hotkey or tray action opens the UI, queries app/file/web providers, ranks and groups results, then launches the selected target and records usage. The graph preserves indexing, settings, persistence, fullscreen/hotkey behavior, tray, themes, and updates documented by the README. Edges are limited to README claims and source-index references or excerpts; unsampled integrations are omitted where their caller is not shown.

Main entry points: [`src/UniversalSearchLauncher/Services/SearchService.cs`](https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher/Services/SearchService.cs) (Search orchestration), [`src/UniversalSearchLauncher/ViewModels/LauncherViewModel.cs`](https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher/ViewModels/LauncherViewModel.cs) (Launcher view model), [`src/UniversalSearchLauncher/App.xaml.cs`](https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher/App.xaml.cs) (Application startup), [`src/UniversalSearchLauncher/Views/SettingsWindow.xaml.cs`](https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher/Views/SettingsWindow.xaml.cs) (Settings window)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Launcher UI"]
  node_window["Launcher window"]
  node_vm["Launcher view model"]
  node_resultvm["Result presentation"]
  node_settingswindow["Settings window"]
end

subgraph group_search["Search and indexing"]
  node_searchsvc["Search orchestration<br/>[SearchService.cs]"]
  node_appsearch["Application search<br/>[AppSearchEngine.cs]"]
  node_filesearch["File search"]
  node_fuzzy["Fuzzy matching<br/>[FuzzyMatcher.cs]"]
  node_intent["Query intent<br/>[QueryIntent.cs]"]
  node_appindex["Application index<br/>[AppIndexService.cs]"]
  node_fileindex["File index service"]
  node_scanner["Filesystem scanner"]
  node_exclusions["Index exclusions<br/>[ExclusionSet.cs]"]
end

subgraph group_state["Settings and state"]
  node_settings["Settings persistence<br/>[SettingsService.cs]"]
  node_storage[("SQLite storage<br/>[StorageService.cs]")]
  node_models["Search and domain models<br/>[SearchResult.cs]"]
  node_paths["User data paths<br/>[AppPaths.cs]"]
end

subgraph group_platform["Windows integration"]
  node_app["Application startup<br/>[App.xaml.cs]"]
  node_hotkey["Global hotkey<br/>[HotkeyService.cs]"]
  node_fullscreen["Fullscreen detection"]
  node_tray["System tray<br/>[TrayService.cs]"]
  node_shell["Windows shell launch<br/>[ShellService.cs]"]
  node_theme["Theme service<br/>[ThemeService.cs]"]
  node_updates["Update checking<br/>[UpdateService.cs]"]
  node_web(("Web search engine"))
end

node_user(("User"))

node_user -->|"opens or hides"| node_window
node_app -->|"creates"| node_vm
node_window -->|"uses"| node_vm
node_vm -->|"requests search"| node_searchsvc
node_searchsvc -->|"reads apps"| node_appindex
node_searchsvc -->|"searches files"| node_fileindex
node_searchsvc -->|"parses intent"| node_intent
node_searchsvc -->|"ranks apps"| node_appsearch
node_searchsvc -->|"merges file hits"| node_filesearch
node_searchsvc -->|"offers web search"| node_web
node_appsearch -->|"scores text"| node_fuzzy
node_filesearch -->|"scores text"| node_fuzzy
node_appindex -.->|"caches apps"| node_storage
node_fileindex -->|"builds index"| node_scanner
node_scanner -->|"filters paths"| node_exclusions
node_fileindex -->|"loads and saves"| node_storage
node_storage -->|"uses database path"| node_paths
node_settings -->|"loads settings path"| node_paths
node_settingswindow -->|"edits settings"| node_settings
node_settingswindow -->|"configures hotkey"| node_hotkey
node_settingswindow -->|"configures folders"| node_fileindex
node_vm -->|"creates results"| node_resultvm
node_vm -->|"records history"| node_storage
node_resultvm -->|"presents result"| node_models
node_vm -->|"opens selection"| node_shell
node_app -->|"starts service"| node_hotkey
node_window -->|"checks display mode"| node_fullscreen
node_app -->|"starts service"| node_tray
node_app -->|"initializes theme"| node_theme
node_app -->|"initializes updates"| node_updates
node_settingswindow -->|"checks updates"| node_updates
node_user -->|"chooses tray action"| node_tray
node_searchsvc -->|"returns snapshot"| node_models

click node_app "https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher/App.xaml.cs"
click node_window "https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher/Views/LauncherWindow.xaml.cs"
click node_vm "https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher/ViewModels/LauncherViewModel.cs"
click node_resultvm "https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher/ViewModels/ResultItemViewModel.cs"
click node_settingswindow "https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher/Views/SettingsWindow.xaml.cs"
click node_searchsvc "https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher/Services/SearchService.cs"
click node_appsearch "https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher.Core/Search/AppSearchEngine.cs"
click node_filesearch "https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher.Core/Search/FileSearchEngine.cs"
click node_fuzzy "https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher.Core/Search/FuzzyMatcher.cs"
click node_intent "https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher.Core/Search/QueryIntent.cs"
click node_appindex "https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher/Services/AppIndexService.cs"
click node_fileindex "https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher/Services/FileIndexService.cs"
click node_scanner "https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher.Core/Indexing/FileIndexScanner.cs"
click node_exclusions "https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher.Core/Indexing/ExclusionSet.cs"
click node_settings "https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher/Services/SettingsService.cs"
click node_storage "https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher/Services/StorageService.cs"
click node_models "https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher.Core/Models/SearchResult.cs"
click node_paths "https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher/Services/AppPaths.cs"
click node_hotkey "https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher/Services/HotkeyService.cs"
click node_fullscreen "https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher/Services/FullscreenDetector.cs"
click node_tray "https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher/Services/TrayService.cs"
click node_shell "https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher/Services/ShellService.cs"
click node_theme "https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher/Services/ThemeService.cs"
click node_updates "https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher/Services/UpdateService.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_window,node_vm,node_resultvm,node_settingswindow,node_user toneBlue
class node_searchsvc,node_appsearch,node_filesearch,node_fuzzy,node_intent,node_appindex,node_fileindex,node_scanner,node_exclusions toneAmber
class node_settings,node_storage,node_models,node_paths toneMint
class node_app,node_hotkey,node_fullscreen,node_tray,node_shell,node_theme,node_updates,node_web toneRose
```

## Components

### Launcher UI

- [Launcher window](https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher/Views/LauncherWindow.xaml.cs): `src/UniversalSearchLauncher/Views/LauncherWindow.xaml.cs`
- [Launcher view model](https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher/ViewModels/LauncherViewModel.cs): `src/UniversalSearchLauncher/ViewModels/LauncherViewModel.cs`
- [Result presentation](https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher/ViewModels/ResultItemViewModel.cs): `src/UniversalSearchLauncher/ViewModels/ResultItemViewModel.cs`
- [Settings window](https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher/Views/SettingsWindow.xaml.cs): `src/UniversalSearchLauncher/Views/SettingsWindow.xaml.cs`

### Search and indexing

- [Search orchestration](https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher/Services/SearchService.cs): `src/UniversalSearchLauncher/Services/SearchService.cs`
- [Application search](https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher.Core/Search/AppSearchEngine.cs): `src/UniversalSearchLauncher.Core/Search/AppSearchEngine.cs`
- [File search](https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher.Core/Search/FileSearchEngine.cs): `src/UniversalSearchLauncher.Core/Search/FileSearchEngine.cs`
- [Fuzzy matching](https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher.Core/Search/FuzzyMatcher.cs): `src/UniversalSearchLauncher.Core/Search/FuzzyMatcher.cs`
- [Query intent](https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher.Core/Search/QueryIntent.cs): `src/UniversalSearchLauncher.Core/Search/QueryIntent.cs`
- [Application index](https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher/Services/AppIndexService.cs): `src/UniversalSearchLauncher/Services/AppIndexService.cs`
- [File index service](https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher/Services/FileIndexService.cs): `src/UniversalSearchLauncher/Services/FileIndexService.cs`
- [Filesystem scanner](https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher.Core/Indexing/FileIndexScanner.cs): `src/UniversalSearchLauncher.Core/Indexing/FileIndexScanner.cs`
- [Index exclusions](https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher.Core/Indexing/ExclusionSet.cs): `src/UniversalSearchLauncher.Core/Indexing/ExclusionSet.cs`

### Settings and state

- [Settings persistence](https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher/Services/SettingsService.cs): `src/UniversalSearchLauncher/Services/SettingsService.cs`
- [SQLite storage](https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher/Services/StorageService.cs): `src/UniversalSearchLauncher/Services/StorageService.cs`
- [Search and domain models](https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher.Core/Models/SearchResult.cs): `src/UniversalSearchLauncher.Core/Models/SearchResult.cs`
- [User data paths](https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher/Services/AppPaths.cs): `src/UniversalSearchLauncher/Services/AppPaths.cs`

### Windows integration

- [Application startup](https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher/App.xaml.cs): `src/UniversalSearchLauncher/App.xaml.cs`
- [Global hotkey](https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher/Services/HotkeyService.cs): `src/UniversalSearchLauncher/Services/HotkeyService.cs`
- [Fullscreen detection](https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher/Services/FullscreenDetector.cs): `src/UniversalSearchLauncher/Services/FullscreenDetector.cs`
- [System tray](https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher/Services/TrayService.cs): `src/UniversalSearchLauncher/Services/TrayService.cs`
- [Windows shell launch](https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher/Services/ShellService.cs): `src/UniversalSearchLauncher/Services/ShellService.cs`
- [Theme service](https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher/Services/ThemeService.cs): `src/UniversalSearchLauncher/Services/ThemeService.cs`
- [Update checking](https://github.com/exe-cuute/universalsearchlauncher/blob/master/src/UniversalSearchLauncher/Services/UpdateService.cs): `src/UniversalSearchLauncher/Services/UpdateService.cs`
- **Web search engine**

### Other components

- **User**

## Connections

- User → Launcher window: opens or hides (evidence: `README.md`)
- Application startup → Launcher view model: creates (evidence: `src/UniversalSearchLauncher/App.xaml.cs`)
- Launcher window → Launcher view model: uses (evidence: `src/UniversalSearchLauncher/Views/LauncherWindow.xaml.cs`)
- Launcher view model → Search orchestration: requests search (evidence: `src/UniversalSearchLauncher/ViewModels/LauncherViewModel.cs`)
- Search orchestration → Application index: reads apps (evidence: `src/UniversalSearchLauncher/Services/SearchService.cs`)
- Search orchestration → File index service: searches files (evidence: `src/UniversalSearchLauncher/Services/SearchService.cs`)
- Search orchestration → Query intent: parses intent (evidence: `src/UniversalSearchLauncher/Services/SearchService.cs`)
- Search orchestration → Application search: ranks apps (evidence: `src/UniversalSearchLauncher/Services/SearchService.cs`)
- Search orchestration → File search: merges file hits
- Search orchestration → Web search engine: offers web search (evidence: `README.md`)
- Application search → Fuzzy matching: scores text (evidence: `src/UniversalSearchLauncher.Core/Search/AppSearchEngine.cs`)
- File search → Fuzzy matching: scores text (evidence: `src/UniversalSearchLauncher.Core/Search/FileSearchEngine.cs`)
- Application index → SQLite storage: caches apps
- File index service → Filesystem scanner: builds index (evidence: `src/UniversalSearchLauncher/Services/FileIndexService.cs`)
- Filesystem scanner → Index exclusions: filters paths (evidence: `src/UniversalSearchLauncher.Core/Indexing/FileIndexScanner.cs`)
- File index service → SQLite storage: loads and saves (evidence: `src/UniversalSearchLauncher/Services/FileIndexService.cs`)
- SQLite storage → User data paths: uses database path (evidence: `src/UniversalSearchLauncher/Services/StorageService.cs`)
- Settings persistence → User data paths: loads settings path (evidence: `src/UniversalSearchLauncher/Services/SettingsService.cs`)
- Settings window → Settings persistence: edits settings (evidence: `src/UniversalSearchLauncher/Views/SettingsWindow.xaml.cs`)
- Settings window → Global hotkey: configures hotkey (evidence: `src/UniversalSearchLauncher/Views/SettingsWindow.xaml.cs`)
- Settings window → File index service: configures folders (evidence: `src/UniversalSearchLauncher/Views/SettingsWindow.xaml.cs`)
- Launcher view model → Result presentation: creates results (evidence: `src/UniversalSearchLauncher/ViewModels/LauncherViewModel.cs`)
- Launcher view model → SQLite storage: records history (evidence: `src/UniversalSearchLauncher/ViewModels/LauncherViewModel.cs`)
- Result presentation → Search and domain models: presents result (evidence: `src/UniversalSearchLauncher/ViewModels/ResultItemViewModel.cs`)
- Launcher view model → Windows shell launch: opens selection (evidence: `src/UniversalSearchLauncher/ViewModels/LauncherViewModel.cs`)
- Application startup → Global hotkey: starts service (evidence: `src/UniversalSearchLauncher/App.xaml.cs`)
- Launcher window → Fullscreen detection: checks display mode (evidence: `src/UniversalSearchLauncher/Views/LauncherWindow.xaml.cs`)
- Application startup → System tray: starts service (evidence: `src/UniversalSearchLauncher/App.xaml.cs`)
- Application startup → Theme service: initializes theme (evidence: `src/UniversalSearchLauncher/App.xaml.cs`)
- Application startup → Update checking: initializes updates (evidence: `src/UniversalSearchLauncher/App.xaml.cs`)
- Settings window → Update checking: checks updates (evidence: `src/UniversalSearchLauncher/Views/SettingsWindow.xaml.cs`)
- User → System tray: chooses tray action (evidence: `README.md`)
- Search orchestration → Search and domain models: returns snapshot (evidence: `src/UniversalSearchLauncher/Services/SearchService.cs`)
