Seafile client stuck in sync? Check for special characters in file names!

Written by - 0 comments

Published on - Listed in Windows Internet Seafile Cloud


I was looking into a synchronisation problem on a Seafile client on Windows, which got me scratching my head more than I'd thought.
As soon as the library was selected to sync with a local folder, the sync/download of the library stopped at 1%.

At the begin I suspected that a subfolder's size exceeds the Seafile's configured max folder size, but the Seafile client log (which can be found in C:\Users\$USER\ccnet\logs) clearly indicated another problem:

[10/27/15 14:44:52] vc-utils.c(567): Failed to create dir C:/Users/kuenzlerc/Seafile\Documents/Projects | Clients.

When I saw the backslash after C:/Users/kuenzlerc/Seafile I thought that's the problem. But at the second look I saw the pipe character (|).
On the web UI I verified the file name and indeed: The folder name said "Projects | Clients":

Seafile Web UI Folder View

Now Windows users know what happens, if you want to name a file or folder with a special character:

windows file name forbidden characters

Translated: A file name must not contain any of the following characters: "\ / : * ? < > |".

As Seafile is a cross-OS file sharing tool (which makes Seafile so great!), other operating systems like Mac OS X may use these characters in file names. Hence the problem when a Windows client tries to sync such a folder or file.

As soon as I renamed the folder name to "Projects and Clients" in the web UI, the sync continued and finished in a few minutes.

Seafile rename folder


Add a comment

Show form to leave a comment

Comments (newest first)

No comments yet.