Skip to content

Commit 50348e0

Browse files
authored
Merge pull request MicrosoftDocs#3247 from MicrosoftDocs/main638083731536351068sync_temp
For protected CLA branch, push strategy should use PR and merge to target branch method to work around git push error
2 parents a80d68c + cbfa9e9 commit 50348e0

File tree

1 file changed

+22
-22
lines changed

1 file changed

+22
-22
lines changed

hub/powertoys/powerrename.md

Lines changed: 22 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: PowerToys PowerRename utility for Windows
33
description: A windows shell extension for bulk renaming of files
4-
ms.date: 04/27/2022
4+
ms.date: 12/22/2022
55
ms.topic: article
66
ms.localizationpriority: medium
77
no-loc: [PowerRename, Windows, File Explorer, regex]
@@ -25,7 +25,7 @@ In this demo, all instances of the file name "foo" are replaced with "foobar". S
2525

2626
## PowerRename window
2727

28-
After selecting files in Windows File Explorer, right-clicking and selecting **PowerRename** (which will appear only when enabled in PowerToys), the PowerRename window will appear. The number of items you've selected will be displayed, along with search and replace values, a list of options, and a preview window displaying results of the search and replace values you've entered.
28+
After selecting files in Windows File Explorer, right-clicking and selecting **PowerRename** (which will appear only if enabled in PowerToys), the PowerRename window will appear. The number of items you've selected will be displayed, along with search and replace values, a list of options, and a preview window displaying results of the search and replace values you've entered.
2929

3030
![PowerRename Menu screenshot.](../images/powerrename-menu.png)
3131

