Skip to content

Commit c1fbff9

Browse files
authored
Update docs for ValueGenerator plugin
1 parent ac1c978 commit c1fbff9

File tree

1 file changed

+20
-9
lines changed

1 file changed

+20
-9
lines changed

hub/powertoys/run.md

Lines changed: 20 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -91,7 +91,7 @@ The plugins can be activated with a direct activation command so that PowerToys
9191
| Time and date| `)` | `) time and date` shows the current time and date in different formats.<br />`) calendar week::04/01/2022` shows the calendar week for the date '04/01/2022'. |
9292
| Time zones | `&` | `& Newfoundland` shows the current time in the time zone of Newfoundland. |
9393
| Unit converter | `%%` | `%% 10 ft in m` to calculate the number of meters in 10 feet. |
94-
| Value Generator | `#` | `# guid3 ns:URL www.microsoft.com` to generate the GUIDv3 for the URL namespace using the URL namespace. <br />`# sha1 abc` to calculate the SHA1 hash for the string 'abc'. |
94+
| Value Generator | `#` | `# guid3 ns:URL www.microsoft.com` to generate the GUIDv3 for the URL namespace using the URL namespace. <br />`# sha1 abc` to calculate the SHA1 hash for the string 'abc'. <br />`# base64 abc` to encode the string 'abc' to base64. |
9595
| URI-handler | `//` | `//` to launch your default browser.<br />`// learn.microsoft.com` to have your default browser go to Microsoft Learn.<br />`mailto:` and `ms-settings:` links are supported. |
9696
| Visual Studio Code | `{` | `{ powertoys` to search for previously opened workspaces, remote machines and containers that contain 'powertoys' in their paths. |
9797
| Web search | `??` | `??` to launch your default browser's search page.<br />`?? What is the answer to life` to search with your default browser's search engine. |
@@ -263,35 +263,46 @@ The Unit Converter plugin supports the following unit types:
263263

264264
### Value Generator plugin
265265

266-
The value generator plugin can generate GUIDs/UUIDs and calculate hashes.
266+
The Value Generator plugin can generate GUIDs/UUIDs, calculate hashes, and encode strings to base64.
267267

268+
#### UUIDs
268269
It supports the following GUID versions:
269270
- v1 - Time based
270271
- v3 - Namespace and name based, using MD5
271272
- v4 - Random value
272273
- v5 - Namespace and name based, using SHA1
273274

274275
> [!NOTE]
275-
> For versions 3 and 5 there are some predefined namespaces: DNS, URL, OID ad X500. You can use the following shortcuts:
276-
> `ns:DNS`, `ns:URL`, `ns:OID`, `ns:X500`.
276+
> For versions 3 and 5 there are some predefined namespaces: DNS, URL, OID ad X500. You can use the following predefined namespaces:
277+
> * `ns:DNS`
278+
> * `ns:URL`
279+
> * `ns:OID`
280+
> * `ns:X500`
277281
278282
Examples:
279-
- `# guid` <br />`# uuid` <br />`# uuidv4`: Generate a random GUID
280-
- `# guidv1` <br />`# uuidv1`: Generate a version 1 GUID
281-
- `# guidv3 ns:DNS www.microsoft.com` <br />`# uuidv3 ns:DNS www.microsoft.com`: Generate the GUID version 3 for 'www.microsoft.com' using the DNS namespace. The namespace parameter can be any valid GUID and the name parameter can be any string
283+
| Command | Result |
284+
| :--- | :--- |
285+
| `# guid` <br />`# uuid` <br />`# uuidv4` | Generate a random GUID |
286+
| `# guidv1` <br />`# uuidv1` | Generate a version 1 GUID |
287+
| `# guidv3 ns:DNS www.microsoft.com` <br />`# uuidv3 ns:DNS www.microsoft.com` | Generate the GUID version 3 for 'www.microsoft.com' using the DNS namespace. <br /> The namespace parameter can be any valid GUID and the name parameter can be any string |
282288

283289
> [!NOTE]
284290
> The `guid` and `uuid` keywords are interchangeable and the `v` is optional. I.e. `guid5` and `guidv5` are the same.
285291
286-
It also supports the following hashing algorithms:
292+
#### Hashing
293+
It supports the following hashing algorithms:
287294
- MD5
288295
- SHA1
289296
- SHA256
290297
- SHA384
291298
- SHA512
292299

293300
Usage:
294-
- `# md5 abc`: The string to be hashed cannot contain multiple consecutive spaces between 2 non-whitespace characters. They will be converted to a single space. I.e. 'a a' will be converted to 'a a' before being hashed.
301+
- `# md5 abc`
302+
303+
#### Base64 Encoding
304+
Usage:
305+
- `# base64 abc`
295306

296307
### Folder search filters
297308

0 commit comments

Comments
 (0)