OmniTerm
A cross-platform terminal built with PyQt6. OmniTerm gives you SSH, serial, local, and Unix-like "Home" shell sessions in a tabbed interface, an integrated SFTP file browser, encrypted credential storage, a native terminal renderer, and a headless CLI for scripts and agents.
Features
- Multiple session types — SSH (password or key auth), serial (configurable baud / data bits / parity / stop bits), local PTY shells, and a MobaXterm-style "Home" Unix shell.
- Native terminal renderer —
pytescreen model drawn directly withQPainter(no embedded browser): smooth output, minimal input latency, true 256/true-color, and a real alternate-screen buffer for vi/htop/btop. - Tabbed sessions with a sidebar session tree (folders), drag-to-reorder, split view (2/4 panes), and saveable layouts.
- Integrated SFTP browser that attaches automatically to SSH sessions: navigate, drag-and-drop, double-click a remote file to edit it locally and sync changes back, and transfer with a progress bar.
- Shadow command prediction (opt-in) — inline suggestions of your next command from your own history; accept with Ctrl+F / End / →. Secrets are never suggested or stored.
- Ergonomics — copy-on-select, full clipboard support, keyboard text selection, bracketed paste (clean pastes into vim), and Ctrl+wheel font zoom.
- Encrypted credentials — passwords stored with Fernet encryption, optionally protected by a master password (PBKDF2-HMAC-SHA256).
- Headless CLI (
omniterm-cli) — drive sessions, remote command execution, and SFTP from scripts and agents without the GUI (see below).
Installation
pip install omniterm
Usage
Launch the GUI:
omniterm
Command-line interface (headless)
omniterm-cli controls OmniTerm's capabilities without the GUI — ideal for
scripts, automation, and AI agents. It reuses the sessions you've saved in the
app. Every command supports --json.
# Sessions
omniterm-cli session list --json
omniterm-cli session add prod --host example.com --user deploy \
--auth key --key-path ~/.ssh/id_ed25519
omniterm-cli session show prod
# Run a remote command (captures stdout/stderr, propagates the exit code)
omniterm-cli exec prod "systemctl is-active nginx" --json
# SFTP
omniterm-cli sftp ls prod /var/log --json
omniterm-cli sftp get prod /var/log/app.log ./
omniterm-cli sftp put prod ./build.tar.gz /tmp/
# Interactive REPL
omniterm-cli repl
Driving a running GUI
If the OmniTerm window is open, omniterm-cli ctl … controls it live over a
token-authenticated localhost socket:
omniterm-cli ctl ping
omniterm-cli ctl open --type ssh --session prod
omniterm-cli ctl run --tab 0 --text "uname -a"
omniterm-cli ctl capture --tab 0 # read the tab's output back
omniterm-cli ctl list-tabs --json
Set OMNITERM_NO_CONTROL=1 to disable the control socket.
For agent use, a SKILL.md describes the whole interface for
discovery. The CLI imports no PyQt, so it runs anywhere — no display required.
Development
git clone https://github.com/fbobe321/omniterm
cd omniterm
pip install -e .
python -m omniterm.main # GUI
python -m omniterm.cli --help # CLI
# Tests (headless)
QT_QPA_PLATFORM=offscreen python -m pytest tests/
License
MIT — see LICENSE.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file omniterm-0.1.93.tar.gz.
File metadata
- Download URL: omniterm-0.1.93.tar.gz
- Upload date:
- Size: 638.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7a56bfadd4314e38fd61c3e0ecb1e8308d0d8fd99f367a3f16ef2741d83d14c7
|
|
| MD5 |
2824264a177e845d9f4c008e1c140296
|
|
| BLAKE2b-256 |
8628aec36a39b2ea64807258485c34df1592f0b7893b0c10a01175b17ac7c4c8
|
File details
Details for the file omniterm-0.1.93-py3-none-any.whl.
File metadata
- Download URL: omniterm-0.1.93-py3-none-any.whl
- Upload date:
- Size: 634.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
170701b3c5ed70b478ac38f3599f4036f2bb56c62e5cfd4613f6532ab28e5881
|
|
| MD5 |
5c8270d0977a95c8be7f0ca46a2f07c9
|
|
| BLAKE2b-256 |
3ed327a82750fe5be90f09284f2bdc7904863a568deab5d979eb5dd4c7307b86
|
