VVTerm

Your servers. Everywhere.

VVTerm macOS

What is VVTerm?

VVTerm is an SSH terminal app for iOS and macOS. Connect to your servers from anywhere with iCloud sync, Keychain security, and a GPU-accelerated terminal.

Features

Terminal

GPU-accelerated — Powered by libghostty
Themes — Built-in color schemes with custom theme support
iOS keyboard — Toolbar with Esc, Tab, Ctrl, arrows, function keys

SSH

Auth methods — Password, SSH key, key with passphrase
Keychain storage — Credentials secured in system Keychain
Multiple tabs — Connect to several servers simultaneously

Sync

iCloud — Servers and workspaces sync across all devices
Keychain — Credentials stored locally, not synced

Organization

Workspaces — Group servers by project or team
Environments — Tag servers as Production, Staging, Dev
Color coding — Visual workspace identification

Voice

Voice-to-command — On-device speech-to-text
MLX Whisper/Parakeet — Local transcription, no cloud required

Requirements

macOS 13.0+ (Apple Silicon)
iOS 16.0+

Building from Source

Xcode 16.0+
Swift 5.0+
Zig (for building libghostty): brew install zig

git clone https://github.com/vivy-company/vvterm.git cd vvterm Build vendor libraries (GhosttyKit + libssh2/OpenSSL) ./scripts/build.sh all Open in Xcode and build

open VVTerm.xcodeproj

Installation

Pro Tier

Feature	Free	Pro
Workspaces	1	Unlimited
Servers	3	Unlimited
Tabs	1	Unlimited
Voice commands	-	Yes

Pricing: Monthly ($6.49), Yearly ($19.99), Lifetime ($29.99)

Architecture

VVTerm/
├── Models/                 # Server, Workspace, Environment
├── Managers/
│   ├── ServerManager       # Server/Workspace CRUD + sync
│   └── ConnectionSession   # Tab/connection lifecycle
├── Services/
│   ├── SSH/                # libssh2 wrapper
│   ├── CloudKit/           # iCloud sync
│   ├── Keychain/           # Credential storage
│   ├── Store/              # StoreKit 2 (Pro tier)
│   └── Audio/              # Voice-to-command
├── Views/
│   ├── Sidebar/            # Server list, workspaces
│   ├── Terminal/           # Terminal container
│   ├── Tabs/               # Connection tabs
│   └── Settings/           # All settings panels
└── GhosttyTerminal/        # libghostty wrapper

Patterns:

MVVM with @Observable
Actor model for concurrency
CloudKit for persistence
SwiftUI + async/await

Dependencies

libghostty — Terminal emulator
libssh2 — SSH protocol
OpenSSL — Cryptography

Third-Party Notices

See THIRD_PARTY_NOTICES.md.

Contributing

See CONTRIBUTING.md for contribution workflow and CLA.md for the required CLA process.

Security

See SECURITY.md for vulnerability reporting guidelines.

License

VVTerm uses a dual-license model:

Source code (this repository): GNU General Public License v3.0 (LICENSE)
Official App Store binaries: App Store EULA + VVTerm Terms (LICENSE-APPSTORE.md, https://vvterm.com/terms)

If you obtain VVTerm from source and build it yourself, GPL-3.0 applies. If you obtain VVTerm via Apple's App Store, App Store EULA terms apply to that binary distribution.

GNU General Public License v3.0

NAME

SYNOPSIS

INFO

DESCRIPTION

README