Sidebar
reference:command_reference:internal_commands:cli
CLI
The CLI internal command can be used to:
- Open the CLI / Ad-Hoc Script Editor window
- Open an MS-DOS prompt (with the current directory set to the current folder in the Lister)
- Cause the find-as-you-type field to appear in its various modes.
Command Arguments:
| Possible values | Description | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| no argument - | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| - | Opens an instance of the CLI / Ad-Hoc Script Editor window. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| DOSPROMPT /O | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| (no value) | Opens a DOS prompt with the current directory set to the folder displayed in the source file display. You can override the current directory by using the cd directive before the CLI command (requires using the advanced command editor).
Example: CLI DOSPROMPT | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| selfolder | Uses the first selected sub-folder in the source display as the CD for the DOS prompt.
Example: CLI DOSPROMPT=selfolder | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| admin | On Vista and above, opens the DOS prompt elevated (after a UAC prompt).
Example: CLI DOSPROMPT=admin | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| noadmin | Prevents the DOS prompt from being elevated.
Example: CLI DOSPROMPT=noadmin | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| powershell | Opens a PowerShell prompt rather than a DOS prompt.
Example: CLI DOSPROMPT=powershell,admin The separate EXEC and TITLE arguments can be used to choose which version of PowerShell to run and set the window title. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| powershellise | Opens a PowerShell ISE rather than a DOS prompt.
Example: CLI DOSPROMPT=powershellise When launching a PowerShell ISE, any color parameters are ignored. This limitation affects the ISE only; DOS prompts and normal PowerShell windows can both have colors specified. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| color=<color> | Sets the text and background colors of the DOS window. You can use this by itself, or in conjunction with the admin argument to override the default color when the prompt is elevated. The <color> value is specified with two hexadecimal digits - the first corresponds to the background color, and the second to the foreground. The possible colors depend on your system's settings but are as below by default: Supported color values
Note that you must enclose the entire value of the DOSPROMPT argument in quotes when using the color parameter (otherwise the embedded = sign will confuse the command parser). Example: CLI DOSPROMPT="admin,color=97" | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| nocolor | Prevents the color of the DOS prompt from being set when elevated.
Example: CLI DOSPROMPT=admin,nocolor | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wsl | Opens a WSL (Windows Subsystem for Linux) shell window. Note that WSL must be installed from the Windows Store.
Example: CLI DOSPROMPT=wsl | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| EXEC /K | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| <command> | Overrides the default executable to launch when opening a PowerShell prompt. For example, you may wish to create a button which runs PowerShell 7 instead of Windows PowerShell.
Example: CLI DOSPROMPT=powershell EXEC="C:\Program Files\PowerShell\7\pwsh.exe" | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| QUICKCMD /O/R | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| (no value) | Displays the find-as-you-type field in Command mode, which lets you enter an ad-hoc Opus command to execute in the current file display. This lets you bind a hotkey to bring the FAYT field up in the specific mode.
Example: CLI QUICKCMD | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| <command> | Displays the find-as-you-type field in Command mode, and initialises it with the specified command.
Prefix with noselect: to place the cursor at the end of the command instead of initially selecting it for typing over. Example: CLI QUICKCMD Help | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| QUICKDOSCMD /O/R | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| (no value) | Displays the find-as-you-type field in DOS Command mode, which lets you enter a command to execute in a DOS prompt.
Example: CLI QUICKDOSCMD | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| <command> | Displays the find-as-you-type field in DOS Command mode, and initialises it with the specified command.
Prefix with noselect: to place the cursor at the end of the command instead of initially selecting it for typing over. Example: CLI QUICKDOSCMD dir | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| QUICKFILTER /O/R | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| (no value) | Displays the find-as-you-type field in Filter mode, which lets you filter the current file list.
Example: CLI QUICKFILTER | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| <pattern> | Displays the find-as-you-type field in Filter mode, and initialises it with the specified pattern.
Prefix with noselect: to place the cursor at the end of the pattern instead of initially selecting it for typing over. Example: CLI QUICKFILTER *.(jpg|png) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| QUICKFIND /O/R | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| (no value) | Displays the find-as-you-type field in Find mode, which lets you scroll to the first file matching the entered string.
Example: CLI QUICKFIND | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| <search string> | Displays the find-as-you-type field in Find mode and initialises it with the specified string.
Prefix with noselect: to place the cursor at the end of the string instead of initially selecting it for typing over. Example: CLI QUICKFIND di | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| QUICKFINDCLEAR /S | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| (no value) | Clears any highlights shown in the file display as a result of a quick find. The same effect is gained by pressing Esc by default.
Example: CLI QUICKFINDCLEAR | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| QUICKFINDREPEAT /O | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| (no value) | Repeats the last QUICKFIND. The behaviour of this command depends on the state of the Keep highlights visible after field closes Preferences setting.
If highlights are shown even after the FAYT field closes, QUICKFINDREPEAT shifts focus to the next match. If highlights are not shown, QUICKFINDREPEAT repeats the last find, searching for matches again in the current folder, using the same search string as last time. Example: CLI QUICKFINDREPEAT | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| next | Explicitly searches for the next match, whether highlights are visible or not.
Example: CLI QUICKFINDREPEAT=next | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| prev | Explicitly searches for the previous match, whether highlights are visible or not.
Example: CLI QUICKFINDREPEAT=prev | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| QUICKFOLDERS /O/R | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| (no value) | Displays the find-as-you-type field in Folders mode, which shows a list of folders drawn from the tab history list, recent list, favorites and Quick Access. The sources for this list can be configured from the Folders Mode Preferences page.
Example: CLI QUICKFOLDERS | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| <search string> | Displays the find-as-you-type field in Folders mode, and initialises it with the specified search string.
Prefix with noselect: to place the cursor at the end of the string instead of initially selecting it for typing over. Example: CLI QUICKFOLDERS noselect:C:\ | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| QUICKFTPCMD /O/R | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| (no value) | Displays the find-as-you-type field in a special mode that lets you enter a command to send directly to a remote FTP server. This command only works when you are currently connected to an FTP site. You can view the results of your command in the FTP log.
Example: CLI QUICKFTPCMD | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| <command> | Displays the find-as-you-type field in FTP command mode, and initialises it with the specified command.
Prefix with noselect: to place the cursor at the end of the command instead of initially selecting it for typing over. Example: CLI QUICKFTPCMD chmod * 755 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| QUICKGO /O/R | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| (no value) | Displays the find-as-you-type field in a special mode ("go" mode) that lets you navigate to another folder in the current file display.
Example: CLI QUICKGO | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| <path> | Displays the find-as-you-type field in "go" mode, and initialises it with the specified path.
Prefix with noselect: to place the cursor at the end of the path instead of initially selecting it for typing over. Example: CLI QUICKGO C:\Program Files | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| QUICKRANGE /O/R | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| (no value) | Displays the find-as-you-type field in Range mode, which lets you select files by index (or by a range of indices). This only works when the Index column has been added to the file display.
Example: CLI QUICKRANGE | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| <range> | Displays the find-as-you-type field in Range mode, and initialises it with the specified range string.
Prefix with noselect: to place the cursor at the end of the range string instead of initially selecting it for typing over. Example: CLI QUICKRANGE 1-10,20-30 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| QUICKSEARCH /O/R | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| (no value) | Displays the find-as-you-type field in Search mode, which lets you initiate a Windows Search of the current folder.
Example: CLI QUICKSEARCH | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| <query term> | Displays the find-as-you-type field in Search mode, and initialises it with the specified query term.
Prefix with noselect: to place the cursor at the end of the query string instead of initially selecting it for typing over. Example: CLI QUICKSEARCH author:davidson | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| QUICKSEARCHENGINE /K | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| <engine>[,<options>] | Use with the QUICKSEARCH argument to specify the search engine to use in Search mode. Each search engine has its own set of options which can also be included in the command.
Note that the everything and everythingglobal engines require Everything to be installed.
Example: CLI QUICKSEARCH A*.jpg QUICKSEARCHENGINE everything,case | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| QUICKSELECT /O/R | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| (no value) | Displays the find-as-you-type field in Select mode, which lets you select files in the current folder by wildcard pattern.
Example: CLI QUICKSELECT | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| <pattern> | Displays the find-as-you-type field in Select mode and initialises it with the specified pattern.
Prefix with noselect: to place the cursor at the end of the pattern instead of initially selecting it for typing over. Example: CLI QUICKSELECT *.doc | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| QUICKTABS /O/R | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| (no value) | Displays the find-as-you-type field in Tabs mode, which lets you search and switch folder tabs.
Example: CLI QUICKTABS | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| <pattern> | Displays the find-as-you-type field in Tabs mode and initialises it with the specified text.
Prefix with noselect: to place the cursor at the end of the text instead of initially selecting it for typing over. Example: CLI QUICKTABS docu | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| QUICKWSLCMD /O/R | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| (no value) | Displays the find-as-you-type field in WSL script mode, which lets you enter a command to execute in a WSL (Windows System For Linux) window. Note that WSL needs to be installed from the Windows Store.
Example: CLI QUICKWSLCMD | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| <command> | Displays the find-as-you-type field in WSL script mode, and initialises it with the specified command.
Prefix with noselect: to place the cursor at the end of the command instead of initially selecting it for typing over. Example: CLI QUICKWSLCMD ls | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| SCRIPTMODE /O | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| (no value) | Displays the CLI in Script Mode, which provides a simple way to test scripts before adding them to buttons.
Example: CLI SCRIPTMODE | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| <language> | Displays the CLI in Script Mode with the language type set to the specified language. If you don't specify a language the CLI will remember the previous language used.
Example: CLI SCRIPTMODE=jscript | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| TITLE /K | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| <command> | Defines the window title when opening a PowerShell prompt.
Example: CLI DOSPROMPT=powershell TITLE="Windows PowerShell" | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||