[PowerToys]File actions menu docs

hub/dev-environment/toc.yml

@@ -131,6 +131,8 @@ items:
         href: ../powertoys/environment-variables.md
       - name: FancyZones
         href: ../powertoys/fancyzones.md
+      - name: File Actions menu
+        href: ../powertoys/file-actions-menu.md
       - name: File Explorer add-ons
         href: ../powertoys/file-explorer.md
       - name: File Locksmith

hub/powertoys/file-actions-menu.md

@@ -0,0 +1,72 @@
+---
+title: PowerToys File Actions Menu
+description: A per shortcut invokable menu for certain file actions
+ms.date: 09/22/2024
+ms.topic: article
+ms.localizationpriority: medium
+no-loc: [PowerToys, Win]
+---
+
+# File Actions menu
+
+![File Actions menu](../images/PowerToys-FileActionsMenu-HashMenu.png)
+
+The PowerToys File Action Menu is a menu, which is invoked by a shortcut and allows you to perform certain actions on your selected files.
+
+There are different constraints that can define when a menu entry is shown and when not:
+
+1. Only one file has to be selected
+1. Multiple files have to be selected
+1. The selected file(s) have to be of type image
+1. The selected file(s) need to be an executable or a dynamic link library
+1. One of the selected files needs to be considered blocked by Windows
+1. The selected file(s) has/have to be dicitionairy/-ies
+1. Your clipboard must contain an image
+1. File Actions Menu must be able to find an uninstaller associated with the selected file
+
+|Title|Description|Shows when|
+|-----|-----------|----------|
+| Generate checksum(s) | Generates a specified hash/checksum of a file or multiple files. You can choose between 4 modes:<br />**Save in multiple files**: Saves hashes in files with the name of the original file appended by the hash type. For example the sha256 hash of the file `setup.exe` will be saved as `setup.exe.sha256`<br />**Save checksums in one single file**: Saves all the hashes in a single file called `hashes` with the hash type as extension.<br />**Replace filename with the checksum**: Replaces the filename of the selected file(s) with the hash of the files<br/>**Copy checksum to clipboard**(_Only available if one file is selected_): Copy the checksum of the file into the clipboard. | Always |
+| Verify checksum(s) | Verifies all checksums against the selected verification method (Explanation can be found under Generate hashes). | Always |
+| Copy paths seperated by ... | Allows you to copy the paths of the file separated by a comma, a semicolon, a space, a newline or a custom delimiter to the clipboard. | 2 |
+| Copy path | Allows you to copy the path of the selected item in different ways:<br/>**Copy full path**: You can copy the path with a choosen path delimiter. You can choose between double backslash (`\\`), backslash (`\`) and forward slash (`/`).<br/>**Copy containing directory path**: Allows you to copy the path of the directory containing the item.<br/>**Copy file name**: Copies the name of the selected item<br/>**Copy containing directory path for WSL** and **Copy full path for WSL**: The same as their non-WSL equivalents, but the path can be used in WSL (ex. `C:/windows` will become `/mnt/c/windows`). | 1 |
+| PowerRename | Launches the [PowerRename utility](./powerrename.md). | Always |
+| ImageResizer | Launches the [ImageResizer utility](./image-resizer.md). | 3 |
+| File Locksmith | Launches the [File Locksmith utility](./file-locksmith.md). | Always |
+| Unblock | Unblocks from the web downloaded files | 5 |
+| Copy image from clipboard to folder | Copies the image from the clipboard into the selected folder | 1, 6, 7 |
+| Copy image to clipboard | Copies the currently selected image to the clipboard (as image type and not as a file). | 1, 3 |
+| Copy to | Copy the selected files to another location, selectable via a folder browser dalog. | Always |
+| Move to | Move the selected files to another location, selectable via a folder browser dalog. | Always |
+| Save as | Saves the selected file to a new location, selectable via a save as dialog. | 1 |
+| New folder with selection | Creates a new folder with the selected files. | Always |
+| Uninstall | Uninstalls the selected application/the application to which this file belongs. | 4, 8 |
+| Extract images | Extract images from the dll or the exe file into a folder of the same name. | 1, 4 |
+| Merge contents | Merges the contents of the selected files into a new file | 2 |
+| Copy content to clipboard | Copies the content of the selected file into the clipboard. If it is a directory the tree of the directory will be copied into the clipboard. | 1 |
+| Collapse folder structure | Collapses the whole folder structure inside the selected folder | 1, 6 |
+| Copy file content | Copies the file content into the clipboard in a certain way.<br/>**As plaintext**: Copies the whole file as normal text.<br/>**As base64 data link**: Copies the file content as a data url with base64 encoded content. For more information you can read the [specification](https://www.rfc-editor.org/rfc/rfc2397).<br/>**C escaped**: Copies the file content as a C escaped string (`\` → `\\`, newline → `\n\r`, etc.).<br/>**XML escaped**: Copies the content of the file with XML escape sequences (ex. `<` → `&#x3C;`)<br/>**C byte escaped**: Copies the file content, where every character is replaced with the ascii byte sequence (ex. `<` → `\0x3C`).<br/>**URI escaped**: Copies the file content ready to use for an URI (ex. `<` → `%3C`), | 1 |
+
+## Supported hash types
+
+> [!WARNING]
+> Certain hash types are nowadays considered unsafe (like md5 or SHA1). Please inform yourself about the insecurities of the hash types you use.
+
+Following types of hashes are supported.
+
+- CRC32 Decimal
+- CRC32 Hex
+- CRC64 Decimal
+- CRC64 Hex
+- MD5
+- SHA1
+- SHA256
+- SHA384
+- SHA512
+- SHA3-256
+- SHA3-384
+- SHA3-512
+
+## Resolve shortcut
+
+Some actions allow the option to resolve shortcuts. This will target the files that the shortcuts point to instead of the `.ink`-file itsself.

hub/powertoys/grouppolicy.md

@@ -101,6 +101,7 @@ These policies have a higher priority than, and will override, the policy "Confi
 |Crop And Lock|Crop And Lock: Configure enabled state|ConfigureEnabledUtilityCropAndLock|
 |Environment Variables|Environment Variables: Configure enabled state|ConfigureEnabledUtilityEnvironmentVariables|
 |FancyZones|FancyZones: Configure enabled state|ConfigureEnabledUtilityFancyZones|
+|File Actions menu|File Actions menu: Configure enabled state|ConfigureEnabledUtilityFileActionsMenu|
 |File Locksmith|File Locksmith: Configure enabled state|ConfigureEnabledUtilityFileLocksmith|
 |Gcode file preview|Gcode file preview: Configure enabled state|ConfigureEnabledUtilityFileExplorerGcodePreview|
 |Markdown file preview|Markdown file preview: Configure enabled state|ConfigureEnabledUtilityFileExplorerMarkdownPreview|

hub/powertoys/index.md

@@ -114,6 +114,17 @@ The currently available utilities include:
     :::column-end:::
 :::row-end:::
 
+### File Actions menu
+
+:::row:::
+    :::column:::
+        [![File Actions Mneu screenshot](../images/PowerToys-FileActionsMenu.png)](file-actions-menu.md)
+    :::column-end:::
+    :::column span="2":::
+        [File Actions menu](file-actions-menu.md) adds a seperate menu to explorer invokable via a shortcut, which adds several functionalities like generating and comparing file hashes, creating a new folder with a selection of files and much more.
+    :::column-end:::
+:::row-end:::
+
 ### File Explorer add-ons
 
 :::row:::