PowerToys/doc/devdocs/runner.md

3.5 KiB

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.