Repository files navigation

A simple GUI for gocryptfs.

Cloak is a simple GUI for gocryptfs built with Golang and web tech. It works on macOS and Linux.

Features:

• A simple UI for managing your gocryptfs vaults, just like Cryptomator.
• Password changing / password resetting (with master key).
• Warn you about password strength.
• Fast to launch or quit.
• Internationalization. Current supported languages:
  • English
  • Simplified Chinese

UI / interaction mimicked from Cryptomator.

• Download prebuilt binaries fromreleases page.
• For Linux users, set executable permission for theAppImage file (alternatively you can usechmod +x Cloak*.AppImage), then just run it.
• For macOS users, after decompressing the ZIP archive, you might need to runxattr -d -r com.apple.quarantine Cloak.app in Terminal, otherwise GateKeeper would refuse to run the app.
• You can open the UI or quit the app viaOpen menu item of the tray icon (or menubar icon).

• Vault list is stored at:
  • $XDG_DATA_HOME/Cloak on Linux. If$XDG_DATA_HOME is not set,it falls back to$HOME/.local/share.
  • ~/Library/Application Support/Cloak on macOS, see Apple'sLibrary Directory Details
• Configuration file is stored at:
  • $XDG_CONFIG_HOME/Cloak on Linux. If$XDG_CONFIG_HOME is not set,it falls back to$HOME/.config.
  • ~/Library/Application Support/Cloak on macOS.
• Log files are stored at:
  • $XDG_DATA_HOME/Cloak/logs on Linux.
  • ~/Library/Logs/Cloak on macOS.

Before0.8.0, Cloak store all its data and log files in~/.cloaklet.cloak directory on Linux.By running a new version of Cloak, they get moved to the new directories.

Cloak automatically clears log file content each time it starts up.Sensitive information like vault passwords or master keys are never logged.

I wrote a similar GUI calledCloaklet using QML + Golang.However, I don't enjoy developing in QML at all, and quickly ran into some issues which I can't resolve.After that I went back to use Cryptomator, but its UI feels slow and somehow inconsistent.This time I got an idea from one of my early projects to use web browser as UI renderer, thus this new project.

Notice: you have to use a running instance of macOS, either a VM or a real Apple computer.

• Install Xcode related stuff withxcode-select --install.
• Install frontend dependencies:cd frontend && npm install.
• Rungo run build.go build in project root, and it should create theCloak.app bundle.
• Double click to start the app.

• Install required libraries:sudo apt install libappindicator3-dev gcc libgtk-3-dev libxapp-dev.
• Install frontend dependencies:cd frontend && npm install.
• Rungo run build.go build and it should produce an AppImage binary.

The AppImage binary includes all required libraries and tools, so you can run it right away.

The frontend (UI) project resides infrontend directory. It's a standard Vue project managed by vue-cli.

• Install dependencies:npm install insidefrontend directory.
• Simply runnpm run serve insidefrontend directory.
• You can also run theserve task from vue-cli UI, runvue ui to get started.

You should build the frontend project first so the backend can find assets for the UI.

• Inside thefrontend directory, runnpm run build.
• Rungo generate ./... to generate necessary source codes.
• To run the app, simply invokego run . in the project root.

• gocryptfs requiresFUSE to function. For macOS please installOSXFUSE (nowmacFUSE).
• Windows is not supported, becausegocryptfs does not work on Windows.
• Avoid committingstatik module because it contains large blob of files produced by the frontend project.
• If you are building the app yourself, missinglibxapp-dev would not result in error; But when running the built AppImage on Linux Mint, menu item will lose highlighting.
• You should installxdg-open on Linux, otherwise drive revealing will not work.

• RemixIcon

GPL v3, see LICENSE file.