diff --git a/hub/dev-environment/toc.yml b/hub/dev-environment/toc.yml index 93377b0104..1b92e06c20 100644 --- a/hub/dev-environment/toc.yml +++ b/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 diff --git a/hub/images/PowerToys-FileActionsMenu-HashMenu.png b/hub/images/PowerToys-FileActionsMenu-HashMenu.png new file mode 100644 index 0000000000..827d4fbf0d Binary files /dev/null and b/hub/images/PowerToys-FileActionsMenu-HashMenu.png differ diff --git a/hub/images/PowerToys-FileActionsMenu.png b/hub/images/PowerToys-FileActionsMenu.png new file mode 100644 index 0000000000..c2acc3f941 Binary files /dev/null and b/hub/images/PowerToys-FileActionsMenu.png differ diff --git a/hub/powertoys/file-actions-menu.md b/hub/powertoys/file-actions-menu.md new file mode 100644 index 0000000000..68fb66a5ce --- /dev/null +++ b/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:
**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`
**Save checksums in one single file**: Saves all the hashes in a single file called `hashes` with the hash type as extension.
**Replace filename with the checksum**: Replaces the filename of the selected file(s) with the hash of the files
**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:
**Copy full path**: You can copy the path with a choosen path delimiter. You can choose between double backslash (`\\`), backslash (`\`) and forward slash (`/`).
**Copy containing directory path**: Allows you to copy the path of the directory containing the item.
**Copy file name**: Copies the name of the selected item
**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.
**As plaintext**: Copies the whole file as normal text.
**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).
**C escaped**: Copies the file content as a C escaped string (`\` → `\\`, newline → `\n\r`, etc.).
**XML escaped**: Copies the content of the file with XML escape sequences (ex. `<` → `<`)
**C byte escaped**: Copies the file content, where every character is replaced with the ascii byte sequence (ex. `<` → `\0x3C`).
**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. diff --git a/hub/powertoys/grouppolicy.md b/hub/powertoys/grouppolicy.md index cd1ec105e0..1317e9ed39 100644 --- a/hub/powertoys/grouppolicy.md +++ b/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| diff --git a/hub/powertoys/index.md b/hub/powertoys/index.md index 73f967e9ae..6f251c0296 100644 --- a/hub/powertoys/index.md +++ b/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:::