EmEditor Command Line Options

Using Command Line Options

http://www.emeditor.com/help/howto/file/file_commandline.htm

 

Command line options can be specified in the Run dialog box on the Start menu or a  Command Prompt window.

Syntax

Open a file or files

"File1" "File2" "File3" ... [/r] [/fh] [/nr] [/sp] [/l LineNumber] [/cl ColumnNumber] [/cp encoding] [/c "Config"] [/mf "MacroPath"]

Create a new file

[/cd] [/sp] [/c "Config"] [/mf "MacroPath"]

Create a new file and paste

[/i] [/cd] [/sp] [/c "Config"] [/mf "MacroPath"]

Create a new file and paste with quote

[/iq] [/cd] [/sp] [/c "Config"] [/mf "MacroPath"]

Create a new file and paste with quote and returns

[/iqr] [/cd] [/sp] [/c "Config"] [/mf "MacroPath"]

Display the Tray Icon

/ti

Print a file

"File" /p [/nr] [/sp] [/cp encoding]

Compare two files

/cmp "File1" "File2"

Convert a file encoding

"SrcFile" [/nr] [/sp] [/cp EncodingToOpen] [/c "Config"] /cps EncodingToSave /ss+ /sa "DestFile"

To save without the Unicode signature (BOM), use /ss- instead of /ss+.

Display Find in Files dialog box

/fd

Display Replace in Files dialog box

/rd

Find in files

/fc "FindWhat" [/fr] [/fw] [/x] [/fn] [/fu "FilesToIgnore"] [/cp encoding] "path"

This command is called internally when the Find button is selected in the Find in Files dialog box. To search without matching case, use /fi instead of /fc.

Replace in files

/fc "FindWhat" [/fr] [/fw] [/x] [/ko] [/fu "FilesToIgnore"] [/cp encoding] "path" /rw "RepalceWith" [/bk "BackupFolder"]

This command is called internally when the Replace All button is selected in the Replace in Files dialog box. To search without matching case, use /fi instead of /fc. /ko and /bk cannot be specified simultaneously.

Open a file and replace

"File" /rc "FindWhat" [/fw] [/x] [/cp encoding] /rw "RepalceWith"

This command is called internally during the Replace in Files process. To search without matching case, use /ri instead of /rc.

Restore workspace

/ws

This command is called internally when the Restore Workspace command is selected.

Save workspace

/wss

This command is called internally when the Save Workspace command is selected.

Grab text with EmEditor

/eh

This command is called from the Tray Icon when the shortcut key to grab text with EmEditor defined in the Customize Tray Icon dialog box is pressed.

Display Help

/?

Options

/?

displays Help.

/act

activates EmEditor if it is already running, or launches EmEditor if it is not already running.

/bk "BackupFolder"

specifies a backup folder when replacing in files.

/c "Config"

sets the configuration.

/ca

closes all documents.

/car

closes all documents including a hidden window if the "Quick Start" option is enabled.

/cd

set the current directory as the default folder in the Open dialog box.

/cjl

customizes the Jump List on Windows 7 or later.

/cl ColumnNumber

logical column number.

/clw

clears the workspace.

/cmp

compares two files.

/cp Encoding

sets an encoding to open as.  An encoding can be one of Encoding Constants. A combination with following values can be specified.

131072	Detects Unicode signature (BOM).
262144	Detects UTF-8.
524288	Detects HTML/XML Charset.
1048576	Detects all encodings.

/cps Encoding

sets an encoding to save as.  An encoding can be one of Encoding Constants.

/di

specifies the working folder when creating a new document. Used internally by EmEditor.

/eh

grabs a text box contents.

/fc "FindWhat"

find in files (case sensitive).

/fd

displays the Find in Files dialog box.

/ff "FindWhat"

find a string directly within the opened document. Can be combined with /mc or /x.

/fi "FindWhat"

find in files (ignore case).

/fh

highlights searched strings.

/fn

displays only file names when finding in file.

/fu "FilesToIgnore"

ignores the following file or folder names.

/fr

search in sub folders when finding in files (use with /fc or /fi).

/fw

