A platform-independent, Qt-based python GUI for the XCP currency and exchange. The intention of this app is to provided a standalone bundle that automatically takes care of running counterpartyd in the background, much like Bitcoin's own Bitcoin-qt app. On startup, the app takes care of making sure that the following prerequisites are satisifed, and if not alerts the user of this problem before quitting gracefully. In order, these are:
counterpartyd
To run, the project has the following dependencies:
If possible, the project will look for PyQt5 to be installed, and then fallback to PyQt4 if needed, as is the case for Windows 7.
In addition, since the project bundles in counterpartyd within the app, and the repo itself has added it as a submodule, the dependencies for counterpartyd are needed as well and are reproduced below.
To initialize the counterpartyd submodule once cloned run this from within the git directory:
git submodule init
followed by git submodule update --recursive
To run the program, simply run python gui.py
from the command line. The usage is the same as the usage for the
counterpartyd.py
script, with a few exceptions.
For example, a simple command setting the appropriate RPC usernames and passwords is:
python gui.py --rpc-user=rpcuser --rpc-password=rpcpassword --bitcoind-rpc-password=PASSWORD --testnet
--no-counterpartyd
, that allows the GUI to be run without also
starting the counterpartyd server. In this case, the GUI relies on a server that is already running to connect to.The project also is meant to be built as a standalone application (akin to Bitcoin-Qt). To freeze the application, the project relies on py2app.
If installed correctly, the package can be compiled to an executable with python setup.py py2app
on any architecture
with all the above dependencies installed. The freezing process has not been tested so far, and there are expected to be
problems, but this demonstrates a proof of concept of the cross-platform nature of this project.