goldwarden/Readme.md

73 lines
3.2 KiB
Markdown
Raw Normal View History

2024-02-22 15:44:25 +03:00
<img src="https://raw.githubusercontent.com/quexten/goldwarden/main/gui/goldwarden.svg" width=200>
# Goldwarden
2023-07-17 04:23:26 +03:00
2023-12-28 19:11:35 +03:00
Goldwarden is a Bitwarden compatible desktop client. It focuses on providing useful desktop features that the official tools
2024-03-08 18:42:36 +03:00
do not (yet) have or are not willing to add (for example, because the integrations are not mature enough for a broad userbase),
and enhanced security measures that other tools do not provide, such as:
2023-07-17 04:23:26 +03:00
- Support for SSH Agent (Git signing and SSH login)
2024-05-04 05:03:18 +03:00
- System wide autotype (On Linux (Wayland/XOrg), Mac and Windows)
2024-02-04 03:21:12 +03:00
- Biometric authentication
2023-12-28 12:29:20 +03:00
- Implements Bitwarden browser-extension biometrics on Linux
- Support for injecting environment variables into the environment of a cli command
2023-07-17 04:23:26 +03:00
- Vault content is held encrypted in memory and only briefly decrypted when needed
- Kernel level memory protection for keys (via the memguard library)
- Additional measures to protect against memory dumps
2023-08-21 21:10:57 +03:00
- Passwordless login (Both logging in, and approving logins)
2023-07-17 04:23:26 +03:00
- Fido2 (Webauthn) support
- more to come...?
2023-12-30 07:12:11 +03:00
The aim is not to replace the official clients, but to complement by implementing the missing features.
2023-12-28 19:11:35 +03:00
2023-07-17 04:23:26 +03:00
### Requirements
2023-12-27 16:32:10 +03:00
Right now, Goldwarden is only tested on Linux. Somewhat feature-stripped builds for Mac and Windows are available too, but untested.
Autotype is currently implemented via the remotedesktop portal. This is supported on KDE and Gnome, but not yet on wl-root based environments.
2023-07-17 04:23:26 +03:00
### Installation
2023-08-21 00:39:16 +03:00
2024-01-03 23:44:22 +03:00
#### Flatpak
2023-12-23 15:56:15 +03:00
There is a flatpak that includes a small UI, autotype functionality and autostarting of the daemon.
2024-01-03 23:44:31 +03:00
2024-01-03 23:44:22 +03:00
[<img width='240' alt='Download on Flathub' src='https://flathub.org/assets/badges/flathub-badge-en.png' />](https://flathub.org/apps/details/com.quexten.Goldwarden)
2023-12-27 04:06:03 +03:00
2024-05-04 04:40:12 +03:00
![image](https://github.com/quexten/goldwarden/assets/11866552/ae081005-00bf-4127-a208-1476ed856ef1)
![image](https://github.com/quexten/goldwarden/assets/11866552/b7f4c261-f801-4b61-9507-8a9bef793de4)
2023-12-23 15:56:15 +03:00
#### CLI
2023-12-27 16:43:21 +03:00
##### Arch (AUR)
2023-08-21 00:39:16 +03:00
On Arch linux, or other distributions with access to the AUR, simply:
```
yay -S goldwarden
```
should be enough to install goldwarden on your system.
2023-12-27 16:43:21 +03:00
##### Deb / RPM
2023-09-20 02:15:49 +03:00
For deb/rpm, download the deb/rpm from the latest release on GitHub and install it using your package manager.
2024-01-03 23:44:22 +03:00
#### NixOS
2024-05-03 23:30:23 +03:00
```
environment.systemPackages = [
pkgs.goldwarden
];
```
2023-12-27 16:43:21 +03:00
##### Github Binary Releases
2023-09-20 02:15:49 +03:00
On other distributions, Mac and Windows, you can download it from the latest release on GitHub and put it into a location you want to have it in, f.e `/usr/bin`.
2023-08-04 01:51:55 +03:00
2023-12-27 16:43:21 +03:00
##### Compiling
2023-09-20 02:15:49 +03:00
Alternatively, you can build it yourself.
```
go install github.com/quexten/goldwarden@latest
```
2023-07-17 04:23:26 +03:00
2023-12-28 12:26:21 +03:00
### Setup and Usage
2024-05-06 00:34:04 +03:00
To get started, follow the instructions provided in the wiki [https://github.com/quexten/goldwarden/cli/wiki/Getting-Started](https://github.com/quexten/goldwarden/wiki/Getting-Started).
2023-12-28 12:26:21 +03:00
For instructions on specific features, also consult the wiki page for the feature.
2024-01-20 08:23:32 +03:00
### Contributing
Interested in contributing a feature or bug-fix? Great! Here is some information on how to set up your development environment:
2024-05-04 23:29:29 +03:00
https://github.com/quexten/goldwarden/wiki/Setting-up-the-Development-Environment
2024-01-20 08:23:32 +03:00
After that, create a PR. If you encounter any issues, feel free to open a discussion thread.