-
Notifications
You must be signed in to change notification settings - Fork 2k
Seamless Hyper integration
Hyper is a terminal emulator built with web-technologies such as xterm.js and Electron.
Hyper has a range of awesome plugins and can be used as an alternative to ConEmu as the terminal emulator.
✅ You can call this installation Hyper Cmder (read Hyper Commander).
To run Cmder with Hyper instead of ConEmu, follow these steps:
*If you are running Hyper Canary, continue to the next section
-
Download and install the latest version of Hyper for Windows: download page
-
Follow the instructions in this page to set-up the
%CMDER_ROOT%
environmental variable
✍ Tip: If you already have a working environment variable, skip this step -
Open Hyper terminal, then press Ctrl + , (Control-Comma) to open the Preferences settings file.
✍ Tip: You can also open the file directly from
%userprofile%\.hyper.js
.The settings file will be opened for edit with your default text editor program.
-
Navigate to the near end of the configuration file,
look for and modify the variables according to the values provided below:
shell: 'cmd.exe',
shellArgs: ['/k', '[cmder_root]\\vendor\\init.bat'],
env: { 'TERM':'cygwin' }, // required for git-for-windows
👉 Note: Substitute [cmder_root]
with your Cmder installation directory, e.g. C:\apps\cmder
or %CMDER_ROOT%
.
✍ Tip: Make sure to define the environment variable before using %CMDER_ROOT%
as the [cmder_root]
portion.
- In the
plugins
array, add the following plugins to use the Monokai color scheme and get a more Cmder-like user interface:
'hyperterm-monokai',
'hyper-tab-icons',
'hyper-statusline',
-
Additional configuration
-
You can set the tab name as follows:
shellArgs: ['/k', 'title Cmder & %CMDER_ROOT%\\vendor\\init.bat'],
-
To start Hyper in a custom default directory, you can use the following configuration
shellArgs: ['/k', 'cd /d D:\\Custom^ Folder & %CMDER_ROOT%\\vendor\\init.bat'],
⚠ Note: You must prepend a
^
symbol before all space characters in path, such thatC:\Test folder\foo bar\baz
becomesC:\\Test^ folder\\foo^ bar\\baz
.✍ Tip: Please read this solution for the Powershell profile.
-
shellArgs: ['/k', 'cd /d D:\\Custom^ Folder & title Cmder & %CMDER_ROOT%\\vendor\\init.bat'],
To run Cmder Canary with Hyper instead of ConEmu, follow these steps:
-
Download and install the latest canary version of Hyper for Windows: download page
✍ Tip: It will look something like
Hyper-(version)-canary.(release).exe
-
Follow the instructions in this page to set-up the
%CMDER_ROOT%
environmental variable
✍ Tip: If you already have a working environment variable, skip this step -
Open Hyper Canary terminal, then press Ctrl + , (Control-Comma) to open the Preferences settings file.
✍ Tip: You can also open the file directly from
%userprofile%\AppData\Roaming\Hyper\hyper.json
.The settings file will be opened for edit with your default text editor program.
-
Navigate to the near the middle of the configuration file,
look for and modify the variables according to the values provided below:
"shell": "cmd.exe",
"shellArgs": ["/k", "[cmder_root]\\vendor\\init.bat"],
"env": {"TERM":"cygwin"},
👉 Note: Substitute [cmder_root]
with your Cmder installation directory, e.g. C:\apps\cmder
or %CMDER_ROOT%
.
✍ Tip: Make sure to define the environment variable before using %CMDER_ROOT%
as the [cmder_root]
portion.
- (Important) To remain on the canary builds, change this flag at the top of your .json file:
"config": {
"updateChannel": "canary", //change from release to canary
- (Optional) In the
plugins
array, add the following plugins to use the Monokai color scheme and get a more Cmder-like user interface:
"hyperterm-monokai",
"hyper-tab-icons",
"hyper-statusline"
-
(Optional) Additional configuration
-
You can set the tab name as follows:
"shellArgs": ["/k", "Title CMDER & %CMDER_ROOT%\\vendor\\init.bat"],
-
To start Hyper in a custom default directory, you can use the following configuration
"shellArgs": ["/k", "cd /d D:\\Custom^ Folder & %CMDER_ROOT%\\vendor\\init.bat"],
⚠ Note: You must prepend a
^
symbol before all space characters in path, such thatC:\Test folder\foo bar\baz
becomesC:\\Test^ folder\\foo^ bar\\baz
.✍ Tip: Please read this solution for the Powershell profile.
-
"shellArgs": ["/k", "cd /d D:\\Custom^ Folder & title Cmder & %CMDER_ROOT%\\vendor\\init.bat"],
You may use a bash shell (available with Cmder full, and/or Cmder mini with Git, Cygwin or WSL:
👉 Note: The bash.exe
executable must be present in the %PATH%
environment variable.
Hyper Release:
shell: '[CMDER_ROOT]\\vendor\\git-for-windows\\bin\\bash.exe', // ... or path to Cygwin/WSL's bash
shellArgs: ['--login', '-i'],
env: { 'TERM':'cygwin' },
Hyper Canary:
"shell": "[CMDER_ROOT]\\vendor\\git-for-windows\\bin\\bash.exe", // ... or path to Cygwin/WSL's bash
"shellArgs": ["--login", "-i"],
"env": { "TERM":"cygwin" },
✍ Tip: If the environment variable doesn't work, replace [CMDER_ROOT]
with the actual path (e.g. C:\apps\cmder
) to specify the path to Cmder!
You can use Powershell instead of Cmder's default cmd/clink shell:
Hyper Release:
shell: 'C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe',
shellArgs: ['-ExecutionPolicy', 'Bypass', '-NoLogo', '-NoProfile', '-NoExit', '-Command', 'Invoke-Expression [CMDER_ROOT]\\vendor\\profile.ps1'],
env: { 'TERM':'cygwin' },
Hyper Canary:
"shell": "C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe",
"shellArgs": ["-ExecutionPolicy", "Bypass", "-NoLogo", "-NoProfile", "-NoExit", "-Command", "Invoke-Expression [CMDER_ROOT]\\vendor\\profile.ps1"],
"env": { "TERM":"cygwin" },
✍ Tip: If the environment variable doesn't work, replace [CMDER_ROOT]
with the actual path (e.g. C:\apps\cmder
) to specify the path to Cmder!
- Post a comment on the issue here and mention @DRSDavidSoft for help
Guide courtesy of @DRSDavidSoft (David Refoua)
Canary instructions appended by @ClarityAM (Aiden Montoya)