<!--
{
  "availability" : [
    "macOS: 10.10.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "FinderSync",
  "identifier" : "/documentation/FinderSync/FIFinderSyncProtocol",
  "metadataVersion" : "0.1.0",
  "role" : "Protocol",
  "symbol" : {
    "kind" : "Protocol",
    "modules" : [
      "Finder Sync"
    ],
    "preciseIdentifier" : "c:objc(pl)FIFinderSync"
  },
  "title" : "FIFinderSyncProtocol"
}
-->

# FIFinderSyncProtocol

The group of methods to implement for modifying the Finder user interface to express file synchronization status and control.

```
protocol FIFinderSyncProtocol
```

## Topics

### Managing Badges, Shortcut Menus, and Toolbar Buttons

[`-  beginObservingDirectoryAtURL:`](/documentation/FinderSync/FIFinderSyncProtocol/beginObservingDirectory(at:))

Tells the extension that the user is looking at a monitored directory or at
one of its subdirectories.

[`-  endObservingDirectoryAtURL:`](/documentation/FinderSync/FIFinderSyncProtocol/endObservingDirectory(at:))

Tells the extension that the user has stopped looking at a monitored
directory or at one of its subdirectories.

[`-  menuForMenuKind:`](/documentation/FinderSync/FIFinderSyncProtocol/menu(for:))

Requests a custom menu from the extension.

[`-  requestBadgeIdentifierForURL:`](/documentation/FinderSync/FIFinderSyncProtocol/requestBadgeIdentifier(for:))

Requests a badge for the given file or directory.

[`toolbarItemImage`](/documentation/FinderSync/FIFinderSyncProtocol/toolbarItemImage)

The image for the extension’s toolbar button.

[`toolbarItemName`](/documentation/FinderSync/FIFinderSyncProtocol/toolbarItemName)

The name of the extension’s toolbar button.

[`toolbarItemToolTip`](/documentation/FinderSync/FIFinderSyncProtocol/toolbarItemToolTip)

The tooltip text for the extension’s toolbar button.

### Constants

[`FIMenuKind`](/documentation/FinderSync/FIMenuKind)

The different kinds of custom menus that the Finder Sync extension can
provide.

## Relationships

### Conforming Types

[`FIFinderSync-swift.class`](/documentation/FinderSync/FIFinderSync-swift.class)

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)