Skip to content

Commit a7019f8

Browse files
niels9001niels9001
committed
More CLI docs
1 parent 26d0010 commit a7019f8

3 files changed

Lines changed: 73 additions & 10 deletions

File tree

‎hub/powertoys/fancyzones.md‎

Lines changed: 3 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -177,18 +177,11 @@ 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
180+
## Manage FancyZones from the command line
181181

182182
The FancyZones CLI lets you apply and manage window layouts directly from the command line.
183183

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:**
184+
**Commands**
192185
| Command | Aliases | Description |
193186
|---------|---------|-------------|
194187
| `help` | | Displays general help information for all commands |
@@ -203,7 +196,7 @@ The FancyZones CLI lets you apply and manage window layouts directly from the co
203196
| `remove-hotkey <key>` | `rhk` | Remove hotkey assignment |
204197

205198
**Usage example**
206-
```bash
199+
```powershell
207200
# List all layouts with visual previews
208201
FancyZonesCLI.exe ls
209202

‎hub/powertoys/file-locksmith.md‎

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,4 +25,32 @@ When File Locksmith is opened, it will scan all of the running processes that it
2525

2626
After scanning, a list of processes will be displayed. Select **End task** to terminate the process, or select the expander to show more information. File Locksmith will automatically remove terminated processes from the list, whether or not this action was done via File Locksmith. To manually refresh the list of processes, select **Reload**.
2727

28+
## Manage File Locksmith from the command line
29+
30+
The File Locksmith CLI lets you identify and manage processes that are locking files from the command line.
31+
32+
**Commands**
33+
| Command | Description |
34+
| :--- | :--- | :--- |
35+
| `<path>` | **Required**. One or more file or directory paths to check. You can specify multiple paths separated by spaces. |
36+
| `--kill` | Terminates (kills) all processes that are currently locking the specified files. |
37+
| `--json` | Outputs the results in structured **JSON** format instead of human-readable text. Useful for automation and scripts. |
38+
| `--wait` | **Blocks execution** and waits until the specified files are released. The command will not exit until the files are unlocked. |
39+
| `--help` | Displays the help message with usage instructions. |
40+
41+
**Usage example**
42+
```powershell
43+
# Check which processes are locking a specific file:
44+
FileLocksmithCLI.exe "C:\Users\Docs\report.docx"
45+
46+
# Check multiple files and get the output in JSON format for parsing:
47+
FileLocksmithCLI.exe --json "C:\File1.txt" "C:\Folder\File2.dll"
48+
49+
# Block script execution until a file is released (useful in build scripts):
50+
FileLocksmithCLI.exe --wait "C:\bin\output.exe"
51+
52+
# Kill all processes that are locking a specific file:
53+
FileLocksmithCLI.exe --kill "C:\LockedFile.dat"
54+
```
55+
2856
[!INCLUDE [install-powertoys.md](../includes/install-powertoys.md)]

‎hub/powertoys/image-resizer.md‎

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -65,4 +65,46 @@ You can specify a directory in the filename format to group resized images into
6565

6666
You can choose to retain the original *last modified* date on the resized image or reset it at the time of the resizing action.
6767

68+
## Manage Image Resizer from the command line
69+
70+
The Image Resizer CLI lets you resize one or more images from the command line.
71+
72+
**Commands:**
73+
| Command | Aliases | Description |
74+
|--------|---------|-------------|
75+
| `--help` | | Show help |
76+
| `--show-config` | | Print current effective configuration |
77+
| `--destination` | `-d` | Output directory (optional) |
78+
| `--width` | `-w` | Width |
79+
| `--height` | `-h` | Height |
80+
| `--unit` | `-u` | Unit (Pixel / Percent / Inch / Centimeter) |
81+
| `--fit` | `-f` | Fit mode (Fill / Fit / Stretch) |
82+
| `--size` | `-s` | Preset size index (supports `0` for Custom) |
83+
| `--shrink-only` | | Only shrink (do not enlarge) |
84+
| `--replace` | | Replace original |
85+
| `--ignore-orientation` | | Ignore EXIF orientation |
86+
| `--remove-metadata` | | Strip metadata |
87+
| `--quality` | `-q` | JPEG quality (1–100) |
88+
| `--keep-date-modified` | | Preserve source last-write time |
89+
| `--file-name` | | Output filename format |
90+
91+
92+
**Usage example**
93+
```powershell
94+
# Show help
95+
PowerToys.ImageResizerCLI.exe --help
96+
97+
# Show current config
98+
PowerToys.ImageResizerCLI.exe --show-config
99+
100+
# Resize with explicit dimensions
101+
PowerToys.ImageResizerCLI.exe --width 800 --height 600 .\image.png
102+
103+
# Use preset size 0 (Custom) and output to a folder
104+
PowerToys.ImageResizerCLI.exe --size 0 -d "C:\Output" .\photo.png
105+
106+
# Preserve source LastWriteTime
107+
PowerToys.ImageResizerCLI.exe --width 800 --height 600 --keep-date-modified -d "C:\Output" .\image.png
108+
```
109+
68110
[!INCLUDE [install-powertoys.md](../includes/install-powertoys.md)]

0 commit comments

Comments
 (0)