How martchus/syncthingtray works
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: syncthingconnection.cpp Syncthing connector · traywidget.cpp Tray controls · app.cpp Quick GUI · main.cpp Tray application
Components 22
Connection and data
- Syncthing connector
syncthingconnector/syncthingconnection.cpp - Status models
syncthingmodel/syncthingdevicemodel.cpp
Desktop interface
- Tray application
tray/application/main.cpp - Tray controls
tray/gui/traywidget.cpp - Tray icon and menu
tray/gui/trayicon.cpp - Quick GUI
syncthingwidgets/quick/app.cpp - Settings and setup
syncthingwidgets/settings/settingsdialog.cpp - Syncthing web view
syncthingwidgets/webview/webpage.cpp - Details and dialogs
syncthingwidgets/misc/otherdialogs.cpp
Platform integrations
- Syncthing launcher
syncthingwidgets/misc/syncthinglauncher.cpp - Systemd integration
syncthingconnector/syncthingservice.cpp - Plasma applet
plasmoid/lib/syncthingapplet.cpp - Dolphin actions
fileitemactionplugin/syncthingfileitemaction.cpp - Android app
syncthingwidgets/quick/app.cpp - Android service
tray/android/src/io/github/martchus/syncthingtray/SyncthingService.java
Command-line tools
- CLI application
cli/application.cpp - CLI arguments
cli/args.cpp
Other components
- User
- Syncthing
- Dolphin file manager
- KDE Plasma
- Android OS
Connections 24
- User → Tray application: opens
README.md - Tray application → Tray icon and menu: creates
tray/application/main.cpp - Tray application → Tray controls: creates
tray/application/main.cpp - Tray icon and menu → Tray controls: exposes
- User → CLI application: runs commands
README.md - CLI application → CLI arguments: parses
cli/application.cpp - CLI application → Syncthing connector: queries and controls
cli/application.cpp - Tray controls → Syncthing connector: controls
- Quick GUI → Syncthing connector: connects
syncthingwidgets/quick/app.cpp - Syncthing connector → Syncthing: communicates with
- Syncthing connector → Status models: supplies status
- Tray controls → Tray icon and menu: uses
tray/gui/traywidget.cpp - Quick GUI → Details and dialogs: opens
syncthingwidgets/quick/app.cpp - Quick GUI → Settings and setup: applies settings
- Settings and setup → Syncthing launcher: configures
syncthingwidgets/settings/settingsdialog.cpp - Settings and setup → Systemd integration: configures
syncthingwidgets/settings/settingsdialog.cpp - User → Plasma applet: uses applet
README.md - KDE Plasma → Plasma applet: hosts
README.md - User → Dolphin file manager: selects items
README.md - Dolphin file manager → Dolphin actions: invokes actions
README.md - User → Android app: uses app
README.md - Android OS → Android service: hosts service
- Android app → Android service: communicates with
- User → Syncthing web view: opens web UI
README.md