Go Green Transit Documentation¶
A unified desktop file-transfer client for fifteen protocols — SFTP, FTP, FTPS, WebDAV, SMB, NFS, Azure Files, S3, Backblaze B2, Azure Blob, GCS, Dropbox, Google Drive, OneDrive, Box — with built-in bidirectional sync, scheduling, multi-step jobs, a localhost API, MCP server, and CLI for automation.
Quick links¶
- User guide — connect flows, layouts, context menus, keyboard shortcuts, jobs.
- API reference — every endpoint the localhost bridge exposes for scripts and other apps.
- Architecture — how the binary is laid out, transport plugin model, scheduler internals.
- Changelog — version history.
What is Go Green Transit?¶
A single Tauri 2 desktop binary that replaces the suite of competing clients you'd otherwise have to juggle today. Go Green Transit does NOT bundle, embed, or depend on any of these — it gives you one consistent app instead:
| If you currently use… | Go Green Transit replaces it for |
|---|---|
| FileZilla | FTP / SFTP |
| Cyberduck | WebDAV |
AWS Console (or aws s3 cp) |
Amazon S3 + Glacier restore |
| Azure Storage Explorer | Azure Blob + Azure Files |
| The Dropbox / Google Drive / OneDrive / Box desktop clients | OAuth + local-sync access to all four |
mount.nfs / Services for NFS by hand |
NFS — Amazon EFS / FSx OpenZFS / Storage Gateway NFS |
| Backblaze's web console | Backblaze B2 (S3-compatible) |
You get consistent UX, a single Site Manager, scheduled syncs that go through the same code paths as manual transfers, plus three programmable surfaces — a localhost REST + WebSocket bridge, an MCP server for AI assistants, and a CLI — so other local tools and agents can drive it too.
Pure-Rust transports: SFTP uses russh, FTP uses suppaftp, WebDAV uses reqwest,
S3 / B2 use the AWS SDK, Azure uses azure_storage_blobs, and so on. SMB / NFS use the
OS-native client (mount-and-proxy strategy — same as Cyberduck / WinSCP / FileZilla do for
SMB). No third-party FTP/cloud client is invoked.
At a glance¶
| Capability | Detail |
|---|---|
| Protocols | 15 (see above) — including NFS for Amazon EFS / FSx OpenZFS / FSx NetApp NFS / Storage Gateway NFS, and Backblaze B2 (S3-compatible) |
| Auth | Password, SSH key, OAuth 2.0 (Dropbox / Drive / OneDrive), connection string (Azure), service-account JSON (GCS), local-sync (Box / Dropbox / Drive / OneDrive desktop clients, auto-detected on first launch) |
| Credentials | OS keychain — passwords + tokens never written to disk in plaintext |
| Sites at rest | sites.json sealed with AES-256-GCM; key in OS keychain (per-data-dir file fallback). Tampered or wrong-key files archived for recovery, never silently overwritten |
| Accessibility | WCAG 2.1 AA — full keyboard nav, focus-visible accent outlines, ARIA landmarks + live-regions, prefers-reduced-motion respect; pinned by 13 automated a11y tests |
| Sync | Bidirectional sync (Mirror / Upload / Download) with overwrite-if-newer policy, Dry Run preview, max-depth control. Same engine the scheduler + CLI use |
| Scheduling | Cron + start/end window, calendar UI, audit history |
| Jobs | Multi-step workflows (folder-sync · file-sync · wait · webhook) |
| Cold-archive | S3 Glacier / Deep Archive restore via right-click — pre-checks storage class for friendly errors |
| Sharing | Right-click → Get share link… on Dropbox / Google Drive / OneDrive (auto-copies URL) |
| Preview | Inline text / code / image / PDF preview + hex dump for binaries (5 MB cap) |
| Edit-with | Right-click → open in default editor; file-watcher auto-uploads on save (4 h TTL) |
| Templates | Built-in catalog + user JSON in <data dir>/templates/*.json for custom S3-compatible providers |
| Bandwidth | Global rate cap in Settings + per-site extras.bandwidth_kib override (independent caps per concurrent session via tokio task-local) |
| Programmable surfaces | Bearer-token-gated REST + WS bridge on 127.0.0.1:7878 · MCP server (Claude / ChatGPT) · CLI |
| Drag-and-drop | Cross-pane within the app + native OS drop into the panes |
| Notifications | Slack, Discord, Telegram, generic webhooks |
| View options | Hidden-files toggle (Ctrl+H) hides desktop.ini, Thumbs.db, .DS_Store, dotfiles across every protocol |
Install¶
Currently Windows only (MSI installer). macOS and Linux builds in progress.