electerm

Terminal/ssh/sftp client(linux, mac, win) based on electron/ssh2/node-pty/xterm/antd/subx and other libs.

Features

• Work as a terminal/file manager or ssh/sftp client(similar to xshell)
• Global hotkey to toggle window visibility (simliar to guake, default is ctrl + 2)
• Multi platform(linux, mac, win)
• 🇺🇸 🇨🇳 🇧🇷 🇷🇺 🇪🇸 🇫🇷 🇹🇷 🇭🇰 🇯🇵 Support multi-language(electerm-locales, contribute/fix welcome)
• Double click to directly edit remote file(small ones).
• Edit local file with built-in editor(small ones).
• Auth with publickey + password.
• Zmodem(rz, sz).
• Transparent window(Mac, win).
• Terminal background image.
• Global/session proxy.
• Quick commands
• Sync bookmarks/themes/quick commands to github/gitee secret gist
• Serial Port support(removed after version 1.10.14)
• Quick input to one or all terminal
• Command line usage: check wiki
• Zip and transfer folder and auto unzip

Download/install

• https://electerm.github.io/electerm
• From release: https://github.com/electerm/electerm/releases
• For Mac user: brew install --cask electerm
• With snap: sudo snap install electerm --classic
• For some Linux distribution, you can find it from OS default App store(Ubuntu, Deepin, Mint...).
• For some linux OS, the rpm, deb, or snap release may not work, you can try the tar.gz release.
• For Windows users, you can install it from windows store, command-line installer winget and scoop is also recommended:

# winget https://github.com/microsoft/winget-cli
winget install electerm

# scoop https://github.com/lukesampson/scoop
scoop bucket add dorado https://github.com/chawyehsu/dorado
scoop install dorado/electerm

• Install from npm

npm i -g electerm

# after install it will open at once for windows and linux,
# for mac, will open the drag to install panel

Upgrade

• Auto upgrade: When new version released, you will get upgrade notification after you start electerm again, then you click the upgrade button to upgrade.
• Download: Just download the latest edition, reinstall.
• Npm: If you install from npm, just run npm i -g electerm again.
• If use Snap or some other distribution systems, these systems may provide upgrade.

Known issues

https://github.com/electerm/electerm/wiki/Know-issues

Troubleshoot

https://github.com/electerm/electerm/wiki/Troubleshoot

Support

Without users's feedbacks/suggestions/pull requests/language files, this project would not get this far, would love to hear from you, please tell me what you think, submit an issue, send me an email, create/fix language files or create pull requests, all welcome.

Dev

# tested in ubuntu16.04+/mac os 10.13+ only
# need nodejs/npm, suggest using nvm to install nodejs/npm
# https://github.com/creationix/nvm
# with node 8.6+

git clone git@github.com:electerm/electerm.git
cd electerm
npm i

# start webpack dev server, requires 5570 port
npm start

# in a separate terminal session run app
npm run app

# code format check
npm run lint

# code format fix
npm run fix

Test

npm run pre-test
cp .sample.env .env
# then edit .env, fill your test host/username/password
npm run test

Test build

# Tested only in ubuntu 16.04 x64+
# Install yarn first(to do yarn autoclean)
# See https://yarnpkg.com/en/docs/install

# Build linux only with -l
npm i
npm run pre-test
npm run release -l
# visit dist/

Use

• Set autorun when login to os

Change log

Visit Releases.

License

MIT