ELECTERM(1)

NAME

electerm📻Terminal/ssh/sftp/ftp/telnet/serialport/RDP/VNC/Spice client(linux, mac, win)

SYNOPSIS

$brew install --cask electerm

INFO

13.8k stars
1.1k forks
0 views

DESCRIPTION

📻Terminal/ssh/sftp/ftp/telnet/serialport/RDP/VNC/Spice client(linux, mac, win)

README

electerm Tweet

GitHub version Build Status license JavaScript Style Guide Get it from the Snap Store Get it from the Microsoft Store Debian Repository GitHub Sponsors Powered by manate

English 中文

DigitalOcean Referral Badge

Vercel OSS Program

Open-sourced terminal/ssh/sftp/telnet/serialport/RDP/VNC/Spice/ftp client(linux, mac, win).

For experienced developers, you may try the web app version running in browser(including mobile device): electerm-web or docker image for electerm-web

Online demo: https://electerm-demo.html5beta.com

Features

  • Works as a terminal/file manager or ssh/sftp/ftp/telnet/serialport/RDP/VNC/Spice client
  • Support Window 7+(X64/ARM64), Mac OS 10.15+(x64/arm64), Linux(x64/arm64), even old Linux with glibc 2.17+ like UOS/Kylin/Ubuntu 18.04 etc
  • Global hotkey to toggle window visibility (similar to guake, default is ctrl + 2)
  • Multi platform(linux, mac, win)
  • 🇺🇸 🇨🇳 🇧🇷 🇷🇺 🇪🇸 🇫🇷 🇹🇷 🇭🇰 🇯🇵 🇸🇦 🇩🇪 🇰🇷 🇮🇩 🇵🇱 Multi-language support(electerm-locales, contributions/fixes welcome)
  • Double click to directly edit (small) remote files.
  • Auth with publicKey + password.
  • Support Zmodem(rz, sz).
  • Support ssh tunnel.
  • Support Trzsz(trz/tsz), similar to rz/sz, and compatible with tmux.
  • Transparent window(Mac, win).
  • Terminal background image.
  • Global/session proxy.
  • Quick commands
  • UI/terminal theme
  • Sync bookmarks/themes/quick commands to github/gitee secret gist
  • Quick input to one or all terminals.
  • AI assistant integration (supporting DeepSeek, OpenAI, and other AI APIs) to help with command suggestions, script writing, and explaining selected terminal content
  • MCP (Model Context Protocol) widget for AI assistants and external tools integration - see MCP Widget Usage Guide
  • Deep link support: Open connections with URLs like telnet://192.168.2.31:34554 or ssh://user@host:22 - see Deep link support wiki
  • Command line usage: check wiki

Download

Install

  • 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 or .appImage 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.electerm

scoop https://github.com/lukesampson/scoop

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

  • Install from Debian repository (for Debian/Ubuntu-based systems) with apt command

Check https://electerm-repos.html5beta.com/deb

  • Install from npm
npm i -g electerm

After installation, it will immediately open for windows and linux,

For macOS, it will open the drag to install panel

Upgrade

  • Auto upgrade: When a new version is released, you will get an upgrade notification after you start electerm again. You can then 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 system, these systems may provide upgrades.

Known issues

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

Troubleshoot

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

Discussion

Discussion board

electerm-wechat-group-qr.jpg

Support

Would love to hear from you, please tell me what you think, submit an issue, Start a new discussion, create/fix language files or create pull requests, all welcome.

Sponsor this project

github sponsor

https://github.com/sponsors/electerm

kofi

https://ko-fi.com/zhaoxudong

wechat donate

wechat donate

Dev

# May only works in Linux
# needs nodejs/npm, suggest using nvm to install nodejs/npm
# with nodejs 22.x

git clone git@github.com:electerm/electerm.git cd electerm npm config set legacy-peer-deps true npm i

start vite dev server, requires port 5570

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 b
npm run prepare-test
cp .sample.env .env

edit .env, fill your test host/username/password, may only works in mac OS

npm run test

Test build

# May only works in Linux
# Install yarn first(to do yarn autoclean)
# See https://yarnpkg.com/en/docs/install

Build linux only with -l

npm i npm run b npm run pb ./node_modules/.bin/electron-builder --linux tar.gz

or replace tar.gz to rpm/deb/AppImage

check dist/ folder

build for linux arm/

./node_modules/.bin/electron-builder --linux --arm64

Video guide

Change log

Visit Releases.

License

MIT

Star History

Star History Chart

SEE ALSO

clihub3/4/2026ELECTERM(1)