{filepath}

{f!}

Passes the full path and filename of each selected item. Files are passed one at a time - a command that uses this code will be repeated once for each additional selected item. If no files are selected the command will still be run, passing an empty string for this code.

Full paths, one at a time, selected items not required, long filenames, source file display

{file}

{o!}

Passes the filename only of each selected item (without its path). Multiple files are passed one at a time.

Filenames only, one at a time, selected items not required, long filenames, source file display

{allfilepath}

{F!}

Passes the full path and filename of all selected items at once. The command will only be run once, no matter how many items are selected - the names of all selected items will be passed on the command line separated by spaces. You can use the sep= modifier (described below) to specify an alternative separator character.

Full paths, all at once, selected items not required, long filenames, source file display

{allfile}

{O!}

Passes the filename only of all selected items at once. File paths are not passed.

Filenames only, all at once, selected items not required, long filenames, source file display

{filepathshort}

{fs!}

Passes the full path and filename of each selected item, in short (8.3) format. This is useful for running 16 bit programs or other legacy software that can't handle long filenames.

Full paths, one at a time, selected items not required, short filenames, source file display

{fileshort}

{os!}

Passes the filename only (no paths) of each selected item, in short (8.3) format.

Filenames only, one at a time, selected items not required, short filenames, source file display

{allfilepathshort}

{Fs!}

Passes the short (8.3) form of the full path and filename of all selected items at once.

Full paths, all at once, selected items not required, short filenames, source file display

{allfileshort}

{Os!}

Passes the filename only of all selected items at once, in short (8.3) format.

Filenames only, all at once, selected items not required, short filenames, source file display

{filepathdest}

{fd!}

Passes the full path and filename of each selected item in the destination file display. Files are passed one at a time - a command that uses this code will be repeated once for each additional selected item. If no files are selected in the destination, or there is currently no destination, the command will still be run, passing an empty string for this code.

Full paths, one at a time, selected items not required, long filenames, destination file display

{filedest}

{od!}

Passes the filename only of each selected item from the destination file display (without its path). Multiple files are passed one at a time.

Filenames only, one at a time, selected items not required, long filenames, destination file display

{allfilepathdest}

{Fd!}

Passes the full path and filename of all selected items, from the destination file display, all at once. The command will only be run once, no matter how many items are selected - the names of all selected items will be passed on the command line separated by spaces.

Full paths, all at once, selected items not required, long filenames, destination file display

{allfiledest}

{Od!}

Passes the filename only of all selected items at once, from the destination file display. File paths are not passed.

Filenames only, all at once, selected items not required, long filenames, destination file display

{filepathshortdest}

{fsd!}

Passes the full path and filename of each selected item, in short (8.3) format, from the destination file display. This is useful for running 16 bit programs or other legacy software that can't handle long filenames.

Full paths, one at a time, selected items not required, short filenames, destination file display

{fileshortdest}

{osd!}

Passes the filename only (no paths) of each selected item in the destination file display, in short (8.3) format.

Filenames only, one at a time, selected items not required, short filenames, destination file display

{allfilepathshortdest}

{Fsd!}

Passes the short (8.3) form of the full path and filename of all selected items at once, from the destination file display.

Full paths, all at once, selected items not required, short filenames, destination file display

{allfileshortdest}

{Osd!}

Passes the filename only of all selected items at once, in short (8.3) format, from the destination file display.

Filenames only, all at once, selected items not required, short filenames, destination file display

noext

Strips the filename extension from filenames. For example, if {file} returned cat_photo.jpg then {file|noext} would return cat_photo. Note that if the item is a folder then its name will not be changed, even if it contains a dot, as folders are not considered to have file extensions.

ext2

Returns the filename extension without the dot. For example, if {file|ext} returned .jpg then {file|ext2} would return jpg.

escbackslash

Automatically escapes any occurrences of \ in the filename, turning them into \\.

This can be necessary when using codes like {filepath} to insert paths into strings which will have sequences like \n and \\ interpreted specially.

For example, a command to add the selected file from the source and the selected file from the destination to the clipboard on separate lines:

Clipboard EXPANDNEWLINES SET {filepath|escbackslash}\n{filepathdest|escbackslash}.

In this example, if the source file was C:\New Folder\test.txt then it would be converted to C:\\New Folder\\text.txt. If the \N sequence had not been escaped, it would have removed the letter N from the path and put ew Folder\text.txt on a separate line. (There are more subtle cases when dealing with folder paths, but they are less important with file paths.)

escregexp

Automatically escapes any regular expression characters in the filename. Used when passing filenames to internal commands that understand regular expressions, in case a filename contains characters like \, ., ( and ) which have special meaning to some functions. For example, {file|escregexp|noext} would turn Accounts (2010).xls into Accounts \(2010\).

file

Redirects the filenames to a temporary text file. This is useful with external programs that can accept a list of files from a text file rather than on the command line. (In turn, that is useful because command lines have a maximum length which may limit the number of filenames you can pass directly.) The name of the temporary file is passed on the command line in place of the filenames themselves. In the text file, each filename is separated by a space. If a filename or its path contains an embedded space it will be surrounded by quotes. For example, {allfilepath|file}.

fileq

The same as file except that each filename is always surrounded by quotes, whether it contains an embedded space or not. For example, {allfilepath|fileq}.

utf8

Forces the file written by file, filem or fileq to use UTF-8 format. For example, {allfilepath|filem|utf8}.

ucsbe

Forces the file written by file, filem or fileq to use UCS-16BE format. For example, {allfilepath|filem|ucsbe}.

nobom

Prevents a BOM from being written that identifies the file type. For example, {allfilepath|filem|utf8|nobom}.

lfonly

When used with filem or filemq, makes it so the file has only LF (line feed) characters between each line. The default is CR,LF pairs as is standard on Windows. For example, {allfilepath|filem|lfonly}.

noroot

Removes the root (i.e. the first component) from the file's path. For example, if {filepath} returns C:\Windows\Notepad.exe, {filepath|noroot} would return Windows\Notepad.exe. With UNC network paths, the result is relative to the share, with the computer and share itself removed. With FTP paths, the result is relative to the site's root and excludes the site itself. You can combine noroot with .. to get a parent path with the root removed. For example, {filepath|..|noroot}

noterm

Removes the trailing path separator from folder paths. For example, {filepath} might return C:\Program Files\ whereas {filepath|noterm} would return C:\Program Files.

subdir

Replaces characters in the file's path so that the full path can be added below another path. For example, {filepath|subdir} might return C;\Windows\Notepad.exe. Note that a semi-colon has replaced the colon, allowing the path to be used relative to another directory, say if you wanted to create a backup of the file called D:\Backups\C;\Windows\Notepad.exe.

..

Modifies the code to refer to the selected item's parent folder rather than the item itself. You can pass multiple .. modifiers separated by \ to return folders higher up the tree. For example {filepath|..\..} would return the name of the item's parent's parent.

driveletter

Modifies the code to refer to the drive letter, on its own, at the start of the selected item's path. For example {filepath|driveletter} might return C. If the path is not relative to a drive letter, the whole path will be inserted as-is.

You can also use {filepath|\} to get something like C:\, or {filepath|\|notermdrive} to get something like C:, while handling non-drive roots (e.g. UNC paths) differently.

%1

{filepath}

%L

{filepath}

%*

{allfilepath}