ConEmu.exe command line switches
Note From build 140106 you may use either ‘/’style or ‘-‘style switches.
| Argument | Description |
|---|---|
| /? | Show help screen |
| -Config configname | Tells to use an existing or create a new configuration with the specified name. Each configuration keeps its own individual data in the registry or xml file (ConEmu.xml). |
| -Dir workdir | Set working (startup) directory for ConEmu and console processes. This switch override ConEmu startup directory (defined in the ConEmu shortcut for example). |
| -Here | Force using of ‘inherited’ startup directory. This is an alternative to the -Dir ... switch. |
-FS | -Max | -Min |
(Full screen), (Maximized) or (Minimized) mode |
| -TSA | Override (enable) minimize to taskbar status area (TSA) |
| -MinTSA | Start ConEmu in TSA, but minimize to taskbar after restoring. Also ConEmu will not be exited after last console close, but hided to TSA. |
| -StartTSA | Start ConEmu in TSA, but minimize to taskbar after restoring. ConEmu will be exited after last console close. |
| -Icon file | Take icon from file (exe, dll, ico) |
| -Title title | Set fixed title for ConEmu window. You may use environment variables in title. |
-Multi | -NoMulti |
Enable or disable multiconsole features |
-Single | -Reuse |
New console will be started in new tab of existing ConEmu |
| -NoSingle | Force new ConEmu window even if single mode is selected in the Settings |
-ShowHide | -ShowHideTSA |
May be used with AutoHotKey or desktop shortcuts. Works like ‘Minimize/Restore’ global hotkey. |
| -NoUpdate | Disable automatic checking for updates on startup |
-CT[0|1] |
Anti-aliasing: -ct0 - off, -ct1 - standard, -ct - clear type |
| -Font fontname | Specify the font name |
| -FontSize fontsize | Specify the font size |
| -FontFile fontfilename | Loads font from file for ConEmu process (multiple pairs allowed) |
| -FontDir fontfolder | Loads all fonts from folder (multiple pairs allowed) |
| -BufferHeight lines | Set console buffer height. May be used with cmd.exe, PowerShell, etc. |
-Wnd{X|Y|W|H} value |
Set window position and size. |
| -Monitor monitor-id | Place window on the specified monitor. Monitor-id may be specified by: 1-based index; hex descriptor (e.g. “x00010001”); device name (e.g. “\.\DISPLAY1”). You may check this values in the About/SysInfo. |
| -Palette Name | Choose named color palette. |
| -Theme [Name] | Use specified Windows theme or ‘DarkMode_Explorer’. |
-Log | -Log1 | -Log2 |
Used to create debug log files |
| -Reset | Don’t load settings from registry/xml. |
| -UpdateJumpList | Update Windows 7 taskbar jump list. May be used for automated ConEmu set up from batches. |
| -LoadCfgFile file | Use specified xml file as configuration storage. |
| -SaveCfgFile file | Save configuration to the specified xml file. |
| -Exit | Don’t create ConEmu window, exit after actions. |
| -new_console -cur_console |
This special switches may be specified after -run switch. Read more about -new_console and -cur_console switches |
| -run commandline -run @taskfile -run {taskname} |
Command line to start. This must be the last used switch (excepting -new_console and -cur_console). You may use “>” and “*” modifiers in taskfile and -BufferHeight argument. taskname is one of the tasks specified on the “Tasks” page of “Settings” dialog. |
| -runlist commands | Run several tabs on startup. This must be the last used switch (excepting -new_console and -cur_console). Use the same syntax and abilities as on the “Tasks” page of “Settings” dialog. Delimit commands (tabs) with “|||”. Note, that you must escape delimiter “^|^|^|” when running from cmd-files. |
NB Switches -run and -runlist are renovated variants of -cmd and -cmdlist to avoid their confusing with cmd.exe.
These switches were introduced in build 160416. Use -cmd and -cmdlist for older builds.
NB ConEmuC.exe command line switches are described here.
Examples
Example 1
ClearType is ON, using font face name ‘Lucida Console’, font height 16. Starts FAR manager in the folder ‘C:\1 2’.
ConEmu.exe -ct -font "Lucida Console" -size 16 -run far.exe "c:\1 2\"
Example 2
Starts continuous operation minimized in taskbar status area (TSA), use icon from “cmd.exe”.
ConEmu.exe -tsa -min -icon "cmd.exe" -run cmd /c dir c:\ /s
Example 3 (-runlist)
Start four cmd tabs in a grid 2x2 (Win+R or shortcut syntax).
ConEmu.exe -runlist cmd -cur_console:fn ||| cmd -cur_console:s1TVn ||| cmd -cur_console:s1THn ||| cmd -cur_console:s2THn
Example 4 (four tabs)
Starts with four tabs: Far Manager, CMD, PowerShell and Bash.
- Far.exe will be active console;
- Cmd.exe will be started with 400 lines buffer height in the
%ALLUSERSPROFILE%directory and special color 4F (white on red); - PowerShell will be started as Administrator with 1000 lines buffer height in the
%USERPROFILE%directory; - Bash (MinGW) will be started in the
C:\Sourcedirectory.
Win+R or shortcut syntax (following is one-line command, splitted for clearness)
ConEmu.exe -runlist
>"C:\Program Files\Far\far.exe"
||| cmd /k color 4F "-cur_console:h400d:%ALLUSERSPROFILE%"
||| *powershell "-cur_console:h1000d:%USERPROFILE%"
||| C:\MinGW\msys\1.0\bin\sh.exe --login -i "-cur_console:d:C:\Source"
batch files (bat, cmd) syntax (following is one-line command, splitted for clearness).
rem Remove line breaks after paste!
start "ConEmu" "C:\Program Files\ConEmu\ConEmu.exe" -runlist
^>"C:\Program Files\Far\far.exe"
^|^|^| cmd /k color 4F "-cur_console:h400d:%ALLUSERSPROFILE%"
^|^|^| *powershell "-cur_console:h1000d:%USERPROFILE%"
^|^|^| C:\MinGW\msys\1.0\bin\sh.exe --login -i "-cur_console:d:C:\Source"
or
ConEmu.exe -run @startfile.txt
or
ConEmu.exe -run {taskname}
Sample startfile.txt or contents of {taskname}
>"C:\Program Files\Far\far.exe"
cmd /k color 4F "-cur_console:h400d:%ALLUSERSPROFILE%"
*powershell "-cur_console:h1000d:%USERPROFILE%"
C:\MinGW\msys\1.0\bin\sh.exe --login -i "-cur_console:d:C:\Source"
Example 5
Following example is for use within cmd’s batch files or from cmd.exe prompt itself.
Starts with three cmd tabs, set different bg/fg color (color command after /k switch)
and different working directory (C:\, D:\, E:\).
Following is one-line command, splitted for clearness.
start "Three tabs" "C:\Program Files\ConEmu\ConEmu.exe" -runlist
^> cmd /k color 4C -cur_console:d:C:\
^|^|^| cmd /k color 5D -cur_console:d:D:\
^|^|^| cmd /k color 2A -cur_console:d:E:\
Rarely used switches
| Argument | Description | |
|---|---|---|
| -debug | Show message box immediately after ConEmu starts | |
| -autosetup 1 | 0 | Install or remove ConEmu autostart with cmd.exe |
| -visible | Starts with visible real console | |
| -detached | Starts with no console, ConEmu is ready for attaching from another real console or FAR manager | |
| -noautoclose | Don’t close ConEmu window automatically with last tab; may be used with ‘-detached’ | |
| -nocascade | Disable ‘Cascade’ option may be set in the Settings | |
| -nodefterm | Don’t start initialization procedure for setting up ConEmu as default terminal | |
| -nohookswarn | Don’t show ‘hooks are detected’ warning in console. | |
| -nokeyhooks | Disable SetWindowsHookEx and global hotkeys | |
| -nomacro | Disable hotkeys with GuiMacro actions | |
| -nohotkey | Disable all hotkeys | |
| -noregfonts | Disable auto register fonts (font files from ConEmu folder) | |
| -nocloseconfirm | Disable confirmation of ConEmu’s window closing | |
| -inside -insidepid PID -insidewnd xHWND |
Starts ConEmu in ‘inside’ mode (act as child window of parent process) | |
| -demote | Run command de-elevated, using Task Sheduler. May be useful in Vista and higher with UAC enabled. Example: ConEmu.exe -demote -run powershell.exe |
|
| -resetdefault | Same as -reset and don’t show fast configuration dialog. | |
| -basic | Same as -resetdefault and disable ‘Save settings’ button in Settings dialog. |


