Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/varjolintu/keepassxc-proxy-rust
Application that works as a proxy between Native Messaging browser extension and KeePassXC
https://github.com/varjolintu/keepassxc-proxy-rust
Last synced: 11 days ago
JSON representation
Application that works as a proxy between Native Messaging browser extension and KeePassXC
- Host: GitHub
- URL: https://github.com/varjolintu/keepassxc-proxy-rust
- Owner: varjolintu
- License: gpl-3.0
- Created: 2017-08-12T09:28:50.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2022-11-05T09:30:22.000Z (about 2 years ago)
- Last Synced: 2024-10-14T11:27:53.698Z (24 days ago)
- Language: Rust
- Size: 47.9 KB
- Stars: 63
- Watchers: 5
- Forks: 16
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# keepassxc-proxy-rust
Application that works as a proxy between Native Messaging browser extension and KeePassXC
This is still under development. Installing the proxy needs manual changes to JSON scripts installed for Native Messaging.
See [this page](https://developer.chrome.com/extensions/nativeMessaging) for further information.
keepassxc-proxy listens stdin from keepassxc-browser extension and transfers the data to Unix domain socket(s):
- `XDG_RUNTIME_DIR/app/org.keepassxc.KeePassXC/` (also supporting old legacy path with plain `XDG_RUNTIME_DIR`)
- `/tmp/org.keepassxc.KeePassXC.BrowserServer` (macOS and Linux fallback)
- With Windows this is a named pipe under `keepassxc\\\\org.keepassxc.KeePassXC.BrowserServer`
## Installing
### Alpine Linux
If you use Alpine Linux, you can install the proxy from the [keepassxc-proxy-static](https://pkgs.alpinelinux.org/packages?name=keepassxc-proxy-static) package.
It's built as a static binary, so it can be used with a browser installed from and running in Flatpak.
This package is available in Alpine Linux repositories since (upcoming) v3.17 and in Edge.
```bash
apk add keepassxc-proxy-static
```
You can then install the proxy and associated config into Firefox or Chromium using the `keepassxc-proxy-install` command.
Run `keepassxc-proxy-install -h` for more information.
## Building
The proxy can be built with:
```bash
cargo build --release
```
### Static library
To build a binary without dependencies (which is useful for running
inside of a flatpak), you'll have to install MUSL libc first:
```bash
rustup target add x86_64-unknown-linux-musl
```
Then build with
```bash
RUSTFLAGS='-C link-arg=-s' cargo build --release --target x86_64-unknown-linux-musl
```
(see [Stackoverflow](https://stackoverflow.com/a/59766875/487503))
## Copyright
```
Copyright (C) 2017-2022 Sami Vänttinen
Copyright (C) 2017-2018 Andy Brandt
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see .
```