README.md

July 30, 2026 · View on GitHub

Contributors Forks Stargazers Issues MIT License


ClientWarden

A Secure and Well Designed Alternative to the Desktop Bitwarden Client. Clientwarden uses WinUI for the Windows UI instead of Electron for efficiency and uses Botan for TOTP Codes, which will soon also be used for `secure_vector`'s and `secure_allocator`'s. Currently only Logins are clickable in the Clientwarden UI and only Username, Password's and Websites are able to be displayed.

Report Bug · Request Feature

Table of Contents
  1. About The Project
  2. Getting Started
  3. Roadmap
  4. Contributing
  5. License
  6. Contact
  7. Acknowledgments

About The Project

Product Name Screen Shot

While the Bitwarden Web Client looks ok, the desktop Bitwarden Client doesn't look very good and uses lots of memory, mainly due to electron. There are different Password Managers like 1Pass which do use Electron, but have an appealing UI. My main inspiration is 1Password because it looks the best out of all the major (non Open Source) Password Managers (LastPass, Bitwarden and 1Pass). The main goal is to make an effecient, safe and appealing Password Manager based on Bitwarden.

Anyways, here are some reasons to use Clientwarden:

  • Clientwarden uses WinUI to blend in with Windows and look as good as possible
  • Clientwarden uses Botan secure_vector's for storing passwords safely (still being impl'd)
  • Clientwarden avoids using too much memory

Built With

  • Botan - Conan Center
  • SPDLog - Conan Center
  • OpenSSL - Conan Center
  • Nlohmann JSON - Conan Center
  • CPP HTTPLib - Conan Center
  • Boost - Conan Center

Getting Started

Here are some instructions on how to build Clientwarden, currently only on windows pc's.

Prerequisites

Before building Clientwarden, install VS 2026 with C++ and WinUI Extensions, CMake, Conan, vcpkg and git.

mkdir build
conan install . --output-folder=build --build=missing
conan install . --output-folder=build --build=missing -s build_type=Debug

You might need to use the -s compiler.cppstd=20 flag.

Building

  1. Install CMake
  2. Clone the repo 
    git clone https://github.com/Cherrytree56567/ClientWarden.git
  3. Prerequisites
  4. Build 
    cd build
cmake .. -DCMAKE_TOOLCHAIN_FILE=build/Debug/generators/conan_toolchain.cmake
cd ../
cmake --build build
  5. Enjoy!

Building XCode (Mac OS Only)

  1. Install CMake
  2. Clone the repo 
    git clone https://github.com/Cherrytree56567/ClientWarden.git
  3. Prerequisites
  4. Build 
    cd build
cmake .. -DCMAKE_TOOLCHAIN_FILE=build/Debug/generators/conan_toolchain.cmake -G Xcode
cd ../
cmake --build build
  5. Enjoy!

Roadmap

  • MacOS Support
    • Attachment Support
    • Bin Page
    • Settings Support
    • Lock Support
    • UI Bridge
      • Nav Panel Bridge
      • Items Panel Bridge
      • Side Panel Bridge
        • Save Support
      • Settings Bridge
        • Add ScreenShot Option
    • Add Errors on Bridge
    • Fix Login Crashes
    • Fix Freezing Issue
    • Fix Vault Signouts
    • Code Review
    • Show Deletion Date
    • Show Password History Date
    • Reprompt Support
    • Add Reprompt Toggle
    • Add Password Generator
    • Highlight selected item
    • Add Animation for extending window
    • Folder Tree View (Couldn't figure this out with SwiftUI, TODO Later)
    • Add Remove Field Button for Custom Fields
    • Passkey Support
  • Derive Item Classes from Generic Item
  • Windows Support
    • Create Nav Panel
    • Create Side Panel
    • Create Create Items Panel
    • Settings Support
    • UI Bridge
    • Passkey Support
  • Linux Support
    • Create Nav Panel
    • Create Side Panel
    • Create Create Items Panel
    • Settings Support
    • UI Bridge
    • Passkey Support
  • Official Release
  • Watchtower
  • Custom Item Types
  • iOS and Android Support

See the open issues for a full list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Top contributors:

contrib.rocks image

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Use the Discussion Page for Contact

Acknowledgments

Thanks to: