sparrow/README.md

67 lines
2.2 KiB
Markdown
Raw Normal View History

2020-08-29 15:56:09 +00:00
# Sparrow Bitcoin Wallet
2020-03-22 08:15:16 +00:00
2020-08-29 15:56:09 +00:00
Sparrow is a modern desktop Bitcoin wallet application supporting most hardware wallets and built on common standards such as PSBT, with an emphasis on transparency and usability.
2020-03-28 08:45:39 +00:00
2020-08-29 15:56:09 +00:00
More information (and release binaries) can be found at https://sparrowwallet.com. Release binaries are also available directly from [Github](https://github.com/sparrowwallet/sparrow/releases).
2020-04-07 13:14:11 +00:00
2020-08-29 15:56:09 +00:00
![Sparrow Wallet](https://sparrowwallet.com/assets/images/control-your-sends.png)
2020-04-07 13:14:11 +00:00
2020-08-29 15:56:09 +00:00
## Building
To clone this project, use
`git clone --recursive git@github.com:sparrowwallet/sparrow.git`
2020-08-29 15:56:09 +00:00
In order to build, Sparrow requires Java 14 to be installed. The release packages can be built using
`./gradlew jpackage`
## Running
If you prefer to run Sparrow directly from source, it can be launched with
`./sparrow`
2020-08-29 15:56:09 +00:00
Java 14 must be installed.
## Configuration
Sparrow has a number of command line options, for example to change it's home folder or use testnet:
```
./sparrow -h
Usage: sparrow [options]
Options:
--dir, -d
Path to Sparrow home folder
--help, -h
Show usage
--network, -n
Network to use
Possible Values: [mainnet, testnet, regtest]
```
As a fallback, the network (mainnet, testnet or regtest) can also be set using an environment variable `SPARROW_NETWORK`. For example:
`export SPARROW_NETWORK=testnet`
Note that if you are connecting to an Electrum server when using testnet, that server will need to running on testnet configuration as well.
When not explicitly configured using the command line argument above, Sparrow stores it's mainnet config file, log file and wallets in a home folder location appropriate to the operating system:
2020-08-29 15:56:09 +00:00
Platform | Location
-------- | --------
OSX | ~/.sparrow
Linux | ~/.sparrow
Windows | %APPDATA%/Sparrow
Testnet and regtest configurations (along with their wallets) are stored in subfolders to allow easy switching between networks.
2020-08-29 15:56:09 +00:00
## Reporting Issues
2020-08-29 16:04:27 +00:00
Please use the [Issues](https://github.com/sparrowwallet/sparrow/issues) tab above to report an issue. If possible, look in the sparrow.log file in the configuration directory for information helpful in debugging.
2020-08-29 15:56:09 +00:00
## License
Sparrow is licensed under the Apache 2 software licence.