A cross-platform desktop terminal and connection manager, MobaXterm-style, built with PyQt6. Single-process desktop app — no server component.
Bifrost groups local shells, SSH sessions, WSL distros, and RDP entries into a tree of saved sessions, with a built-in SFTP browser that attaches to the same authenticated SSH channel as the terminal so file transfers don't require a second login.
Status: production-hardened desktop app. Core terminal, SSH, Telnet, Serial, VNC, external RDP launch, SFTP, credential storage, workspaces, themes, snippets, and persistence are covered by automated tests.
- Real VT100/xterm emulator —
pyte-backed, with 16-color + truecolor attributes, bold/italic/underline, configurable cursor shape (block / underline / bar), visible bell, scrollback via the mouse wheel. - Local PTY on every platform. POSIX uses
pty.fork(); Windows uses ConPTY viapywinpty. Same reader-thread model end-to-end. - SSH via
paramikowith an interactive host-key prompt that writes to~/.ssh/known_hostson accept, optional agent forwarding, configurable keepalive, and a connect thread so the GUI never blocks. - System-keyring credential storage (
python-keyring) for SSH passwords and key passphrases — never persisted tosessions.json. Save-on-success flow: only stores after the connection comes up clean. - SFTP browser sharing the terminal's
SSHClient(no second auth roundtrip). Drag-and-drop uploads, theme-aware file icons, optional external editor for remote files. - MultiExec & cluster mode — broadcast input to every open terminal tab, or scope it to a cluster (right-click a tab → Add to cluster; optionally auto-add new SSH tabs). Targeted viewports tint red while broadcasting.
- VNC viewer — in-process RFB client (3.3/3.7/3.8, None + VNC password auth, Raw/CopyRect encodings, DesktopSize resize) rendered in a tab with full mouse/keyboard forwarding. Password is prompted per-connect, never stored.
- RDP launcher — delegates to
mstscon Windows, Microsoft Remote Desktop URL handling on macOS, orxfreerdp/rdesktopon Linux. - Quick-connect toolbar with a method picker (SSH / Telnet / VNC / Local / WSL) and per-method input parsing.
- Wake-on-LAN — both per-session (right-click an SSH session with a
macfield set) and one-off from the toolbar. - Macros — record a sequence of keystrokes and replay them into the active terminal.
- Network/utility tools in the sidebar — port scanner, network scanner, IP calculator, SSH keypair generator (Ed25519, OpenSSH-format).
- Session tree with favorites, two-column rows, folder icons that swap on expand/collapse. Double-click a leaf to connect.
- Detach a tab into a standalone window without losing state.
pip install -r requirements.txtRuntime dependencies: PyQt6, psutil, pyte, paramiko, keyring; pywinpty on
Windows. Same set is declared in pyproject.toml so pip install . also
works.
Requires Python 3.10+.
python bifrost_app.py
# or, after `pip install .`
bifrost-cmAll state is written under QStandardPaths.AppConfigLocation for the
application name bifrost:
| Platform | Path |
|---|---|
| Linux | ~/.config/bifrost/ |
| macOS | ~/Library/Application Support/bifrost/ |
| Windows | %APPDATA%\bifrost\ |
Contents: sessions.json, macros.json, settings.json, bifrost.log.
Per-session shell transcripts (when auto_log is on) go to
./logs/<name>_<timestamp>.log in the current working directory.
JSON writes are atomic (tempfile + os.replace).
QT_QPA_PLATFORM=offscreen pytest -q
python -m compileall -q bifrost_app.py bifrost_app_deps.py core widgets
python -m pip wheel . --no-deps --no-build-isolation -w /tmp/bifrost-wheeltests/conftest.py already sets QT_QPA_PLATFORM=offscreen as a default and
exposes a qapp session fixture for tests that need a live QApplication.
Run a single test:
pytest tests/test_selection.py -q
pytest tests/test_selection.py::test_word_extends_url -qA PyInstaller spec is included for standalone bundles:
pip install pyinstaller
pyinstaller bifrost.specOutput is a onedir bundle in dist/bifrost/ (plus dist/Bifrost.app on
macOS). The spec ships res/icons/ as data and force-bundles the dynamic
keyring.backends so credential storage works in the frozen app.
core/— backend, persistence, OS integration. No Qt UI code beyondQFont/QStandardPaths.widgets/— PyQt6 UI components.bifrost_app.py—BifrostApp(QMainWindow), the single orchestrator and CLI entry point (main()).
See CLAUDE.md for the load-bearing architectural details (terminal stack
layering, key-routing/MultiExec contract, sidebar tab indexes, settings
plumbing).
- Passwords, key passphrases, and VNC passwords are never written to JSON.
- Session/workspace/settings writes are atomic.
- The wheel installs all split
bifrost_app*.pymodules and bundled Material SVG icons used by the UI. - Optional platform tools are detected at runtime:
ssh-agent, RDP clients, WSL, Docker, Kubernetes, serial support, and keyring providers.
Bifrost is licensed under the GNU General Public License v3.0 or later.
See LICENSE for the full text.
PyQt6 itself is GPL v3 (or commercial), which makes GPL v3 a natural fit for this project.
Bundled SVG icons under res/icons/material/ are from Google's
Material Symbols project,
distributed under the Apache License 2.0. See
NOTICE-THIRD-PARTY.md for the full list and the
modification note.