Activation
PowerToys Run must be enabled in PowerToys Settings for the activation shortcut to work.
Core Features
Global and Direct Query Modes
PowerToys Run supports two query modes:- Global Query
- Direct Query
Search across all enabled plugins without using action keywords:Results from all plugins (Programs, Folder, Indexer) are combined.
Search Position Options
Window Positioning
Window Positioning
Configure where PowerToys Run appears on screen:
- Primary Monitor: Always appears on the primary display
- Cursor Position: Appears on the monitor containing the mouse cursor
- Focus: Appears on the monitor with the currently focused window
Search Performance
Search Input Delay Settings
Search Input Delay Settings
PowerToys Run implements throttled search for better performance:
- Fast results delay: Default 150ms - shows quick results from lightweight plugins
- Full results delay: Default 300ms - executes all plugin queries including slower ones
- Disable delay: Set “Search query results with delay” to off for instant search
/src/modules/launcher/PowerLauncher/MainWindow.xaml.cs:273-277:Built-in Plugins
PowerToys Run includes 20 built-in plugins. Each can be enabled/disabled independently.Calculator Plugin
Action Keyword
=Global Query
Enabled
Calculator Features
Calculator Features
- Supports basic arithmetic, trigonometric functions, logarithms
- Hexadecimal (
0x) and binary (0b) number formats - Trigonometry modes: Radians (default), Degrees, Gradians
- Constants:
pi,e - Input/output format options (English vs. locale-specific)
- Replace input mode: Type
=at end to replace query with result
CEA0FDFC6D3B4085823D60DC76F28855Program Plugin
Action Keyword
.Global Query
Enabled
791FC278BA414111B8D1886DFE447410
Window Walker Plugin
Action Keyword
<Global Query
Enabled
F737A9223560B3C6833B5FFB8CDF78E5
Shell Plugin
Execute shell commands directly. Examples:Folder & Indexer Plugins
Search for files and folders using Windows Search index. Examples:URI Plugin
Open URLs and URIs directly. Examples:Unit Converter Plugin
Convert between units of measurement. Examples:Value Generator Plugin
Generate UUIDs, GUIDs, hashes, and base64 encoding. Examples:VS Code Workspaces Plugin
Quickly open VS Code workspaces and remote SSH connections.System Plugin
Execute system commands. Examples:Time & Date Plugin
Display current time, convert timestamps, and manage timezones. Examples:Windows Settings Plugin
Quickly access Windows Settings pages. Examples:Windows Terminal Plugin
Open Windows Terminal profiles directly.History Plugin
View and re-execute previous PowerToys Run queries.Registry Plugin
Navigate to registry keys. Examples:Service Plugin
Search and manage Windows services. Examples:OneNote Plugin
Search and open OneNote notebooks and pages.PowerToys Plugin
Quickly access PowerToys utilities and settings.Web Search Plugin
Search the web using configured search engines.Advanced Features
Context Menu Actions
- Keyboard
- Mouse
Use arrow keys to navigate results:
↑↓Navigate results←→Navigate context menu actionsEnterExecute selected actionTabCycle through results
File Drag & Drop
File Drag & Drop
PowerToys Run supports dragging file results to other applications. From source code (
MainWindow.xaml.cs:349-378):- Detects
IFileDropResultcontext data - Creates drag data object with file path
- Generates thumbnail as drag image
- Supports standard drag-drop operations
Auto-Complete
PowerToys Run shows auto-complete suggestions based on the selected result. The gray text after your query indicates the full match.Plugin Overview
When PowerToys Run opens with an empty query, it displays an overview of available plugins with their action keywords.Configuration
Global Settings
Per-Plugin Settings
Each plugin can be:- Enabled or disabled
- Configured with custom action keywords
- Set to global mode or direct query only
- Given plugin-specific settings (varies by plugin)
Keyboard Shortcuts
| Shortcut | Action |
|---|---|
Alt + Space | Open/Close PowerToys Run (default) |
Esc | Close PowerToys Run |
↑ ↓ | Navigate results |
← → | Navigate context menu |
Enter | Execute selected result |
Tab / Shift + Tab | Cycle through results |
Page Up / Page Down | Jump through results |
Ctrl + C | Copy result (when supported) |
Ctrl + Shift + Enter | Run as administrator (when supported) |
Backspace (hold) | Clear input |
Use Cases
Quick Calculations
Quick Calculations
Use PowerToys Run as a calculator without opening a separate app:
- Convert units:
100 usd to eur - Calculate tips:
= 45.50 * 0.18 - Hexadecimal:
= 0xFF + 256
Developer Workflows
Developer Workflows
- Generate UUIDs for code
- Encode/decode base64 strings
- Open project folders quickly
- Launch VS Code workspaces
- Open terminal profiles
System Administration
System Administration
- Manage Windows services
- Execute shell commands
- Navigate registry
- Access Windows Settings
- Lock, shutdown, restart
Window Management
Window Management
- Switch between open windows by name
- Find windows across virtual desktops
- Access applications by typing partial names
Performance Optimization
Telemetry
PowerToys Run collects anonymous usage telemetry:- Activation count and timing (cold/warm state)
- Plugin enabled/disabled state
- First delete event (to measure discoverability)
MainWindow.xaml.cs:100-121, MainWindow.xaml.cs:806-814.
Source Code
Location:/src/modules/launcher/
- Main window:
PowerLauncher/MainWindow.xaml.cs - Plugin manager: Plugin system in
/launcher/Plugins/ - View model:
ViewModel/MainViewModel.cs