@@ -37,7 +37,7 @@ Enter text or a [regular expression](https://wikipedia.org/wiki/Regular_expressi
3737

3838
Enter text to replace the _Search for_ value entered previously. You can view the original file name and renamed file name in the _Preview_ window.
3939

40-
### Use Regular Expressions
40+
### Use regular expressions
4141

4242
If checked, the Search value will be interpreted as a [regular expression](https://wikipedia.org/wiki/Regular_expression) (regex). The Replace value can also contain regex variables (see [examples below](#regular-expressions)). If not checked, the Search value will be interpreted as plain text to be replaced with the text in the Replace field.
4343

@@ -54,40 +54,40 @@ For example, given the file name: `powertoys-powerrename.txt`:
5454

5555
The value of the renamed file would result in:
5656

57-
- Match all occurrences (unchecked): `supertoys-powerrename.txt`
58-
- Match all occurrences (checked): `supertoys-superrename.txt`
57+
- Match all occurrences unchecked: `supertoys-powerrename.txt`
58+
- Match all occurrences checked: `supertoys-superrename.txt`
5959

60-
### Case Sensitive
60+
### Case sensitive
6161

62-
If checked, the text specified in the Search field will only match text in the items if the text is the same case. Case matching will be insensitive (not recognizing a difference between upper and lowercase letters) by default.
62+
If checked, the text specified in the _Search_ field will only match text in the items if the text is the same case. Case matching will be insensitive (not recognizing a difference between upper and lowercase letters) by default.
6363

6464
### Apply to: Filename only
6565

66-
Only the file name (not the file extension) is modified by the operation. For example: `txt.txt``NewName.txt`
66+
Only the file name (not the file extension) is modified by the operation. For example: `txt.txt``NewName.txt`.
6767

6868
### Apply to: Extension only
6969

70-
Only the file extension is modified by the operation. For example: `txt.txt``txt.NewExtension`
70+
Only the file extension is modified by the operation. For example: `txt.txt``txt.NewExtension`.
7171

72-
### Include Files
72+
### Include files
7373

7474
Deselecting causes files to not be included in the operation.
7575

76-
### Include Folders
76+
### Include folders
7777

7878
Deselecting causes folders to not be included in the operation.
7979

80-
### Include Subfolders
80+
### Include subfolders
8181

8282
Deselecting causes files within folders to not be included in the operation. By default, all subfolder items are included.
8383

84-
### Text Formatting
84+
### Text formatting
8585

8686
Select between four options to either convert items to be all lowercase, all uppercase, title case (first character of name is capitalized), or capitalize each word.
8787

88-
### Enumerate Items
88+
### Enumerate items
8989

90-
Appends a numeric suffix to file names that were modified in the operation. For example: `foo.jpg` -> `foo (1).jpg`
90+
Appends a numeric suffix to file names that were modified in the operation. For example: `foo.jpg` `foo (1).jpg`
9191

9292
## Replace using file creation date and time
9393

@@ -131,7 +131,7 @@ The value of the renamed file would result in:
131131
- `Nov-02-20-powertoys.png`
132132
- `Nov-03-20-powertoys-menu.png`
133133

134-
## Regular Expressions
134+
## Regular expressions
135135

136136
For most use cases, a simple search and replace is sufficient. There may be occasions, however, in which complicated renaming tasks require more control. [Regular Expressions](https://wikipedia.org/wiki/Regular_expression) can help.
137137

@@ -167,7 +167,7 @@ _When using the variables, the "Match all occurrences" option must be enabled._
167167
| `(.*).png` | `foo_$1.png` | Prepends "foo\_" to the existing file name for PNG files |
168168
| `(.*).png` | `$1_foo.png` | Appends "\_foo" to the existing file name for PNG files |
169169
| `(.*)` | `$1.txt` | Appends ".txt" extension to existing file |
170-
| `(^\w+\.$)¦(^\w+$)` | `$2.txt` | Appends ".txt" extension to existing file name only if it does not have an extension |
170+
| `(^\w+\.$)\|(^\w+$)` | `$2.txt` | Appends ".txt" extension to existing file name only if it does not have an extension |
171171
| `(\d\d)-(\d\d)-(\d\d\d\d)` or `(\d{2})-(\d{2})-(\d{4})` | `$3-$2-$1` | Move numbers in the filename: "29-03-2020" becomes "2020-03-29" |
172172
| `^(.{n})(.*)` or `(.*)(.{n})$` | `$1foo$2` | Insert "foo" _n_ characters from the beginning or the end, respectively |
173173
| `^.{n}` or `.{n}$` | nothing | Trim _n_ characters from the beginning or the end, respectively |
@@ -180,23 +180,23 @@ There are great examples/cheatsheets available online to help you:
180180

181181
[ECMAScript Regular Expressions Tutorial](https://o7planning.org/en/12219/ecmascript-regular-expressions-tutorial)
182182

183-
## File List Filters
183+
## File list filters
184184

185185
Filters can be used in PowerRename to narrow the results of the rename. Use the _Preview_ window to check expected results. Click the column headers to switch between filters.
186186

187187
- **Original**, the first column in the _Preview_ window switches between:
188-
- Checked: The file is selected to be renamed.
189-
- Unchecked: The file is not selected to be renamed (even though it fits the value entered in the search criteria).
188+
- Checked: The file is selected to be renamed
189+
- Unchecked: The file is not selected to be renamed (even though it fits the value entered in the search criteria)
190190

191-
- **Renamed**, the second column in the _Preview_ window can be toggled.
191+
- **Renamed**, the second column in the _Preview_ window can be toggled:
192192
- The default preview will show all selected files, with only files matching the _Search for_ criteria displaying the updated rename value.
193193
- Selecting the _Renamed_ header will toggle the preview to only display files that will be renamed. Other selected files from your original selection will not be visible.
194194

195195
![PowerToys PowerRename Filter demo.](../images/powerrename-demo2.gif)
196196

197197
## Settings
198198

199-
Additional options can be configured from the PowerRename tab in the Settings menu as described below:
199+
Additional options can be configured from the PowerRename tab in the Settings, as described below:
200200

201201
| Setting | Description |
202202
| :--- | :--- |

0 commit comments

Comments
 (0)