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

Finasia/electerm