ConEmu Installation

In general, ConEmu installation is easy. Just unpack or install to any folder and run ConEmu.exe.

• If you are not a Far Manager user
• If you are a Far Manager user
  • Far Manager macros for ConEmu
• MSI installer
  • Desktop icons
• MacType issues
• Java issues

If you are not a Far Manager user

• You may use either package ConEmuPack.*.7z or ConEmuSetup.*.exe, both contain identical binaries.
  • Just unpack all files from ConEmuPack.*.7z;
  • Or run installer ConEmuSetup.*.exe and follow MSI installation wizard steps. Read more about installer below.
• NB. Subfolder plugins (Far Manager related) is not required in your case and may be deleted or unchecked in the installer.
• Run ConEmu.exe or ConEmu64.exe.

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 folder:

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) installed into C:\Tools\Far\plugins\ConEmu folder and will be loaded by far.exe automatically.

Otherwise you have to use /p switch as shown in the example above.

Far Manager macros for ConEmu

The subfolder ConEmu contains several useful macros for different Far Manager versions. For example, folder Far1_reg contains *.reg macros for old-school Far 1.75, and Far3_lua supplies *.lua macros for latest Far 3.0 branch.

Just browse them and choose what you want, each macro file has description in the header.

For example, ConEmu.ShiftEnter.* let you run application under cursor or typed command in the new ConEmu tab. Just press Alt+Enter to run tab in foreground and Shift+Enter to run in background.

How to use the desired macro.

• *.lua macro files. Standard for Far 3.0 branch. Copy the file to the %FARPROFILE%\macros\scripts and run in Far prompt Macro:Load.
• *.fml macro files. This requires ‘MacroLib’ plugin, please refer to its documentation.
• *.reg macro 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.

MSI installer

The installer 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.

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 C:\ConEmu folder.

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.

Desktop icons

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.*.exe changing 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.

MacType issues

If you are using MacType you can get crashes when starting any application from a shell started in ConEmu tab.

That is because MacType tries to hook ConEmuC.exe and ConEmuC64.exe processes. But ConEmuC is a console application and it does not draw any text on graphical canvas at all.

The workarounds

• Use ‘Load with MacTray’ + ‘Standalong loading mode’ instead of ‘Registry’ or ‘Service’.
• Or add ConEmuC.exe and ConEmuC64.exe to MacType exclusion list, if exclusion lists works for you.

Java issues

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 %PATH% and %JAVA_HOME%. Also, Java 8.x seems like does not have that problem.