AutoHotkey script template to take action on selected files in active File Explorer window in Windows 10.
BackgroundFARR can find and launch files, but also do much more. This AutoHotkey script template helps you use FARR to quickly take action on selected files in the active Explorer window. Similar to a context menu action in Explorer, but started from a FARR alias.
AutoHotkey script template
; Template: take action on selected files in active Explorer window
; - AutoHotkey helper script template for FindAndRunRobot (FARR)
; - by Nod5 2020-04-25
; Get active the window's handle (Hwnd) from parameter passed by FARR
vHwnd := A_Args[1]
; verify that the window is Explorer
If !
WinActive("ahk_class CabinetWClass ahk_id " vHwnd
)
; get filepaths for selected files
aFiles := ExplorerHwndSelectedFilepaths(vHwnd)
; ----------------------------------------------------
; add code to take action on the files here
; example: show each filename in a messagebox popup
For Key, vFile in aFiles
{
}
; ----------------------------------------------------
; exit script when finished
; required function
; function: ExplorerHwndSelectedFilepaths()
; return array of filepaths for selected files in Explorer window identified via HWND
ExplorerHwndSelectedFilepaths(vHwnd)
{
if !vHwnd
or !
WinExist("ahk_class CabinetWClass ahk_exe Explorer.exe ahk_id " vHwnd
) return
for window in ComObjCreate("Shell.Application").Windows
{
if (window.HWND != vHwnd)
aFiles := []
sfv := window.Document
; note: gets items in alphanum ascending sort order
; https://docs.microsoft.com/en-us/windows/desktop/shell/shellfolderview-selecteditems
items := sfv.SelectedItems
for item in items
aFiles.push(item.Path)
}
window := item := items := sfv := ""
return aFiles
}
PreparationInstall AutoHotkey,
https://www.autohotkey.com/Create a new action- Download the template to a file, for example "C:\some folder\timestamp action.ahk"
- Edit the template to add code for the action you want to perform on the selected files
- Create a FARR user alias to launch the script and pass the parameter %LASTHWND%
Example FARR alias- alias keyword:
timestamp now- regular expression pattern:
^(stamp)$- result:
C:\some folder\timestamp action.ahk %LASTHWND%Use the action- Open Explorer and select some files
- Open FARR, type to show the alias action (for example "stamp") and press Enter.
NoteThe regular expression pattern is optional in FARR aliases, but useful to more quickly get to a single result.
For max speed use short patterns like
^(sta|stam|stamp)$ to show only the alias result when you type "sta", "stam" or "stamp" but still let FARR show regular file search results if you continue typing for example "stamp collection".
Action example; set "time modified" for the file to the current time
For Key, vFile in aFiles
{
}
List of action ideas- add to music/video app playlist
- copy to some other folder
- create file shortcuts in some other folder
- create a companion note file ("filename.jpg -- notes.txt")
- compare selected files in WinMerge
- scale image files 50%
- rotate image files 90 degrees
- change file date modified/created timestamp to current time
- create backup file copy with a timestamp suffix ("filename_20200423103546.txt")
(Useful for basic versioning when Git is overkill but you want
some order to avoid a mess like "text.doc", "text2 final.doc", "text 2 final FIXED.doc")
- calculate and save file hashes (sha1, sha256, ...)
Ideas for more advanced actionsAsymmetric action on two selected files: copy/clone some feature (image size, timestamp, filename pattern, ...) from first file onto second file. For example clone a date modified timestamp.
Why use this rather than regular Explorer context menu actions?- easy to create and use if you're already using FARR and AutoHotkey
- very quick if you set up short regex alias patterns
- quick to toggle aliases on/off
- you can add and show context/instructions to alias text to remind you what the action does
- avoid browsing a cluttered context menu
Example with screenshotsUse case: We want a quick way to to create .txt files to write notes about some files, for example some images.
Edit the template and add an action to create .txt note files. Save, for example to "C:\test\create txt note.ahk"
; create companion text file for notes
For Key, vFile in aFiles
{
}
Create a user alias in FARR
Select files in Explorer, Open FARR and use the alias
Text files are created.
Take important notes.