How opencloud-eu/desktop works
Project Type and Purpose
• OpenCloud Desktop is a native desktop client (C++/Qt) for synchronizing files between a local machine and an OpenCloud server. It provides both a GUI (Qt Widgets + QML) and CLI interface, a background sync engine, OS‐level shell integrations, crash reporting, and packaging scripts.
File‐Structure Analysis
• Top‐level “src/” contains all code:
• src/gui – Qt‐based desktop UI, dialogs, QML components, system tray, notifications
• src/libsync – core synchronization library: job queue, network jobs, credential managers, filesystem abstractions, sync engine
• src/csync – low‐level file‐diff and transfer library
• src/common – shared utilities (checksum, VFS, plugin loader, restart manager)
• src/crashreporter – post‐crash analytics tool
• src/cmd – command‐line client front‐end
• src/plugins – VFS plugin stubs
• shell_integration/… – OS‐specific hooks (FinderSync on macOS, Explorer overlays & context menus on Windows)
• Build and packaging: CMakeLists.txt at root, “admin/” and “.github/workflows/” for CI and installer generation, “.woodpecker/” and packaging scripts for multiple platforms.
README Insights
• Confirms purpose as a file‐sync tool for OpenCloud servers
• Mentions community contributions, binary releases, and licensing
• No architecture section, so rely on directory conventions