Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/revault/revault-gui

Revault terminal
https://github.com/revault/revault-gui

bitcoin custody gui revault rust

Last synced: 4 days ago
JSON representation

Revault terminal

Awesome Lists containing this project

README

        

# revault-gui

Revault GUI is an user graphical interface written in rust for the
[Revault daemon](https://github.com/revault/revaultd).

stakeholder-regtest
manager-regtest

## Dependencies

- `fontconfig` (On Debian/Ubuntu `apt install libfontconfig1-dev`)
- [`pkg-config`](https://www.freedesktop.org/wiki/Software/pkg-config/) (On Debian/Ubuntu `apt install pkg-config`)
- [`libxkbcommon`](https://xkbcommon.org/) for the dummy signer (On Debian/Ubuntu `apt install libxkbcommon-dev`)
- Vulkan drivers (On Debian/Ubuntu `apt install mesa-vulkan-drivers libvulkan-dev`)
- `libudev-dev` (On Debian/Ubuntu `apt install libudev-dev`)

We are striving to remove dependencies, especially the 3D ones.

## Usage

`revault-gui --datadir --`

The default `datadir` is the default `revaultd` `datadir` (`~/.revault`
for linux) and the default `network` is the bitcoin mainnet.

If no argument is provided, the GUI checks in the default `datadir`
the configuration file for the bitcoin mainnet.

If the provided `datadir` is empty or does not have the configuration
file for the targeted `network`, the GUI starts with the installer mode.

Instead of using `--datadir` and `--`, a direct path to
the GUI configuration file can be provided with `--conf`.

After start up, The GUI will connect to the running revaultd.
A command starting revaultd is launched if no connection is made.

## Get started

See [aquarium](https://github.com/revault/aquarium) for trying out a
Revault deployment in no time.

See [doc/DEMO_TESTNET.md](doc/DEMO_TESTNET.md) for instructions on how
to setup Revault on testnet (more involved and likely needs more
participants).

## Troubleshooting

- If you encounter layout issue on `X11`, try to start the GUI with
`WINIT_X11_SCALE_FACTOR` manually set to 1