Skip to content

About

Native macOS ownCloud client with SwiftUI, File Provider virtual files, and support for large Spaces.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

WesomeCloud

A modern, native macOS client for ownCloud, built with Swift 6, SwiftUI, and Apple's File Provider framework.

We want to make large ownCloud Spaces practical on a Mac, even when they exceed its local storage. Virtual files let you browse remote folders in Finder and only download content when you need it. Files can stay downloaded for offline use or return to online-only storage to free up disk space. Selected Spaces appear as folders inside a single WesomeCloud location in Finder. Adding or removing a Space updates that location without changing the other Spaces.

On upgrading from a version that displayed dotted folder names as documents, the app rebuilds its Finder location once. Downloaded and unsynced Finder files are preserved outside the replacement location. In Finder, choose Go > Go to Folder and enter ~/Library/Containers/cloud.wesome.wesomecloud/Data/Library/Application Support/WesomeCloud/Preserved Finder Files. Open the private recovery notes there and use Go > Go to Folder with each recorded path. These notes are excluded from diagnostic exports. If saving a note fails, a local alert shows the copyable path and a Show in Finder action before the rebuild continues. Check the preserved files for local edits. Selected Spaces, sync caches, and queued uploads retain their existing storage IDs.

On upgrading from separate Finder locations, the app preserves downloaded and unsynced local files when retiring those locations. macOS returns their preserved location, which the app records in the same private recovery notes. Existing sync caches and upload queues keep their original storage IDs.

WesomeCloud showing accounts, Spaces, transfers, and file availability

Status

WesomeCloud is a prototype under active development. It includes Finder integration, on-demand downloads, offline operations, and ownCloud Infinite Scale Spaces support. Signed and notarized releases support Sparkle updates. Finder and synchronization behavior still need wider release validation. Use a test account and disposable files while evaluating it.

ownCloud credit

The ownCloud Desktop Client was a behavior and architecture reference for this native Swift implementation. Its source code was not copied or translated into WesomeCloud.

Credit goes to its authors and contributors for their work on synchronization, WebDAV, metadata journals, virtual files, and conflict handling. WesomeCloud adapts these concepts to a native macOS client using modern Apple technologies. It is an independent project and is not an official ownCloud client.

See NOTICE for attribution and third-party notices.

Build and run

Requirements:

  • macOS 15 or later.
  • Xcode 26 or later with Swift 6.2 or later. Select the full Xcode installation as the active developer directory.
  • XcodeGen to generate the app project.

Build and test the Swift package:

swift test
swift run wesomecloud

The command-line host checks that the client core and UI compile. To build the macOS app and its embedded File Provider extension:

brew install xcodegen
scripts/generate-xcode-project.sh
open WesomeCloud.xcodeproj

Choose the WesomeCloud scheme. Configure your own development team for both app and extension targets before running a signed build. The generated project is ignored; shared build settings belong in project.yml.

The app icon is rendered from docs/images/wesomecloud-icon-2.svg. After changing the SVG, run scripts/generate-app-icon.sh to refresh the asset catalog in AppHost/Assets.xcassets.

To validate an unsigned app build:

scripts/validate-packaging.sh --require-generated

An unsigned build verifies packaging; Finder integration needs a signed app and extension. Release a new version on the signing Mac with scripts/release patch --prepare --notes-file <changelog> after loading .envrc, then merge the preparation PR before building and publishing from main. See development and release notes for signing, notarization, and update configuration.

How it is built

SwiftUI provides the app interface. A replicated File Provider extension handles Finder integration and virtual files. WebDAV and ownCloud APIs provide remote file operations and Spaces discovery, SQLite stores synchronization metadata, and Keychain stores credentials. Sparkle supports signed automatic updates.

The architecture plan explains the design. Development notes describe the implemented behavior and remaining release work.

Contributing

See CONTRIBUTING.md for setup, validation, repository file policy, and attribution requirements. Report security issues as described in SECURITY.md.

License

WesomeCloud is free software licensed under the GNU General Public License, version 2 or, at your option, any later version (GPL-2.0-or-later), matching the ownCloud Desktop Client's license. You may redistribute and modify it under those terms. It comes without warranty, including any implied warranty of merchantability or fitness for a particular purpose. See LICENSE for the full text.

Upstream copyright and license notices remain applicable to copied or adapted material. Sparkle and its bundled components retain their own licenses, reproduced in docs/Sparkle-LICENSE.txt.

Troubleshooting sync and downloads

Use Sync Now in the main window to request a check of selected Spaces, then Export Diagnostics to create a ZIP you can inspect and share with support. A check follows changed folders; it is not a full scan of every server folder. The status shows the number of folders checked and the time of the latest result.

The app and File Provider extension keep a shared local diagnostic journal for up to seven days, capped at 10 MiB. It survives app restarts and does not depend on usage-tracking consent. The ZIP includes that history, app/macOS versions, selected Space references, Finder registration/health, sync errors, queued operations and transfer summaries. Paths, account names and item identifiers use stable hashed references; credentials and file contents are excluded. Server hostnames remain visible. Logs from before this version cannot be recovered by the export.

About

Native macOS ownCloud client with SwiftUI, File Provider virtual files, and support for large Spaces.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages