Skip to content

macOS virtual files client article update for release 33.0.0#14055

Merged
i2h3 merged 2 commits intomasterfrom
macos-vfs-update
Mar 24, 2026
Merged

macOS virtual files client article update for release 33.0.0#14055
i2h3 merged 2 commits intomasterfrom
macos-vfs-update

Conversation

@i2h3
Copy link
Copy Markdown
Contributor

@i2h3 i2h3 commented Feb 10, 2026

This must NOT be integrated or published before we have released the Nextcloud desktop client 33.0.0! It can be reviewed already, though. Our 33.0.0 now is published! 🥳

This will close #13904.

Changes

  • Removed obsolete information about the different macOS builds for classic synchronization and file provider extension because we now have only one universal macOS client left.
  • Clarified the conflict between the classic folder synchronization integration and file provider extension.
  • Removed specific installation information because it is redundant with the general client installation documentation.
  • Shifted the terminology a bit towards "file provider extension" instead of "virtual files" because the former is the official terminology used by Apple and macOS for this kind of software and what users are more likely to understand. macOS also uses this terminology in its system settings where our integration is listed.
  • Clarified the benefits of enabling push notifications on the server side.
  • Updated feature list.
  • Updated screenshots. The user interface has changed significantly. The screenshots now have a consistent appearance. The screenshots were taken on macOS 26 Tahoe which is the latest major release as off writing. This shows that our support of macOS is up to date. Also dedicated demo content and user account was used.
  • Screenshots are now in optimized JPG format instead of PNG. There is no notable quality loss but the image sizes are drastically reduced.
  • Added information about the preservation of unsynchronized changes on file provider domain removal.
  • Extended explanation of status symbols on file provider items.

@i2h3 i2h3 added this to the Nextcloud 33 milestone Feb 10, 2026
@i2h3 i2h3 self-assigned this Feb 10, 2026
@github-project-automation github-project-automation Bot moved this to 🧭 Planning evaluation (don't pick) in 💻 Desktop Clients team Feb 10, 2026
@i2h3 i2h3 moved this from 🧭 Planning evaluation (don't pick) to 🏗️ In progress in 💻 Desktop Clients team Feb 10, 2026
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the macOS Virtual Files documentation to reflect the unified macOS desktop client and Apple’s “file provider extension” terminology, along with refreshed screenshots for the 33.0.0 release.

Changes:

  • Reworked the article structure/content to describe the file provider extension behavior, limitations, and Finder integration.
  • Updated/expanded the list of supported features and status indicators/context menu sections.
  • Replaced legacy PNG screenshots with new optimized JPG screenshots.

Reviewed changes

Copilot reviewed 1 out of 11 changed files in this pull request and generated 6 comments.

Show a summary per file
File Description
user_manual/desktop/macosvfs.rst Updates macOS virtual files documentation text, structure, and image references to match the file provider extension.
user_manual/desktop/images/macosvfs-finder-sidebar.jpg Adds updated Finder sidebar screenshot in JPG format.
user_manual/desktop/images/macosvfs-file-locking.jpg Adds updated file locking screenshot in JPG format.
user_manual/desktop/images/macosvfs-sync-status-icons.png Removes/replaces legacy screenshot asset (PNG).
user_manual/desktop/images/macosvfs-settings.png Removes/replaces legacy screenshot asset (PNG).
user_manual/desktop/images/macosvfs-finder-sidebar.png Removes/replaces legacy screenshot asset (PNG).
user_manual/desktop/images/macosvfs-file-sharing.png Removes/replaces legacy screenshot asset (PNG).
user_manual/desktop/images/macosvfs-file-locking.png Removes/replaces legacy screenshot asset (PNG).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread user_manual/desktop/macosvfs.rst Outdated
Comment thread user_manual/desktop/macosvfs.rst Outdated
Comment thread user_manual/desktop/macosvfs.rst Outdated
Comment thread user_manual/desktop/macosvfs.rst Outdated
Comment thread user_manual/desktop/macosvfs.rst Outdated
Comment thread user_manual/desktop/macosvfs.rst Outdated
@i2h3 i2h3 force-pushed the macos-vfs-update branch 2 times, most recently from 85a798a to de1e5cd Compare February 10, 2026 12:33
@i2h3 i2h3 requested a review from Copilot February 10, 2026 12:33
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 11 changed files in this pull request and generated 3 comments.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread user_manual/desktop/macosvfs.rst Outdated
Comment thread user_manual/desktop/macosvfs.rst Outdated
Comment thread user_manual/desktop/macosvfs.rst
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 11 changed files in this pull request and generated 3 comments.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread user_manual/desktop/macosvfs.rst Outdated
Comment thread user_manual/desktop/macosvfs.rst Outdated
Comment thread user_manual/desktop/macosvfs.rst Outdated
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 11 changed files in this pull request and generated 2 comments.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread user_manual/desktop/macosvfs.rst
Comment thread user_manual/desktop/macosvfs.rst Outdated
@blizzz blizzz modified the milestones: Nextcloud 33, Nextcloud 34 Feb 16, 2026
@i2h3 i2h3 force-pushed the macos-vfs-update branch from 443bff6 to 22d2303 Compare March 3, 2026 14:21
@i2h3 i2h3 force-pushed the macos-vfs-update branch from 22d2303 to 261d267 Compare March 10, 2026 15:27
@i2h3 i2h3 marked this pull request as ready for review March 10, 2026 15:30
- Removed obsolete information about the different macOS builds for classic synchronization and file provider extension because we now have only one universal macOS client left.
- Clarified the conflict between the classic folder synchronization integration and file provider extension.
- Removed specific installation information because it is redundant with the general client installation documentation.
- Shifted the terminology a bit towards "file provider extension" instead of "virtual files" because the former is the official terminology used by Apple and macOS for this kind of software and what users are more likely to understand. macOS also uses this terminology in its system settings where our integration is listed.
- Clarified the benefits of enabling push notifications on the server side.
- Updated feature list.
- Updated screenshots. The user interface has changed significantly. The screenshots now have a consistent appearance. The screenshots were taken on macOS 26 Tahoe which is the latest major release as off writing. This shows that our support of macOS is up to date. Also dedicated demo content and user account was used.
- Screenshots are now in optimized JPG format instead of PNG. There is no notable quality loss but the image sizes are drastically reduced.
- Added information about the preservation of unsynchronized changes on file provider domain removal.
- Extended explanation of status symbols on file provider items.

Signed-off-by: Iva Horn <iva.horn@nextcloud.com>
@i2h3 i2h3 force-pushed the macos-vfs-update branch from 261d267 to 65b82c0 Compare March 11, 2026 10:21
@i2h3 i2h3 merged commit b0358a0 into master Mar 24, 2026
12 checks passed
@i2h3 i2h3 deleted the macos-vfs-update branch March 24, 2026 10:42
@github-project-automation github-project-automation Bot moved this from 🏗️ In progress to ☑️ Done in 💻 Desktop Clients team Mar 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update macOS Client Documentation

5 participants