How alztrk/opentaskbar works
OpenTaskbar replaces the Windows taskbar with a configurable floating dock, while also hosting widgets, window previews, and shell integrations. The main workflow starts at application launch, loads preferences and theme resources, then presents the dock and coordinates its interactions with Windows. Settings, widgets, window management, and taskbar recovery are distinct product areas. Some feature branches are documented in the README but their implementation files were not sampled, so those links cite the README; unsampled internal call paths are not inferred.
Main entry points: MainWindow.xaml.cs Main dock window · App.xaml.cs Application startup · ApplicationPreferences.cs Preferences · TaskbarReplacementSession.cs Taskbar replacement
Components 22
Dock experience
- Application startup
App.xaml.cs - Main dock window
Views/Windows/MainWindow.xaml.cs - Secondary docks
Views/Windows/SecondaryDockWindow.cs
Widget system
- Widget coordinator
Widgets/WidgetCoordinator.cs - Widget catalog and data
Widgets/DockWidgetService.cs - Widget implementations
Widgets - Widget panels
Views/Widgets/WidgetPanelHost.cs
Window and shell integration
- Window tracking
Services/Interop/NativeWindowTracker.cs - Window previews
Services/Interop/WindowThumbnailPreview.cs - Auto-hide controller
Services/App/DockAutoHideController.cs - Windows shell integration
Services/Interop/ShellShortcuts.cs - Search widget
Widgets/SearchWidget.cs
Settings and appearance
- Settings window
Views/Windows/SettingsWindow.xaml.cs - Preferences
Services/Settings/ApplicationPreferences.cs - Settings store
Services/Settings/DockSettingsStore.cs - Theme packs
Services/App/ThemePacks.cs - Theme rendering
Services/Settings/ThemeManager.cs - Localization
Services/Localization/UiText.cs
Taskbar recovery
- Taskbar replacement
Services/Interop/TaskbarReplacementSession.cs - Crash watchdog
Services/App/TaskbarRecoveryWatchdog.cs
Other components
- User
- Windows
Connections 24
- User → Application startup: starts
README.md - Application startup → Main dock window: opens
App.xaml.cs - Application startup → Preferences: loads
App.xaml.cs - Application startup → Taskbar replacement: heals recovery
App.xaml.cs - Main dock window → Settings window: opens
- Preferences → Settings store: persists
Services/Settings/ApplicationPreferences.cs - Main dock window → Widget coordinator: coordinates
Views/Windows/MainWindow.xaml.cs - Main dock window → Widget catalog and data: uses
Views/Windows/MainWindow.xaml.cs - Main dock window → Widget panels: hosts
Views/Windows/MainWindow.xaml.cs - Widget coordinator → Widget implementations: coordinates
Widgets/WidgetCoordinator.cs - Widget catalog and data → Windows: reads system data
Widgets/DockWidgetService.cs - Main dock window → Window tracking: tracks windows
Views/Windows/MainWindow.xaml.cs - Main dock window → Window previews: shows previews
Views/Windows/MainWindow.xaml.cs - Main dock window → Auto-hide controller: controls visibility
Views/Windows/MainWindow.xaml.cs - Main dock window → Taskbar replacement: replaces taskbar
Views/Windows/MainWindow.xaml.cs - Main dock window → Theme packs: loads themes
Views/Windows/MainWindow.xaml.cs - Theme packs → Theme rendering: applies theme
Services/App/ThemePacks.cs - Search widget → Windows shell integration: opens search
Widgets/SearchWidget.cs - Main dock window → Secondary docks: supports multi-monitor
README.md - Main dock window → Windows: integrates shell features
README.md - Taskbar replacement → Crash watchdog: registers recovery
Services/Interop/TaskbarReplacementSession.cs - Crash watchdog → Windows: restores taskbar
README.md - Settings window → Preferences: edits preferences
- Main dock window → Localization: localizes interface
Views/Windows/MainWindow.xaml.cs