# basvodde/filezilla architecture

> Architecture diagram of the GitHub repository basvodde/filezilla, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/basvodde/filezilla
- Repository: https://github.com/basvodde/filezilla

## Overview

FileZilla Client is a desktop FTP/FTPS/SFTP file-transfer application. The principal workflow is selecting a server and local/remote files, issuing commands through the engine, and observing transfer-queue results. The engine dispatches protocol-specific control sockets and uses shared operation, cache, and rate-limiting facilities. The README documents additional user capabilities represented as distinct interface branches. Some implementation files were not sampled, so links for those features are documented rather than asserted as inspected call paths.

Main entry points: [`src/engine/FileZillaEngine.cpp`](https://github.com/basvodde/filezilla/blob/master/src/engine/FileZillaEngine.cpp) (Engine API), [`src/engine/engineprivate.cpp`](https://github.com/basvodde/filezilla/blob/master/src/engine/engineprivate.cpp) (Command dispatcher), [`src/engine/sftpcontrolsocket.cpp`](https://github.com/basvodde/filezilla/blob/master/src/engine/sftpcontrolsocket.cpp) (SFTP), [`src/engine/ftpcontrolsocket.cpp`](https://github.com/basvodde/filezilla/blob/master/src/engine/ftpcontrolsocket.cpp) (FTP and FTPS)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop interface"]
  node_main["Main window<br/>[Mainfrm.cpp]"]
  node_sites["Site Manager<br/>[sitemanager.cpp]"]
  node_local["Local browser<br/>[LocalListView.cpp]"]
  node_remote["Remote browser<br/>[RemoteListView.cpp]"]
  node_queue["Transfer queue<br/>[queue.cpp]"]
  node_queue_store[("Queue persistence<br/>[queue_storage.cpp]")]
end

subgraph group_engine["Transfer engine"]
  node_engine_api["Engine API"]
  node_dispatcher["Command dispatcher<br/>[engineprivate.cpp]"]
  node_control["Control socket<br/>[ControlSocket.h]"]
  node_directory["Directory listings"]
  node_cache[("Directory cache<br/>[directorycache.h]")]
end

subgraph group_protocol["Protocol handling"]
  node_ftp["FTP and FTPS"]
  node_sftp["SFTP"]
  node_http["HTTP control"]
  node_ssh["SSH transport<br/>[ssh.c]"]
  node_proxy["Proxy support<br/>[proxy.cpp]"]
end

subgraph group_support["Client capabilities"]
  node_file_transfer["Local file access<br/>[local_filesys.cpp]"]
  node_search["Remote search<br/>[search.cpp]"]
  node_compare["Directory comparison"]
  node_edit["Remote editing<br/>[edithandler.cpp]"]
  node_filters["Filename filters<br/>[filter.cpp]"]
  node_settings["Client settings<br/>[Options.cpp]"]
end

node_user(("User"))
node_server(("File server"))

node_user -->|"uses"| node_main
node_user -->|"selects server"| node_sites
node_user -->|"selects files"| node_local
node_main -.->|"issues commands"| node_engine_api
node_sites -.->|"connects"| node_engine_api
node_local -.->|"queues transfers"| node_queue
node_queue -->|"persists queue"| node_queue_store
node_engine_api -->|"dispatches commands"| node_dispatcher
node_engine_api -->|"looks up listings"| node_cache
node_dispatcher -->|"creates for FTP"| node_ftp
node_dispatcher -->|"creates for SFTP"| node_sftp
node_dispatcher -->|"uses control socket"| node_control
node_dispatcher -.->|"creates HTTP control"| node_http
node_ftp -->|"transfers files"| node_server
node_sftp -->|"transfers files"| node_server
node_sftp -.->|"uses SSH transport"| node_ssh
node_ftp -.->|"supports proxy"| node_proxy
node_sftp -.->|"supports proxy"| node_proxy
node_ftp -.->|"parses listings"| node_directory
node_sftp -.->|"parses listings"| node_directory
node_directory -.->|"updates cache"| node_cache
node_queue -.->|"runs transfers"| node_engine_api
node_engine_api -.->|"accesses local files"| node_file_transfer
node_user -->|"searches remotely"| node_search
node_user -->|"compares folders"| node_compare
node_user -->|"edits remote files"| node_edit
node_user -->|"filters listings"| node_filters
node_user -.->|"sets preferences"| node_settings

click node_main "https://github.com/basvodde/filezilla/blob/master/src/interface/Mainfrm.cpp"
click node_sites "https://github.com/basvodde/filezilla/blob/master/src/interface/sitemanager.cpp"
click node_local "https://github.com/basvodde/filezilla/blob/master/src/interface/LocalListView.cpp"
click node_remote "https://github.com/basvodde/filezilla/blob/master/src/interface/RemoteListView.cpp"
click node_queue "https://github.com/basvodde/filezilla/blob/master/src/interface/queue.cpp"
click node_queue_store "https://github.com/basvodde/filezilla/blob/master/src/interface/queue_storage.cpp"
click node_engine_api "https://github.com/basvodde/filezilla/blob/master/src/engine/FileZillaEngine.cpp"
click node_dispatcher "https://github.com/basvodde/filezilla/blob/master/src/engine/engineprivate.cpp"
click node_control "https://github.com/basvodde/filezilla/blob/master/src/engine/ControlSocket.h"
click node_directory "https://github.com/basvodde/filezilla/blob/master/src/engine/directorylistingparser.cpp"
click node_cache "https://github.com/basvodde/filezilla/blob/master/src/engine/directorycache.h"
click node_ftp "https://github.com/basvodde/filezilla/blob/master/src/engine/ftpcontrolsocket.cpp"
click node_sftp "https://github.com/basvodde/filezilla/blob/master/src/engine/sftpcontrolsocket.cpp"
click node_http "https://github.com/basvodde/filezilla/blob/master/src/engine/httpcontrolsocket.cpp"
click node_ssh "https://github.com/basvodde/filezilla/blob/master/src/putty/ssh.c"
click node_proxy "https://github.com/basvodde/filezilla/blob/master/src/engine/proxy.cpp"
click node_file_transfer "https://github.com/basvodde/filezilla/blob/master/src/engine/local_filesys.cpp"
click node_search "https://github.com/basvodde/filezilla/blob/master/src/interface/search.cpp"
click node_compare "https://github.com/basvodde/filezilla/blob/master/src/interface/listingcomparison.cpp"
click node_edit "https://github.com/basvodde/filezilla/blob/master/src/interface/edithandler.cpp"
click node_filters "https://github.com/basvodde/filezilla/blob/master/src/interface/filter.cpp"
click node_settings "https://github.com/basvodde/filezilla/blob/master/src/interface/Options.cpp"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_sites,node_local,node_remote,node_queue,node_queue_store,node_user toneBlue
class node_engine_api,node_dispatcher,node_control,node_directory,node_cache toneAmber
class node_ftp,node_sftp,node_http,node_ssh,node_proxy,node_server toneMint
class node_file_transfer,node_search,node_compare,node_edit,node_filters,node_settings toneRose
```

## Components

### Desktop interface

- [Main window](https://github.com/basvodde/filezilla/blob/master/src/interface/Mainfrm.cpp): `src/interface/Mainfrm.cpp`
- [Site Manager](https://github.com/basvodde/filezilla/blob/master/src/interface/sitemanager.cpp): `src/interface/sitemanager.cpp`
- [Local browser](https://github.com/basvodde/filezilla/blob/master/src/interface/LocalListView.cpp): `src/interface/LocalListView.cpp`
- [Remote browser](https://github.com/basvodde/filezilla/blob/master/src/interface/RemoteListView.cpp): `src/interface/RemoteListView.cpp`
- [Transfer queue](https://github.com/basvodde/filezilla/blob/master/src/interface/queue.cpp): `src/interface/queue.cpp`
- [Queue persistence](https://github.com/basvodde/filezilla/blob/master/src/interface/queue_storage.cpp): `src/interface/queue_storage.cpp`

### Transfer engine

- [Engine API](https://github.com/basvodde/filezilla/blob/master/src/engine/FileZillaEngine.cpp): `src/engine/FileZillaEngine.cpp`
- [Command dispatcher](https://github.com/basvodde/filezilla/blob/master/src/engine/engineprivate.cpp): `src/engine/engineprivate.cpp`
- [Control socket](https://github.com/basvodde/filezilla/blob/master/src/engine/ControlSocket.h): `src/engine/ControlSocket.h`
- [Directory listings](https://github.com/basvodde/filezilla/blob/master/src/engine/directorylistingparser.cpp): `src/engine/directorylistingparser.cpp`
- [Directory cache](https://github.com/basvodde/filezilla/blob/master/src/engine/directorycache.h): `src/engine/directorycache.h`

### Protocol handling

- [FTP and FTPS](https://github.com/basvodde/filezilla/blob/master/src/engine/ftpcontrolsocket.cpp): `src/engine/ftpcontrolsocket.cpp`
- [SFTP](https://github.com/basvodde/filezilla/blob/master/src/engine/sftpcontrolsocket.cpp): `src/engine/sftpcontrolsocket.cpp`
- [HTTP control](https://github.com/basvodde/filezilla/blob/master/src/engine/httpcontrolsocket.cpp): `src/engine/httpcontrolsocket.cpp`
- [SSH transport](https://github.com/basvodde/filezilla/blob/master/src/putty/ssh.c): `src/putty/ssh.c`
- [Proxy support](https://github.com/basvodde/filezilla/blob/master/src/engine/proxy.cpp): `src/engine/proxy.cpp`

### Client capabilities

- [Local file access](https://github.com/basvodde/filezilla/blob/master/src/engine/local_filesys.cpp): `src/engine/local_filesys.cpp`
- [Remote search](https://github.com/basvodde/filezilla/blob/master/src/interface/search.cpp): `src/interface/search.cpp`
- [Directory comparison](https://github.com/basvodde/filezilla/blob/master/src/interface/listingcomparison.cpp): `src/interface/listingcomparison.cpp`
- [Remote editing](https://github.com/basvodde/filezilla/blob/master/src/interface/edithandler.cpp): `src/interface/edithandler.cpp`
- [Filename filters](https://github.com/basvodde/filezilla/blob/master/src/interface/filter.cpp): `src/interface/filter.cpp`
- [Client settings](https://github.com/basvodde/filezilla/blob/master/src/interface/Options.cpp): `src/interface/Options.cpp`

### Other components

- **User**
- **File server**

## Connections

- User → Main window: uses (evidence: `README`)
- User → Site Manager: selects server (evidence: `README`)
- User → Local browser: selects files (evidence: `README`)
- Main window → Engine API: issues commands
- Site Manager → Engine API: connects
- Local browser → Transfer queue: queues transfers
- Transfer queue → Queue persistence: persists queue (evidence: `src/interface/queue_storage.cpp`)
- Engine API → Command dispatcher: dispatches commands (evidence: `src/engine/FileZillaEngine.cpp`)
- Engine API → Directory cache: looks up listings (evidence: `src/engine/FileZillaEngine.cpp`)
- Command dispatcher → FTP and FTPS: creates for FTP (evidence: `src/engine/engineprivate.cpp`)
- Command dispatcher → SFTP: creates for SFTP (evidence: `src/engine/engineprivate.cpp`)
- Command dispatcher → Control socket: uses control socket (evidence: `src/engine/engineprivate.cpp`)
- Command dispatcher → HTTP control: creates HTTP control
- FTP and FTPS → File server: transfers files (evidence: `README`)
- SFTP → File server: transfers files (evidence: `README`)
- SFTP → SSH transport: uses SSH transport
- FTP and FTPS → Proxy support: supports proxy
- SFTP → Proxy support: supports proxy
- FTP and FTPS → Directory listings: parses listings
- SFTP → Directory listings: parses listings
- Directory listings → Directory cache: updates cache
- Transfer queue → Engine API: runs transfers
- Engine API → Local file access: accesses local files
- User → Remote search: searches remotely (evidence: `README`)
- User → Directory comparison: compares folders (evidence: `README`)
- User → Remote editing: edits remote files (evidence: `README`)
- User → Filename filters: filters listings (evidence: `README`)
- User → Client settings: sets preferences
