A TUI application for managing gocryptfs encrypted vaults on Linux.
Built with C++20 and FTXUI v5.0.0.
- Two-pane FTXUI layout with vault list and detail panel
- Create, add, mount, unmount, remove vaults
- Password storage in system keyring (gnome-keyring via secret-tool)
- Auto-detect mounted status (● / ○)
- Modal dialogs for password input, add vault, new vault, remove vault
- Open vault directory or mount point via xdg-open
- Auto-installs gocryptfs if missing (pacman, or
omarchy-pkg-addwhen available) - 8 unit tests
cmake -B build -DCMAKE_BUILD_TYPE=Release -DBUILD_TESTING=ON
cmake --build build -j$(nproc)
./build/guicrypt-tui./build/test/guicrypt-tui_test| Key | Action |
|---|---|
j/k or ↑/↓ |
Navigate vault list |
m |
Mount selected vault |
u |
Unmount selected vault |
v |
Open vault directory |
o |
Open mounted vault |
a |
Add existing vault |
n |
Create new vault |
c |
Change password |
r |
Remove vault |
q |
Quit |
- gocryptfs
- gnome-keyring (or compatible secret-tool provider)
- CMake 3.20+, C++20 compiler
- libsecret (runtime, for secret-tool CLI)
- xdg-terminal-exec (runtime, launches the
.desktopentry) - FTXUI, nlohmann-json, googletest (auto-fetched by CMake)
On Omarchy, the app launcher opens guicrypt-tui as a floating, centered
window (matching Omarchy's own bundled TUI apps), and a missing gocryptfs is installed via
omarchy-pkg-add with a desktop notification instead of a plain pacman call. Both fall back to
generic behavior on any other Arch/Hyprland setup.
MIT