goldwarden-vaultwarden-bitw.../Readme.md

<img src="https://raw.githubusercontent.com/quexten/goldwarden/main/gui/goldwarden.svg" width=200>

# Goldwarden

Goldwarden is a Bitwarden compatible desktop client. It focuses on providing useful desktop features that the official tools 
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:

- Support for SSH Agent (Git signing and SSH login)
- System wide autotype (Linux - Gnome, KDE only for now)
- Biometric authentication
- Implements Bitwarden browser-extension biometrics on Linux
- Support for injecting environment variables into the environment of a cli command
- 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
- Passwordless login (Both logging in, and approving logins)
- Fido2 (Webauthn) support
- more to come...?

The aim is not to replace the official clients, but to complement by implementing the missing features.

### Requirements
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.

### Installation

#### Flatpak
There is a flatpak that includes a small UI, autotype functionality and autostarting of the daemon.

[<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)

<img src='https://github.com/quexten/goldwarden/assets/11866552/88adefe4-90bc-4a77-b749-3c89a6bba7cd' width='400'>
<img src='https://github.com/quexten/goldwarden/assets/11866552/f6dfd24b-3cf4-4ce3-b504-c9bdf673e086' width='400'>

#### CLI
##### Arch (AUR)
On Arch linux, or other distributions with access to the AUR, simply:
```
yay -S goldwarden
```
should be enough to install goldwarden on your system.

##### Deb / RPM
For deb/rpm, download the deb/rpm from the latest release on GitHub and install it using your package manager.

#### NixOS
https://github.com/NixOS/nixpkgs/pull/278362

##### Github Binary Releases
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`.

##### Compiling
Alternatively, you can build it yourself.
```
go install github.com/quexten/goldwarden@latest
```

### Setup and Usage
To get started, follow the instructions provided in the wiki https://github.com/quexten/goldwarden/wiki/Getting-Started.
For instructions on specific features, also consult the wiki page for the feature.

### Contributing
Interested in contributing a feature or bug-fix? Great! Here is some information on how to set up your development environment:

https://github.com/quexten/goldwarden/wiki/Setting-up-the-Development-Environment

After that, create a PR. If you encounter any issues, feel free to open a discussion thread.
Update Readme.md 2024-02-22 13:44:25 +01:00			`<img src="https://raw.githubusercontent.com/quexten/goldwarden/main/gui/goldwarden.svg" width=200>`

			`# Goldwarden`
Initial commit 2023-07-17 03:23:26 +02:00
Update Readme.md 2023-12-28 17:11:35 +01:00			`Goldwarden is a Bitwarden compatible desktop client. It focuses on providing useful desktop features that the official tools`
Update Readme.md 2024-03-08 16:42:36 +01: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:`
Initial commit 2023-07-17 03:23:26 +02:00
			`- Support for SSH Agent (Git signing and SSH login)`
Update Readme.md 2024-02-04 01:21:12 +01:00			`- System wide autotype (Linux - Gnome, KDE only for now)`
			`- Biometric authentication`
Update Readme.md 2023-12-28 10:29:20 +01:00			`- Implements Bitwarden browser-extension biometrics on Linux`
			`- Support for injecting environment variables into the environment of a cli command`
Initial commit 2023-07-17 03:23:26 +02: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`
Update Readme.md 2023-08-21 20:10:57 +02:00			`- Passwordless login (Both logging in, and approving logins)`
Initial commit 2023-07-17 03:23:26 +02:00			`- Fido2 (Webauthn) support`
			`- more to come...?`

Update Readme.md 2023-12-30 05:12:11 +01:00			`The aim is not to replace the official clients, but to complement by implementing the missing features.`
Update Readme.md 2023-12-28 17:11:35 +01:00
Initial commit 2023-07-17 03:23:26 +02:00			`### Requirements`
Update Readme.md 2023-12-27 14:32:10 +01: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.`
Initial commit 2023-07-17 03:23:26 +02:00
			`### Installation`
Update Readme.md 2023-08-20 23:39:16 +02:00
Update Readme.md 2024-01-03 21:44:22 +01:00			`#### Flatpak`
Update readme 2023-12-23 13:56:15 +01:00			`There is a flatpak that includes a small UI, autotype functionality and autostarting of the daemon.`
Update Readme.md 2024-01-03 21:44:31 +01:00
Update Readme.md 2024-01-03 21:44:22 +01: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)`
Update Readme.md 2023-12-27 02:06:03 +01:00
Update Readme.md 2024-02-21 06:58:57 +01:00			`<img src='https://github.com/quexten/goldwarden/assets/11866552/88adefe4-90bc-4a77-b749-3c89a6bba7cd' width='400'>`
			`<img src='https://github.com/quexten/goldwarden/assets/11866552/f6dfd24b-3cf4-4ce3-b504-c9bdf673e086' width='400'>`
Update readme 2023-12-23 13:56:15 +01:00
			`#### CLI`
Update Readme.md 2023-12-27 14:43:21 +01:00			`##### Arch (AUR)`
Update Readme.md 2023-08-20 23:39:16 +02: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.`

Update Readme.md 2023-12-27 14:43:21 +01:00			`##### Deb / RPM`
Update installation instructions 2023-09-20 01:15:49 +02:00			`For deb/rpm, download the deb/rpm from the latest release on GitHub and install it using your package manager.`

Update Readme.md 2024-01-03 21:44:22 +01:00			`#### NixOS`
			`https://github.com/NixOS/nixpkgs/pull/278362`

Update Readme.md 2023-12-27 14:43:21 +01:00			`##### Github Binary Releases`
Update installation instructions 2023-09-20 01:15:49 +02: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`.
Update Readme.md 2023-08-04 00:51:55 +02:00
Update Readme.md 2023-12-27 14:43:21 +01:00			`##### Compiling`
Update installation instructions 2023-09-20 01:15:49 +02:00			`Alternatively, you can build it yourself.`
			```
			`go install github.com/quexten/goldwarden@latest`
			```
Initial commit 2023-07-17 03:23:26 +02:00
Update Readme.md 2023-12-28 10:26:21 +01:00			`### Setup and Usage`
			`To get started, follow the instructions provided in the wiki https://github.com/quexten/goldwarden/wiki/Getting-Started.`
			`For instructions on specific features, also consult the wiki page for the feature.`
Update Readme.md 2024-01-20 06:23:32 +01:00
			`### Contributing`
			`Interested in contributing a feature or bug-fix? Great! Here is some information on how to set up your development environment:`

			`https://github.com/quexten/goldwarden/wiki/Setting-up-the-Development-Environment`

			`After that, create a PR. If you encounter any issues, feel free to open a discussion thread.`