| Name | cryptoadvance.specter JSON |
| Version |
2.0.2
JSON |
| download |
| home_page | |
| Summary | A GUI for Bitcoin Core & Electrum optimised to work with airgapped hardware wallets |
| upload_time | 2023-09-21 13:40:02 |
| maintainer | |
| docs_url | None |
| author | Stepan Snigirev, k9ert |
| requires_python | <4.0,>=3.7 |
| license | MIT License Copyright (c) 2020 cryptoadvance Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
[](https://docs.specter.solutions/desktop/)
[](https://pypi.org/project/cryptoadvance.specter/)
<!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
**Table of Contents**
- [Specter Desktop](#specter-desktop)
- [DISCLAIMER](#disclaimer)
- [Documentation and Video Walkthrough](#documentation-and-video-walkthrough)
- [Why?](#why)
- [Help wanted: Do you like Specter?](#help-wanted-do-you-like-specter)
- [How to run](#how-to-run)
- [Using the Specter Desktop app](#using-the-specter-desktop-app)
- [Installing Specter from Pip](#installing-specter-from-pip)
- [Connect Specter to Bitcoin Core](#connect-specter-to-bitcoin-core)
- [Tips and tricks (detailed instructions)](#tips-and-tricks-detailed-instructions)
- [Errors, doubts.. Read our FAQ!](#errors-doubts-read-our-faq)
- [Setting up Specter Desktop](#setting-up-specter-desktop)
- [Select how to connect to Bitcoin network](#select-how-to-connect-to-bitcoin-network)
- [Add a new device](#add-a-new-device)
- [Create a new wallet](#create-a-new-wallet)
- [Wallet interface](#wallet-interface)
<!-- END doctoc generated TOC please keep comment here to allow auto update -->
# Specter Desktop
"A specter is haunting the modern world, the specter of crypto anarchy."
The Crypto Anarchist Manifesto - Timothy C. May - Sun, 22 Nov 92 12:11:24 PST
## DISCLAIMER
This software might be ready to be used but at your own risk.
If something doesn't work open an issue here or ask a question in our [Telegram group](https://t.me/spectersupport).
## Documentation and Video Walkthrough
*  [Watch here](https://www.youtube.com/watch?v=v3SEp0SkOWs)
* [documentation](https://docs.specter.solutions/desktop/)
## Why?
Bitcoin Core has a very powerful command line interface and a wonderful daemon. Using PSBT and [HWI](https://github.com/bitcoin-core/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 User Interface around Bitcoin Core with a focus on multisignature setup with airgapped signing devices (aka hardware wallets).
At the moment Specter-Desktop is working with all major hardware wallets including:
- SeedSigner
- Specter DIY (optionally airgapped, using QR codes)
- Blockstream Jade
- ColdCard (optionally airgapped, using an SD card)
- BitBox02
- Passport
- Electrum (optionally airgapped, if running Electrum on an airgapped computer/phone)
- Keystone (airgapped, using QR codes)
- Trezor
- Ledger
- KeepKey
We also support using the Bitcoin Core as a hot wallet, by importing or generating a random BIP39 mnemonic, but this feature is experimental and we do not recommend using it at this stage.
We plan to add support for other hardware wallets as they come up. If you are interested in using Specter with a hardware wallet currently unsupported, let us know by opening an issue here or asking in our [Telegram group](https://t.me/spectersupport).
## Help wanted: Do you like Specter?
Please help us to push forward, fix bugs, refine FAQs and please help each other in the support channel.
As a small team on a tiny budget we are working hard to make Specter better every day – for Bitcoin, for you and for us.
## How to run
### Using the Specter Desktop app
The easiest way to run Specter Desktop is by installing the Specter Desktop app, which you can find on the [GitHub release page](https://github.com/cryptoadvance/specter-desktop/releases).
With this method, all you need to do is just download the right file for your operating system and install it like a normal desktop app (Debian buster is only [partially supported](https://github.com/cryptoadvance/specter-desktop/issues/769))
### Installing Specter from Pip
* Specter requires Python version 3.9 to 3.10.
* Bitcoin Core node should be at least v0.19+, better if it's the latest one from [bitcoincore.org](https://bitcoincore.org/en/download/).
* HWI support requires `libusb`
* Ubuntu/Debian: `sudo apt install libusb-1.0-0-dev libudev-dev python3-dev`
* macOS: `brew install libusb`
* Windows: follow instructions in [`windows.md`](docs/windows.md)
* Arch: `sudo pacman -Syu && sudo pacman -S libusb`
* Fedora/CentOS: `sudo yum -y install libusb libudev-devel python3-devel`
* Install Specter
```sh
pip3 install cryptoadvance.specter
```
* Run Specter
```sh
python3 -m cryptoadvance.specter server
```
* Upgrade Specter
```sh
pip3 install cryptoadvance.specter --upgrade
```
After that, Specter will be available at [http://127.0.0.1:25441/](http://127.0.0.1:25441/).
The above installation-method is quite easy but you have to trust pypi. If you want to verify the software completely yourself while still installing via pip3, you can do something like this (adjust yourself for other versions):
```
wget https://github.com/cryptoadvance/specter-desktop/releases/download/v1.7.0/cryptoadvance.specter-1.7.0.tar.gz
wget https://github.com/cryptoadvance/specter-desktop/releases/download/v1.7.0/SHA256SUMS
sha256sum --ignore-missing --check SHA256SUMS
wget https://github.com/cryptoadvance/specter-desktop/releases/download/v1.7.0/SHA256SUMS.asc
gpg --verify SHA256SUMS.asc
# Now, let's extract the requirements-file and install all requirements with require-hashes
tar -xvzf cryptoadvance.specter-1.7.0.tar.gz cryptoadvance.specter-1.7.0/requirements.txt
# create your ususal virtualenv
virtualenv --python=python3 .env
# activate
pip3 install -r cryptoadvance.specter-1.7.0/requirements.txt --require-hashes --upgrade
# The package cryptoadvance.specter itself cannot be included into requirements.txt
# But we have checked the checksum before so it's safe to install without checking it's hash
pip3 install cryptoadvance.specter-1.7.0.tar.gz
```
You can also run it using Tor, provide SSL certificates to run over https. Https is especially important because browsers don't allow the website to access the camera without secure connection, and we need camera access to scan QR codes.
An example how to run Specter server with SSL certificates (`--key`, `--cert`) over Tor (make sure to walk through the [Tor-document](docs/tor.md) ):
```sh
python3 -m cryptoadvance.specter server --tor --cert=./cert.pem --key=./key.pem
```
### Connect Specter to Bitcoin Core
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 or set in directly in the specter-app settings.
If you are using Bitcoin Core with GUI, set `server=1` in `bitcoin.conf`. This setting allows other programs to talk to the rpc server of Bitcoin Core. It's automatically enabled when you are using bitcoind, but disabled in bitcoin-qt.
If you use Specter from a remote machine and want to use it with hardware wallets connected via USB, please read [this guide on setting up HWIBridge](docs/hwibridge.md) to facilitate such connection to hardware wallets.
Have a look at [development.md](docs/development.md) for further information about hacking on Specter-desktop.
## Tips and tricks (detailed instructions)
- Setting up Specter over Tor: [docs/tor.md](docs/tor.md)
- Using self-signed certificates in local network or Tor: [docs/self-signed-certificates.md](docs/self-signed-certificates.md)
- Running Specter as a service on a linux machine: [docs/daemon.md](docs/daemon.md)
- Beyond local network - how to forward your node through a cheap VPS: [docs/reverse-proxy.md](docs/reverse-proxy.md)
## Errors, doubts.. Read our FAQ!
If you're stuck while installing/configuring Specter or you're looking for more informations about the project, read our [FAQ](docs/faq.md)!
## Setting up Specter Desktop
### Select how to connect to Bitcoin network
Electrum server or...
...via Bitcoin Core node.
### Add a new device
Select signing device
Upload public keys
### Create a new wallet
Select the type of wallet
Pick the device you want to use
Configure the wallet
### Wallet interface
Transactions & UTXOs
Receive & Change Addresses
Send
Settings -> Important for multi-signature wallets. Export printable PDF backup.
Raw data
{
"_id": null,
"home_page": "",
"name": "cryptoadvance.specter",
"maintainer": "",
"docs_url": null,
"requires_python": "<4.0,>=3.7",
"maintainer_email": "",
"keywords": "",
"author": "Stepan Snigirev, k9ert",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/c3/ac/f25a9f3b40ca0bafb176ccd5a10577d3a47adbb132493eae7a5e5ea82745/cryptoadvance.specter-2.0.2.tar.gz",
"platform": null,
"description": "\n[](https://docs.specter.solutions/desktop/)\n\n\n\n[](https://pypi.org/project/cryptoadvance.specter/)\n\n\n\n<!-- START doctoc generated TOC please keep comment here to allow auto update -->\n<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->\n**Table of Contents**\n\n- [Specter Desktop](#specter-desktop)\n - [DISCLAIMER](#disclaimer)\n - [Documentation and Video Walkthrough](#documentation-and-video-walkthrough)\n - [Why?](#why)\n - [Help wanted: Do you like Specter?](#help-wanted-do-you-like-specter)\n - [How to run](#how-to-run)\n - [Using the Specter Desktop app](#using-the-specter-desktop-app)\n - [Installing Specter from Pip](#installing-specter-from-pip)\n - [Connect Specter to Bitcoin Core](#connect-specter-to-bitcoin-core)\n - [Tips and tricks (detailed instructions)](#tips-and-tricks-detailed-instructions)\n - [Errors, doubts.. Read our FAQ!](#errors-doubts-read-our-faq)\n - [Setting up Specter Desktop](#setting-up-specter-desktop)\n - [Select how to connect to Bitcoin network](#select-how-to-connect-to-bitcoin-network)\n - [Add a new device](#add-a-new-device)\n - [Create a new wallet](#create-a-new-wallet)\n - [Wallet interface](#wallet-interface)\n\n<!-- END doctoc generated TOC please keep comment here to allow auto update -->\n\n# Specter Desktop\n\n \"A specter is haunting the modern world, the specter of crypto anarchy.\"\n The Crypto Anarchist Manifesto - Timothy C. May - Sun, 22 Nov 92 12:11:24 PST\n\n## DISCLAIMER\n\nThis software might be ready to be used but at your own risk.\n\nIf something doesn't work open an issue here or ask a question in our [Telegram group](https://t.me/spectersupport).\n\n## Documentation and Video Walkthrough\n\n*  [Watch here](https://www.youtube.com/watch?v=v3SEp0SkOWs)\n* [documentation](https://docs.specter.solutions/desktop/)\n\n## Why?\n\nBitcoin Core has a very powerful command line interface and a wonderful daemon. Using PSBT and [HWI](https://github.com/bitcoin-core/HWI) it can also work with hardware wallets, but at the moment it is too linux-way. The same applies to multisignature setups. \n\nThe goal of this project is to make a convenient and user-friendly User Interface around Bitcoin Core with a focus on multisignature setup with airgapped signing devices (aka hardware wallets).\n\nAt the moment Specter-Desktop is working with all major hardware wallets including:\n- SeedSigner\n- Specter DIY (optionally airgapped, using QR codes)\n- Blockstream Jade\n- ColdCard (optionally airgapped, using an SD card)\n- BitBox02\n- Passport\n- Electrum (optionally airgapped, if running Electrum on an airgapped computer/phone)\n- Keystone (airgapped, using QR codes)\n- Trezor\n- Ledger\n- KeepKey\n\n\nWe also support using the Bitcoin Core as a hot wallet, by importing or generating a random BIP39 mnemonic, but this feature is experimental and we do not recommend using it at this stage.\nWe plan to add support for other hardware wallets as they come up. If you are interested in using Specter with a hardware wallet currently unsupported, let us know by opening an issue here or asking in our [Telegram group](https://t.me/spectersupport).\n\n## Help wanted: Do you like Specter?\nPlease help us to push forward, fix bugs, refine FAQs and please help each other in the support channel.\nAs a small team on a tiny budget we are working hard to make Specter better every day \u2013 for Bitcoin, for you and for us.\n\n## How to run\n\n### Using the Specter Desktop app\nThe easiest way to run Specter Desktop is by installing the Specter Desktop app, which you can find on the [GitHub release page](https://github.com/cryptoadvance/specter-desktop/releases).\nWith this method, all you need to do is just download the right file for your operating system and install it like a normal desktop app (Debian buster is only [partially supported](https://github.com/cryptoadvance/specter-desktop/issues/769))\n\n### Installing Specter from Pip\n* Specter requires Python version 3.9 to 3.10.\n* Bitcoin Core node should be at least v0.19+, better if it's the latest one from [bitcoincore.org](https://bitcoincore.org/en/download/).\n* HWI support requires `libusb` \n * Ubuntu/Debian: `sudo apt install libusb-1.0-0-dev libudev-dev python3-dev`\n * macOS: `brew install libusb`\n * Windows: follow instructions in [`windows.md`](docs/windows.md)\n * Arch: `sudo pacman -Syu && sudo pacman -S libusb`\n * Fedora/CentOS: `sudo yum -y install libusb libudev-devel python3-devel`\n * Install Specter\n```sh\npip3 install cryptoadvance.specter\n```\n* Run Specter\n```sh\npython3 -m cryptoadvance.specter server \n```\n* Upgrade Specter\n```sh\npip3 install cryptoadvance.specter --upgrade\n```\n\nAfter that, Specter will be available at [http://127.0.0.1:25441/](http://127.0.0.1:25441/).\n\nThe above installation-method is quite easy but you have to trust pypi. If you want to verify the software completely yourself while still installing via pip3, you can do something like this (adjust yourself for other versions):\n```\nwget https://github.com/cryptoadvance/specter-desktop/releases/download/v1.7.0/cryptoadvance.specter-1.7.0.tar.gz\nwget https://github.com/cryptoadvance/specter-desktop/releases/download/v1.7.0/SHA256SUMS\nsha256sum --ignore-missing --check SHA256SUMS\nwget https://github.com/cryptoadvance/specter-desktop/releases/download/v1.7.0/SHA256SUMS.asc\ngpg --verify SHA256SUMS.asc\n# Now, let's extract the requirements-file and install all requirements with require-hashes\ntar -xvzf cryptoadvance.specter-1.7.0.tar.gz cryptoadvance.specter-1.7.0/requirements.txt\n# create your ususal virtualenv\nvirtualenv --python=python3 .env\n# activate\npip3 install -r cryptoadvance.specter-1.7.0/requirements.txt --require-hashes --upgrade\n# The package cryptoadvance.specter itself cannot be included into requirements.txt\n# But we have checked the checksum before so it's safe to install without checking it's hash\npip3 install cryptoadvance.specter-1.7.0.tar.gz\n```\n\n\nYou can also run it using Tor, provide SSL certificates to run over https. Https is especially important because browsers don't allow the website to access the camera without secure connection, and we need camera access to scan QR codes.\n\nAn example how to run Specter server with SSL certificates (`--key`, `--cert`) over Tor (make sure to walk through the [Tor-document](docs/tor.md) ):\n\n```sh\npython3 -m cryptoadvance.specter server --tor --cert=./cert.pem --key=./key.pem\n```\n\n### Connect Specter to Bitcoin Core\n\nIf 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 or set in directly in the specter-app settings. \n\nIf you are using Bitcoin Core with GUI, set `server=1` in `bitcoin.conf`. This setting allows other programs to talk to the rpc server of Bitcoin Core. It's automatically enabled when you are using bitcoind, but disabled in bitcoin-qt.\n\nIf you use Specter from a remote machine and want to use it with hardware wallets connected via USB, please read [this guide on setting up HWIBridge](docs/hwibridge.md) to facilitate such connection to hardware wallets. \n\nHave a look at [development.md](docs/development.md) for further information about hacking on Specter-desktop.\n\n## Tips and tricks (detailed instructions)\n\n- Setting up Specter over Tor: [docs/tor.md](docs/tor.md)\n- Using self-signed certificates in local network or Tor: [docs/self-signed-certificates.md](docs/self-signed-certificates.md)\n- Running Specter as a service on a linux machine: [docs/daemon.md](docs/daemon.md)\n- Beyond local network - how to forward your node through a cheap VPS: [docs/reverse-proxy.md](docs/reverse-proxy.md)\n\n## Errors, doubts.. Read our FAQ!\n\nIf you're stuck while installing/configuring Specter or you're looking for more informations about the project, read our [FAQ](docs/faq.md)!\n\n## Setting up Specter Desktop\n\n### Select how to connect to Bitcoin network\n\n\n\nElectrum server or...\n\n\n...via Bitcoin Core node.\n\n\n\n### Add a new device\n\nSelect signing device\n\n\nUpload public keys\n\n\n\n### Create a new wallet\n\nSelect the type of wallet\n\n\nPick the device you want to use\n\n\nConfigure the wallet\n\n\n\n### Wallet interface\n\nTransactions & UTXOs\n\n\nReceive & Change Addresses\n\n\nSend \n\n\nSettings -> Important for multi-signature wallets. Export printable PDF backup.\n\n",
"bugtrack_url": null,
"license": "MIT License Copyright (c) 2020 cryptoadvance Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ",
"summary": "A GUI for Bitcoin Core & Electrum optimised to work with airgapped hardware wallets",
"version": "2.0.2",
"project_urls": {
"Changes": "https://docs.specter.solutions/desktop/release-notes/",
"Documentation": "https://docs.specter.solutions/desktop/",
"Homepage": "https://github.com/cryptoadvance/specter-desktop"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e038a72ca9ff5229bee60fea6ed08afaa25654d4e7a2f2904604a28cd55140e8",
"md5": "e43adab3710120eac48855894175a081",
"sha256": "6914b8085d478ca25867cfcd98a3f22a762b98c2ee47ec555cee6dcb61b8a22a"
},
"downloads": -1,
"filename": "cryptoadvance.specter-2.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e43adab3710120eac48855894175a081",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.7",
"size": 5497784,
"upload_time": "2023-09-21T13:39:56",
"upload_time_iso_8601": "2023-09-21T13:39:56.791308Z",
"url": "https://files.pythonhosted.org/packages/e0/38/a72ca9ff5229bee60fea6ed08afaa25654d4e7a2f2904604a28cd55140e8/cryptoadvance.specter-2.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c3acf25a9f3b40ca0bafb176ccd5a10577d3a47adbb132493eae7a5e5ea82745",
"md5": "81f59136fefe6046e21a758c3c829297",
"sha256": "1daf98041e27821c3b59b939e76458492bfcdaa5b9269687ae897b95230ea545"
},
"downloads": -1,
"filename": "cryptoadvance.specter-2.0.2.tar.gz",
"has_sig": false,
"md5_digest": "81f59136fefe6046e21a758c3c829297",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.7",
"size": 13644184,
"upload_time": "2023-09-21T13:40:02",
"upload_time_iso_8601": "2023-09-21T13:40:02.083256Z",
"url": "https://files.pythonhosted.org/packages/c3/ac/f25a9f3b40ca0bafb176ccd5a10577d3a47adbb132493eae7a5e5ea82745/cryptoadvance.specter-2.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-21 13:40:02",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "cryptoadvance",
"github_project": "specter-desktop",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "cryptoadvance.specter"
}
