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.