Missing Seafile sync status overlay icons in Windows File Explorer

Seafile Client
1

Hi everyone,

I’m using the Windows sync client for Seafile, but I don’t see any status overlay icons (like the green checkmarks or sync arrows) on my files/folders.

I’ve restarted my computer after installation, so that’s not it. Has anyone else run into this?

Thanks!

2

The issue you’re experiencing is a known limitation in Windows rather than a specific bug in the Seafile client. Windows only supports a maximum of 15 overlay icon handlers. If you have other cloud services installed (like OneDrive, Dropbox, or Google Drive), they often fill these slots, causing Seafile’s icons to be pushed out of the active list.

You can try the following steps to resolve this:

1. Use the Built-in Repair Tool

The Seafile client includes a tool to help fix this. Right-click the Seafile icon in your system tray and select Repair Windows Explorer extension. This tool attempts to re-register the overlay handlers.

2. Check the 15-Icon Limit in Registry

If the repair tool doesn’t work, you can manually prioritize the icons:

  1. Open the Registry Editor (regedit).
  2. Navigate to: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Explorer\ShellIconOverlayIdentifiers
  3. Windows only loads the first 15 entries alphabetically. To make Seafile’s icons appear, you can rename the Seafile-related entries (e.g., .SeafileIconNormal) by adding several spaces to the beginning of their names. This moves them to the top of the list.

3. Verify Client Settings

Ensure the extension is actually enabled:

  1. Right-click the Seafile tray icon and select Settings.
  2. Make sure the option for explorer extension support or sync status icons is checked.

4. Note on Path Lengths

Windows Explorer generally cannot display overlay icons for files with paths longer than 255 characters. If only specific files are missing icons, check if they have exceptionally long file paths.

5. Restart Windows Explorer

After making registry changes or using the repair tool, you must restart the Windows Explorer process via Task Manager (or restart your computer) for the changes to take effect.

3

Test Reply

4

If you are experiencing the same issue on macOS, you can try the steps below to resolve it:

1. Check Finder Extensions (Most Common)

macOS may occasionally disable third-party Finder extensions, which prevents status overlays from appearing.

  • Steps:

    1. Go to System Settings (or System Preferences).

    2. Navigate to Privacy & Security > Extensions > Finder Extensions.

    3. Ensure that Seafile or SeaDrive is checked.

    4. Pro Tip: If it is already checked, uncheck it, wait a few seconds, and then re-check it to force the system to reload the extension.

2. Relaunch Finder

The Finder process may become unresponsive or fail to refresh the UI cache.

  • Steps:

    1. Hold down the Option (⌥)​ key on your keyboard.

    2. Right-click the Finder icon in your Dock.

    3. Select Relaunch.

3. SeaDrive 3.x Architectural Changes

If you recently updated to SeaDrive 3.x, it now utilizes the macOS File Provider API (similar to iCloud and OneDrive).

  • Behavior: Following Apple’s design guidelines, files that are fully synced and stored locally may no longer show a green checkmark. Instead, they appear as standard files without overlays, while files only available online will show a cloud icon.

4. Full Disk Access (macOS 15 and later)

Newer macOS versions have stricter security protocols regarding file system monitoring.

  • Steps:

    1. Go to System Settings > Privacy & Security > Full Disk Access.

    2. Ensure Seafile or SeaDrive is toggled ON.

5. Check Sync Status and Conflicts

The icon may disappear or change if the client is stuck or encountering an error.

  • Click the Seafile/SeaDrive icon in the top Menu Bar.

  • Check for any “Syncing…” status, “Permission Denied,” or “File Conflicts.”

  • Try quitting the app completely and restarting it.

5

f you are experiencing the same issue on macOS

### 1. Check Finder Extensions (Most Common)
macOS may occasionally disable third-party Finder extensions, which prevents status overlays from appearing.
- **Steps**:
1. Go to **System Settings** (or System Preferences).
2. Navigate to **Privacy & Security** > **Extensions** > **Finder Extensions**.
3. Ensure that **Seafile** or **SeaDrive** is checked.
4. **Pro Tip**: If it is already checked, uncheck it, wait a few seconds, and then re-check it to force the system to reload the extension.

### 2. Relaunch Finder
The Finder process may become unresponsive or fail to refresh the UI cache.
- **Steps**:
1. Hold down the **Option (⌥)** key on your keyboard.
2. Right-click the **Finder** icon in your Dock.
3. Select **Relaunch**.

### 3. SeaDrive 3.x Architectural Changes
If you recently updated to SeaDrive 3.x, it now utilizes the macOS **File Provider API** (similar to iCloud and OneDrive).
- **Behavior**: Following Apple’s design guidelines, files that are fully synced and stored locally may **no longer show a green checkmark**. Instead, they appear as standard files without overlays, while files only available online will show a cloud icon.

### 4. Full Disk Access (macOS 15 and later)
Newer macOS versions have stricter security protocols regarding file system monitoring.
- **Steps**:
1. Go to **System Settings** > **Privacy & Security** > **Full Disk Access**.
2. Ensure **Seafile** or **SeaDrive** is toggled **ON**.

### 5. Check Sync Status and Conflicts
The icon may disappear or change if the client is stuck or encountering an error.
- Click the Seafile/SeaDrive icon in the top **Menu Bar**.
- Check for any “Syncing…” status, “Permission Denied,” or “File Conflicts.”
- Try quitting the app completely and restarting it.

6

If you are experiencing the same issue on **macOS**, you can try the steps below to resolve it

1. Check Finder Extensions (Most Common)

macOS may occasionally disable third-party Finder extensions, which prevents status overlays from appearing.

  • Steps:

    1. Go to System Settings (or System Preferences).

    2. Navigate to Privacy & Security > Extensions > Finder Extensions.

    3. Ensure that Seafile or SeaDrive is checked.

    4. Pro Tip: If it is already checked, uncheck it, wait a few seconds, and then re-check it to force the system to reload the extension.

2. Relaunch Finder

The Finder process may become unresponsive or fail to refresh the UI cache.

  • Steps:

    1. Hold down the Option (⌥)​ key on your keyboard.

    2. Right-click the Finder icon in your Dock.

    3. Select Relaunch.