searches only words.

/hide

runs EmEditor as a hidden window when the "Quick Start" option is enabled.

/i

pastes a text string from the Clipboard.

/ipi

refreshes the plug-in list. used from plug-in installers.

/iq

pastes a text string in quotes from the Clipboard.

/iqr

pastes a text string in quotes and returns from the Clipboard.

/ko

keeps modified files open when replacing in files.

/l LineNumber

move cursor to the logical line number.

/mc

matches cases when /ff is used to find a string.

/mf

specifies a macro file to run.

/n

always start as a new file.

/ncp

suppresses "The specified file does not exist. Open as a new file?" prompt when a specified file is not found.

/ne

specifies event-triggered macros should be disabled.

/nr

does not add the file path to the recent file list.

/od

displays the Open dialog box to select files to open.

/p

prints the file.

/pos left top right bottom

specifies the window position with four integers (left, top, right, bottom).

/r

read-only mode.

/rc "FindWhat"

replaces in files (case sensitive).

/rd

displays the Replace in Files dialog box.

/rh

opens HTML files as read-only. Used internally.

/ri "FindWhat"

replaces in files (ignore case).

/rr

opens files in folders recursively.

/rw

specifies a string to be replaced with.

/sa "DestFile"

specifies a file name to save as after the encoding conversion.

/sca

saves and closes all opened documents.

/scrlf

saves the file using CR+LF as return method after the encoding conversion.

/scr

saves the file using the CR only as return method after the encoding conversion.

/slf

saves the file using the LF only as return method after the encoding conversion.

/sp

specifies that a new separate process from other EmEditor windows should be run. This option is useful when a new EmEditor window must be launched from another application because the application must monitor the process termination so it can detect the file modification. If this is specified, however, some features including tab operations will be disabled, and will void support.

/ss+

saves the file with a Unicode signature (BOM) after the encoding conversion.

/ss-

saves the file without a Unicode signature (BOM) after the encoding conversion.

/ti

displays the Tray Icon.

/uob

uses the Output Bar to display the Find in Files results.

/x

finds or finds in files using a regular expression.

/ws

restores the workspace.

/wss

saves the workspace.

Examples

/rr *.htm

opens all .htm files including all sub folders.

/p "filename"

prints filename.

/r "filename"

opens filename in read only mode.

/c "Normal" "filename"

opens filename in the default configuration.

/l 123 "filename"

opens filename, jumps to 123rd line and display it.

/ff "what" /mc "filename"

opens filename, and finds what matching cases.

/fh

highlights string of last search.

/ti

opens as a tray icon.

/fi "ABC" "c:\Temp\*.txt"

searches for the string ABC from all files with the extension .txt on the c:\Temp folder while ignoring case.

/fi "abc" /fr /fw /fn /fu "_*;*.bak" /cp 65536 "c:\test\*.htm;*.txt"

searches for the string abc from all files with the extension .htm and .txt on the c:\test folder while ignoring case. it searches sub folders, searches only words, displays only file names, ignores file or folder names matching "_*;*.bak", and uses the system default encoding.

/fc "[a-e]" /fr /x /fu "_*;*.bak" /cp 65536 "c:\test\*.htm;*.txt"

searches for text matching a regular expression [a-e] from all files with the extension .htm and .txt on the c:\test folder while not ignoring case. it searches sub folders, ignores file or folder names matching "_*;*.bak", and uses the system default encoding.

"c:\test\utf16.txt" /cp 65537 /cps 65001 /ss- /sa "c:\test\utf8.txt" /scrlf

converts a UTF-16LE file c:\test\utf16.txt to UTF-8 without a Unicode signature and saves as c:\test\utf8.txt. The return method is converted to CR+LF.

Tips

• The string searched for in files must be after /fc or /fi.
• If no options are specified, the selected file will simply be opened.
• If /c is not specified and the associated extensions of the configuration are the same, open the file with that configuration.
• If a folder name is specified instead of a file name, the Open dialog box with that folder will be displayed.
• Command line options are case sensitive. For instance /r will not be recognized if written as /R.
• Escape seaquences are always on when searching from the command line.