Skip to content

Commit 26d0010

Browse files
committed
Adding FancyZones CLI
1 parent af76bc2 commit 26d0010

1 file changed

Lines changed: 40 additions & 0 deletions

File tree

hub/powertoys/fancyzones.md

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -177,4 +177,44 @@ In the demo below, we start with a default template applied to the screen and tw
177177

178178
![FancyZones Settings bottom screenshot](../images/pt-fancyzones-settings2.png)
179179

180+
## Manage FancyZones from the Command Line
181+
182+
The FancyZones CLI lets you apply and manage window layouts directly from the command line.
183+
184+
**Key capabilities:**
185+
- ASCII art visualization of layouts (grid, focus, priority-grid, canvas)
186+
- Support for both template layouts and custom layouts
187+
- Monitor-specific layout targeting (`--monitor N` or `--all`)
188+
- Real-time notification to FancyZones via Windows messages
189+
- Native AOT compilation support for fast startup
190+
191+
**Commands:**
192+
| Command | Aliases | Description |
193+
|---------|---------|-------------|
194+
| `help` | | Displays general help information for all commands |
195+
| `open-editor` | `editor`, `e` | Launch FancyZones layout editor |
196+
| `get-monitors` | `monitors`, `m` | List all monitors and their properties |
197+
| `get-layouts` | `layouts`, `ls` | List all available layouts with ASCII art preview |
198+
| `get-active-layout` | `active`, `a` | Show currently active layout |
199+
| `set-layout <uuid>` | `set`, `s` | Apply layout by UUID or template name |
200+
| `open-settings` | `settings` | Open FancyZones settings page |
201+
| `get-hotkeys` | `hotkeys`, `hk` | List all layout hotkeys |
202+
| `set-hotkey <key> <uuid>` | `shk` | Assign hotkey (0-9) to custom layout |
203+
| `remove-hotkey <key>` | `rhk` | Remove hotkey assignment |
204+
205+
**Usage example**
206+
```bash
207+
# List all layouts with visual previews
208+
FancyZonesCLI.exe ls
209+
210+
# Apply "columns" template to all monitors
211+
FancyZonesCLI.exe s columns --all
212+
213+
# Set custom layout on monitor 2
214+
FancyZonesCLI.exe s {uuid} --monitor 2
215+
216+
# Assign hotkey Win+Ctrl+Alt+3 to a layout
217+
FancyZonesCLI.exe shk 3 {uuid}
218+
```
219+
180220
[!INCLUDE [install-powertoys.md](../includes/install-powertoys.md)]

0 commit comments

Comments
 (0)