How zhugecaomao/altrun works
ALTRun is a Windows launcher centered on an Alt+Space search window: a user query is matched against registered providers, results are ranked, and the selected result is executed or acted on. The map also preserves documented file search, clipboard, snippets, system commands, settings, and extensions. The README identifies module responsibilities and the startup entry point; sampled source did not include runtime modules, so uncertain call wiring is omitted.
Main entry points: ProviderRegistry.ahk Provider registry · SearchWindow.ahk Search window · App.ahk App lifecycle · FileSearchProvider.ahk File search
Components 31
Launcher and UI
- Startup entry
ALTRun.ahk - App lifecycle
Src/Core/App.ahk - Search window
Src/UI/SearchWindow.ahk - Preferences UI
Src/UI/PreferencesWindow.ahk - Themes
Src/UI/ThemeManager.ahk
Search and ranking
- Query model
Src/Core/SearchQuery.ahk - Provider registry
Src/Core/ProviderRegistry.ahk - Fuzzy matching
Src/Core/FuzzyMatcher.ahk - Result model
Src/Core/ResultItem.ahk - Action catalog
Src/Core/ActionCatalog.ahk - Local file index
Src/Core/FileIndex.ahk
Search providers
- Application search
Src/Providers/ApplicationProvider.ahk - File search
Src/Providers/FileSearchProvider.ahk - Calculator
Src/Providers/CalculatorProvider.ahk - Web search
Src/Providers/WebSearchProvider.ahk - Clipboard history
Src/Providers/ClipboardProvider.ahk - System commands
Src/Providers/SystemProvider.ahk - Commands and snippets
Src/Providers - Terminal commands
Src/Providers/TerminalProvider.ahk
Settings and usage
- Usage learning
Src/Core/Usage.ahk - App settings
Src/Core/AppSettings.ahk - Theme definitions
Resources/Themes
Extensions
- Selection actions
Src/Extensions/SelectionActions.ahk - Snippet expansion
Src/Extensions/SnippetExpander.ahk - Dialog navigation
Src/Extensions - PT toolbox
Src/Extensions/PTToolsWindow.ahk - Auto date
Src/Extensions/AutoDate.ahk - Update checker
Src/Extensions/UpdateChecker.ahk
Other components
- User
- Everything search
- GitHub releases
Connections 30
- User → Startup entry: launches
- Startup entry → App lifecycle: starts
- User → Search window: enters query
- Search window → Query model: parses input
- Search window → Provider registry: requests results
- Provider registry → Application search: dispatches search
- Provider registry → File search: dispatches search
- Provider registry → Calculator: dispatches search
- Provider registry → Web search: dispatches search
- Provider registry → Clipboard history: dispatches search
- Provider registry → System commands: dispatches search
- Provider registry → Commands and snippets: dispatches search
- Provider registry → Terminal commands: dispatches search
- File search → Local file index: queries index
- File search → Everything search: queries when available
- Provider registry → Fuzzy matching: ranks matches
- Provider registry → Result model: returns results
- Search window → Result model: displays results
- Search window → Action catalog: requests actions
- Search window → Usage learning: records selection
- App lifecycle → App settings: loads settings
- Preferences UI → App settings: edits settings
- Themes → Theme definitions: loads themes
- Search window → Selection actions: invokes selection tools
- Commands and snippets → Snippet expansion: supports expansion
- App lifecycle → Dialog navigation: enables extensions
- App lifecycle → PT toolbox: enables toolbox
- App lifecycle → Auto date: enables extension
- App lifecycle → Update checker: checks updates
- Update checker → GitHub releases: checks releases