# martchus/syncthingtray architecture

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

- Interactive diagram: https://gitdiagram.com/martchus/syncthingtray
- Repository: https://github.com/martchus/syncthingtray

## Overview

Syncthing Tray is a multi-platform companion for monitoring and controlling a Syncthing instance, not a replacement for Syncthing’s web UI. The principal workflow is to connect through the shared connector, expose connection data as models, and present status and controls through a tray interface; the CLI and platform integrations offer additional entry points. The README also documents a native Plasma applet, Dolphin actions, Android support, a launcher, systemd integration, and web-view access. Some subsystem links are documented capabilities rather than inspected call paths.

Main entry points: [`syncthingconnector/syncthingconnection.cpp`](https://github.com/martchus/syncthingtray/blob/master/syncthingconnector/syncthingconnection.cpp) (Syncthing connector), [`tray/gui/traywidget.cpp`](https://github.com/martchus/syncthingtray/blob/master/tray/gui/traywidget.cpp) (Tray controls), [`syncthingwidgets/quick/app.cpp`](https://github.com/martchus/syncthingtray/blob/master/syncthingwidgets/quick/app.cpp) (Quick GUI), [`tray/application/main.cpp`](https://github.com/martchus/syncthingtray/blob/master/tray/application/main.cpp) (Tray application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["Connection and data"]
  node_connector["Syncthing connector"]
  node_models["Status models"]
end

subgraph group_desktop["Desktop interface"]
  node_trayapp["Tray application<br/>[main.cpp]"]
  node_traywidget["Tray controls<br/>[traywidget.cpp]"]
  node_trayicon["Tray icon and menu<br/>[trayicon.cpp]"]
  node_quickapp["Quick GUI<br/>[app.cpp]"]
  node_settings["Settings and setup<br/>[settingsdialog.cpp]"]
  node_webview["Syncthing web view<br/>[webpage.cpp]"]
  node_dialogs["Details and dialogs<br/>[otherdialogs.cpp]"]
end

subgraph group_integrations["Platform integrations"]
  node_launcher["Syncthing launcher"]
  node_systemd["Systemd integration"]
  node_plasmoid["Plasma applet"]
  node_dolphin["Dolphin actions"]
  node_androidui["Android app<br/>[app.cpp]"]
  node_androidservice["Android service"]
end

subgraph group_tools["Command-line tools"]
  node_cli["CLI application<br/>[application.cpp]"]
  node_cliargs["CLI arguments<br/>[args.cpp]"]
end

node_user(("User"))
node_syncthing["Syncthing"]
node_dolphinhost(("Dolphin file manager"))
node_plasmahost(("KDE Plasma"))
node_androidhost(("Android OS"))

node_user -->|"opens"| node_trayapp
node_trayapp -->|"creates"| node_trayicon
node_trayapp -->|"creates"| node_traywidget
node_trayicon -->|"exposes"| node_traywidget
node_user -->|"runs commands"| node_cli
node_cli -->|"parses"| node_cliargs
node_cli -->|"queries and controls"| node_connector
node_traywidget -.->|"controls"| node_connector
node_quickapp -->|"connects"| node_connector
node_connector -.->|"communicates with"| node_syncthing
node_connector -.->|"supplies status"| node_models
node_traywidget -->|"uses"| node_trayicon
node_quickapp -->|"opens"| node_dialogs
node_quickapp -->|"applies settings"| node_settings
node_settings -->|"configures"| node_launcher
node_settings -->|"configures"| node_systemd
node_user -->|"uses applet"| node_plasmoid
node_plasmahost -->|"hosts"| node_plasmoid
node_user -->|"selects items"| node_dolphinhost
node_dolphinhost -->|"invokes actions"| node_dolphin
node_user -->|"uses app"| node_androidui
node_androidhost -.->|"hosts service"| node_androidservice
node_androidui -->|"communicates with"| node_androidservice
node_user -->|"opens web UI"| node_webview

click node_connector "https://github.com/martchus/syncthingtray/blob/master/syncthingconnector/syncthingconnection.cpp"
click node_models "https://github.com/martchus/syncthingtray/blob/master/syncthingmodel/syncthingdevicemodel.cpp"
click node_trayapp "https://github.com/martchus/syncthingtray/blob/master/tray/application/main.cpp"
click node_traywidget "https://github.com/martchus/syncthingtray/blob/master/tray/gui/traywidget.cpp"
click node_trayicon "https://github.com/martchus/syncthingtray/blob/master/tray/gui/trayicon.cpp"
click node_quickapp "https://github.com/martchus/syncthingtray/blob/master/syncthingwidgets/quick/app.cpp"
click node_settings "https://github.com/martchus/syncthingtray/blob/master/syncthingwidgets/settings/settingsdialog.cpp"
click node_webview "https://github.com/martchus/syncthingtray/blob/master/syncthingwidgets/webview/webpage.cpp"
click node_dialogs "https://github.com/martchus/syncthingtray/blob/master/syncthingwidgets/misc/otherdialogs.cpp"
click node_launcher "https://github.com/martchus/syncthingtray/blob/master/syncthingwidgets/misc/syncthinglauncher.cpp"
click node_systemd "https://github.com/martchus/syncthingtray/blob/master/syncthingconnector/syncthingservice.cpp"
click node_plasmoid "https://github.com/martchus/syncthingtray/blob/master/plasmoid/lib/syncthingapplet.cpp"
click node_dolphin "https://github.com/martchus/syncthingtray/blob/master/fileitemactionplugin/syncthingfileitemaction.cpp"
click node_androidui "https://github.com/martchus/syncthingtray/blob/master/syncthingwidgets/quick/app.cpp"
click node_androidservice "https://github.com/martchus/syncthingtray/blob/master/tray/android/src/io/github/martchus/syncthingtray/SyncthingService.java"
click node_cli "https://github.com/martchus/syncthingtray/blob/master/cli/application.cpp"
click node_cliargs "https://github.com/martchus/syncthingtray/blob/master/cli/args.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_connector,node_models,node_user toneBlue
class node_trayapp,node_traywidget,node_trayicon,node_quickapp,node_settings,node_webview,node_dialogs toneAmber
class node_launcher,node_systemd,node_plasmoid,node_dolphin,node_androidui,node_androidservice toneMint
class node_cli,node_cliargs toneRose
class node_syncthing,node_dolphinhost,node_plasmahost,node_androidhost toneIndigo
```

## Components

### Connection and data

- [Syncthing connector](https://github.com/martchus/syncthingtray/blob/master/syncthingconnector/syncthingconnection.cpp): `syncthingconnector/syncthingconnection.cpp`
- [Status models](https://github.com/martchus/syncthingtray/blob/master/syncthingmodel/syncthingdevicemodel.cpp): `syncthingmodel/syncthingdevicemodel.cpp`

### Desktop interface

- [Tray application](https://github.com/martchus/syncthingtray/blob/master/tray/application/main.cpp): `tray/application/main.cpp`
- [Tray controls](https://github.com/martchus/syncthingtray/blob/master/tray/gui/traywidget.cpp): `tray/gui/traywidget.cpp`
- [Tray icon and menu](https://github.com/martchus/syncthingtray/blob/master/tray/gui/trayicon.cpp): `tray/gui/trayicon.cpp`
- [Quick GUI](https://github.com/martchus/syncthingtray/blob/master/syncthingwidgets/quick/app.cpp): `syncthingwidgets/quick/app.cpp`
- [Settings and setup](https://github.com/martchus/syncthingtray/blob/master/syncthingwidgets/settings/settingsdialog.cpp): `syncthingwidgets/settings/settingsdialog.cpp`
- [Syncthing web view](https://github.com/martchus/syncthingtray/blob/master/syncthingwidgets/webview/webpage.cpp): `syncthingwidgets/webview/webpage.cpp`
- [Details and dialogs](https://github.com/martchus/syncthingtray/blob/master/syncthingwidgets/misc/otherdialogs.cpp): `syncthingwidgets/misc/otherdialogs.cpp`

### Platform integrations

- [Syncthing launcher](https://github.com/martchus/syncthingtray/blob/master/syncthingwidgets/misc/syncthinglauncher.cpp): `syncthingwidgets/misc/syncthinglauncher.cpp`
- [Systemd integration](https://github.com/martchus/syncthingtray/blob/master/syncthingconnector/syncthingservice.cpp): `syncthingconnector/syncthingservice.cpp`
- [Plasma applet](https://github.com/martchus/syncthingtray/blob/master/plasmoid/lib/syncthingapplet.cpp): `plasmoid/lib/syncthingapplet.cpp`
- [Dolphin actions](https://github.com/martchus/syncthingtray/blob/master/fileitemactionplugin/syncthingfileitemaction.cpp): `fileitemactionplugin/syncthingfileitemaction.cpp`
- [Android app](https://github.com/martchus/syncthingtray/blob/master/syncthingwidgets/quick/app.cpp): `syncthingwidgets/quick/app.cpp`
- [Android service](https://github.com/martchus/syncthingtray/blob/master/tray/android/src/io/github/martchus/syncthingtray/SyncthingService.java): `tray/android/src/io/github/martchus/syncthingtray/SyncthingService.java`

### Command-line tools

- [CLI application](https://github.com/martchus/syncthingtray/blob/master/cli/application.cpp): `cli/application.cpp`
- [CLI arguments](https://github.com/martchus/syncthingtray/blob/master/cli/args.cpp): `cli/args.cpp`

### Other components

- **User**
- **Syncthing**
- **Dolphin file manager**
- **KDE Plasma**
- **Android OS**

## Connections

- User → Tray application: opens (evidence: `README.md`)
- Tray application → Tray icon and menu: creates (evidence: `tray/application/main.cpp`)
- Tray application → Tray controls: creates (evidence: `tray/application/main.cpp`)
- Tray icon and menu → Tray controls: exposes
- User → CLI application: runs commands (evidence: `README.md`)
- CLI application → CLI arguments: parses (evidence: `cli/application.cpp`)
- CLI application → Syncthing connector: queries and controls (evidence: `cli/application.cpp`)
- Tray controls → Syncthing connector: controls
- Quick GUI → Syncthing connector: connects (evidence: `syncthingwidgets/quick/app.cpp`)
- Syncthing connector → Syncthing: communicates with
- Syncthing connector → Status models: supplies status
- Tray controls → Tray icon and menu: uses (evidence: `tray/gui/traywidget.cpp`)
- Quick GUI → Details and dialogs: opens (evidence: `syncthingwidgets/quick/app.cpp`)
- Quick GUI → Settings and setup: applies settings
- Settings and setup → Syncthing launcher: configures (evidence: `syncthingwidgets/settings/settingsdialog.cpp`)
- Settings and setup → Systemd integration: configures (evidence: `syncthingwidgets/settings/settingsdialog.cpp`)
- User → Plasma applet: uses applet (evidence: `README.md`)
- KDE Plasma → Plasma applet: hosts (evidence: `README.md`)
- User → Dolphin file manager: selects items (evidence: `README.md`)
- Dolphin file manager → Dolphin actions: invokes actions (evidence: `README.md`)
- User → Android app: uses app (evidence: `README.md`)
- Android OS → Android service: hosts service
- Android app → Android service: communicates with
- User → Syncthing web view: opens web UI (evidence: `README.md`)
