9039bc2c4d
* --daemon and --stop options for server * --restart and --force option * ssl certificates and tor * tor key path fix... * pass host to flask * fix bug with switching between nodes * docs on node setup - reverse proxy and self-signed certs * typo
3.4 KiB
Executable file
Specter Desktop
DISCLAIMER
This software is WORK IN PROGRESS and NOT READY TO USE YET. Currently tested only in Chrome, so in other browsers it may look weird.
If something doesn't work open an issue here or ask a question in our Telegram group or Slack.
Why?
Bitcoin Core has a very powerful command line interface and a wonderful daemon. Using PSBT and HWI it can also work with hardware wallets, but at the moment it is too linux-way. The same applies to multisignature setups.
The goal of this project is to make a convenient and user-friendly GUI around Bitcoin Core with a focus on multisignature setup with airgapped hardware wallets.
At the moment we are working on integration of our Specter-DIY hardware wallet that uses QR codes as a main communication channel, and ColdCard that uses SD cards. Later on we plan to integrate "hot" hardware wallets using HWI tool and Junction.
How to run
Clone the repo, install dependencies:
HWI support requires libusb (necessary? Or is pip install libusb1 sufficient?):
- Ubuntu/Debian:
sudo apt install libusb-1.0-0-dev libudev-dev - macOS:
brew install libusb
git clone https://github.com/cryptoadvance/specter-desktop.git
cd specter-desktop
virtualenv --python=python3 .env
source .env/bin/activate
pip3 install -r requirements.txt
pip3 install -e .
Run the server:
cd specter-desktop
python3 -m cryptoadvance.specter server
You can also run it as a daemon, using tor, provide ssl certificates to run over https. Https is especially important because browsers don't allow the website to access camera without secure connection, and we need camera access to scan QR codes.
An example how to run specter server in the background (--daemon) with ssl certificates (--key, --cert) over tor:
python -m cryptoadvance.specter server --tor=mytorpassword --cert=./cert.pem --key=./key.pem --daemon
If your Bitcoin Core is using a default data folder the app should detect it automatically. If not, consider setting rpcuser and rpcpassword in the bitcoin.conf file and in the app settings.
Have a look at DEVELOPMENT.md for further information about hacking on specter-desktop.
Detailed instructions
- Beyond local network - how to forward your node through a cheap VPS: docs/reverse-proxy.md
- Setting up Specter over Tor: docs/tor.md
- Using self-signed certificates in local network or Tor: docs/self-signed-certificates.md
A few screenshots
Adding a new device
Creating a new wallet
Wallet interface
Configuration
