cryptomator / cryptomator/cryptomator

WinFsp: no shell overlay icons (TortoiseHg) - neither network nor Local Drive mode works

Open
#4,192 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
Java
Stars
16.1k
Forks
1.5k
Avg merge
2d 45m
Merged PRs (30d)
1

Description

### Summary

Shell overlay icons from TortoiseHg don't work on Cryptomator drives - WinFsp network mode skips overlays (DRIVE_REMOTE), WinFsp Local Drive breaks Mercurial entirely (Code 255). Mounting via Mount Manager (\\.\X:) would fix both

### Please agree to the following

- [x] I have searched [existing issues](https://github.com/cryptomator/cryptomator/issues?q=) for duplicates
- [x] I agree to follow this project's [Code of Conduct](https://github.com/cryptomator/cryptomator/blob/develop/.github/CODE_OF_CONDUCT.md)

### Motivation

**WinFsp: mount via Mount Manager for better app compatibility**

I use TortoiseHg (Mercurial) on repos inside a Cryptomator vault. The TortoiseHg overlay icons in Explorer don't show up on the Cryptomator drive. The context menu works, just the overlays are missing.

Neither WinFsp mode solves this:

- **WinFsp (network drive, default):** Mercurial works, context menu works, but no overlay icons. The drive shows up as `DRIVE_REMOTE` and TortoiseHg skips overlays for that - even with `LocalDisksOnly = 0` in the registry.

- **WinFsp (Local Drive):** Mercurial fails completely:
```
abort: error getting current working directory:
The volume does not contain a recognized file system.
[Code: 255]
```

The underlying issue seems to be [winfsp/winfsp#427](https://github.com/winfsp/winfsp/issues/427) - the "Local Drive" mode uses `DefineDosDeviceW`, which breaks `GetVolumeInformation()`. The WinFsp developer suggests mounting via the Windows Mount Manager (`\\.\X:` instead of `X:`) as the fix, which requires admin but makes the drive behave like a proper local volume.

It would be great if Cryptomator offered a third option like "WinFsp (Mount Manager)" that uses this method. Admin requirement is fine for this, just needs a note in the UI.

This would probably also help with other apps that have trouble with both WinFsp modes (FreeFileSync comes to mind).

**Setup:** Windows 10, Cryptomator v1.19.1, TortoiseHg 7.0.1

### Considered Alternatives

Related: #2359 (same WinError 1005 with Calibre, workaround there is to switch to network mode — which doesn't help if you need overlay icons)

### Anything else?

_No response_

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.