In general, ConEmu installation is easy.
Just unpack or install to any folder and run
- If you are not a Far Manager user
- If you are a Far Manager user
- MSI installer
- MacType issues
- Java issues
If you are not a Far Manager user
- You may use either package
ConEmuSetup.*.exe, both contain identical binaries.
- Just unpack all files from
- Or run installer
ConEmuSetup.*.exeand follow MSI installation wizard steps. Read more about installer below.
- Just unpack all files from
- NB. Subfolder
plugins(Far Manager related) is not required in your case and may be deleted or unchecked in the installer.
If you are a Far Manager user
In general, installation for using with Far Manager does not differ. With the only exception:
- You must ensure ConEmu plugin is loaded by Far Manager.
By default, ConEmu will create a Task for each Far Manager version found on your PC.
The example command line for Far Manager installed in the
C:\Tools\Far\far.exe /w /p"%ConEmuDir%\Plugins\ConEmu;%FarHome%\Plugins"
If you install ConEmu in the same folder where
far.exe is located,
C:\Tools\Far for example, there will be no problem at all,
ConEmu plugin will be (most probably)
and will be loaded by
Otherwise you have to use
/p switch as shown in the example above.
Far Manager macros for ConEmu
ConEmu contains several useful macros for different Far Manager versions.
For example, folder
*.reg macros for old-school Far 1.75,
*.lua macros for latest Far 3.0 branch.
Just browse them and choose what you want, each macro file has description in the header.
let you run application under cursor or typed command in the new ConEmu tab.
Alt+Enter to run tab in foreground and
Shift+Enter to run in background.
How to use the desired macro.
*.luamacro files. Standard for Far 3.0 branch. Copy the file to the
%FARPROFILE%\macros\scriptsand run in Far prompt
*.fmlmacro files. This requires ‘MacroLib’ plugin, please refer to its documentation.
*.regmacro files. Just double click the file to import its contents to Windows registry.
If your Far version does not know
Macro:Load command, just restart the Far to reload macros list.
ConEmuSetup.*.exe is actually a bundle for standard x32 and x64 MSI installers.
There are not differences between them except of default installatin folder on 64-bit OS.
|Bitness||Default folder on 64-bit OS|
But you may choose any desired folder, and
ConEmuSetup.*.exe shows if the version
is already installed and where. The following screenshot depicts that 64-bit ConEmu
version was installed in the
Actually, there are no differences between 32-bit and 64-bit packages, both contain all required files to run on any Windows.
Selected MSI installer is unpacked to
%TEMP% folder and you’ll face usual MSI wizard.
Just follow usual installation steps, selecting options and pressing ‘Next’ button.
By default, the installer creates icons on the ‘Desktop’ and in the ‘Start menu’. And these icons will be recreated by MSI each time you update ConEmu. If you dislike the behavior, if you want to rename icons or remove them from ‘Desktop’, you shall:
- Run the installer
ConEmuSetup.*.exechanging installed features.
- Uncheck ‘Desktop’ shortcuts creation.
- Go to the end of MSI wizard process.
After that you may create you own personalized shortcuts on the Desktop.
If you are using MacType you can get crashes when starting any application from a shell started in ConEmu tab.
- Use ‘Load with MacTray’ + ‘Standalong loading mode’ instead of ‘Registry’ or ‘Service’.
- Or add
ConEmuC64.exeto MacType exclusion list, if exclusion lists works for you.
There is an Issue 1899 with Java version 7.x if it was installed in symlinked folder. You can get java exception like:
at sun.nio.fs.WindowsNativeDispatcher.GetFinalPathNameByHandle(Native Method)
The workaround. Use full (but not symlinked) paths in the
Also, Java 8.x seems like does not have that problem.