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

# FIFinderSyncController

A controller that acts as a bridge between your Finder Sync extension and the Finder itself.

```
class FIFinderSyncController
```

## Overview

Use the Finder Sync controller to configure your extension, to set badges
on items in the Finder’s window, and to get a list of selected and targeted
items.

## Topics

### Managing the Finder Sync Controller

[`+  defaultController`](/documentation/FinderSync/FIFinderSyncController/default())

Returns the shared Finder Sync controller object.

[`directoryURLs`](/documentation/FinderSync/FIFinderSyncController/directoryURLs)

The directories managed by this extension.

[`-  selectedItemURLs`](/documentation/FinderSync/FIFinderSyncController/selectedItemURLs())

Returns an array of selected items.

[`-  setBadgeIdentifier:forURL:`](/documentation/FinderSync/FIFinderSyncController/setBadgeIdentifier(_:for:))

Sets the badge for a file or directory.

[`-  setBadgeImage:label:forBadgeIdentifier:`](/documentation/FinderSync/FIFinderSyncController/setBadgeImage(_:label:forBadgeIdentifier:))

Sets the badge image and label for the given ID.

[`-  targetedURL`](/documentation/FinderSync/FIFinderSyncController/targetedURL())

Returns the URL of the Finder’s current target.

## Relationships

### Inherits From

[`NSExtensionContext`](/documentation/Foundation/NSExtensionContext)

### Conforms To

[`CustomDebugStringConvertible`](/documentation/Swift/CustomDebugStringConvertible)

[`CustomStringConvertible`](/documentation/Swift/CustomStringConvertible)

[`NSObjectProtocol`](/documentation/ObjectiveC/NSObjectProtocol)

[`Hashable`](/documentation/Swift/Hashable)

[`CVarArg`](/documentation/Swift/CVarArg)

[`Sendable`](/documentation/Swift/Sendable)

[`Equatable`](/documentation/Swift/Equatable)

[`SendableMetatype`](/documentation/Swift/SendableMetatype)

---

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)