runner.md

main.cpp

Contains the executable starting point, initialization code and the list of known PowerToys. All singletons are also initialized here at the start. Loads all the powertoys by scanning the ./modules folder and enable()s those marked as enabled in %LOCALAPPDATA%\Microsoft\PowerToys\settings.json config. Then it runs a message loop for the tray UI. Note that this message loop also handles lowlevel_keyboard_hook events.

powertoy_module.h and powertoy_module.cpp

Contains code for initializing and managing the PowerToy modules. PowertoyModule is a RAII-style holder for the PowertoyModuleIface pointer, which we got by invoking module DLL's powertoy_create function.

tray_icon.cpp

Contains code for managing the PowerToys tray icon and its menu commands. Note that dispatch_run_on_main_ui_thread is used to transfer received json message from the Settings window to the main thread, since we're communicating with it from a dedicated thread.

settings_window.cpp

Contains code for starting the PowerToys settings window and communicating with it. Settings window is a separate process, so we're using Windows pipes as a transport for json messages.

general_settings.cpp

Contains code for loading, saving and applying the general settings.

auto_start_helper.cpp

Contains helper code for registering and unregistering PowerToys to run when the user logs in.

unhandled_exception_handler.cpp

Contains helper code to get stack traces in builds. Can be used by adding a call to init_global_error_handlers in WinMain.

trace.cpp

Contains code for telemetry.

svgs

Contains the SVG assets used by the PowerToys modules.

bug_report.cpp

Contains logic to start bug report tool.

centralized_hotkeys.cpp

Contains hot key logic registration and un-registration.

centralized_kb_hook.cpp

Contains logic to handle PowerToys' keyboard shortcut functionality.

restart_elevated.cpp

Contains logic for restarting the current process with different elevation levels.

RestartManagement.cpp

Contains code for restarting a process.

settings_telemetry.cpp

Contains logic that periodically triggers module-specific setting's telemetry delivery and manages timing and error handling for the process.

UpdateUtils.cpp

Contains code to handle the automatic update checking, notification, and installation process for PowerToys.