2016-03-05 22:44:10 -08:00
|
|
|
Electrum - Lightweight Bitcoin client
|
2015-06-27 00:58:45 -07:00
|
|
|
=====================================
|
|
|
|
|
|
|
|
::
|
|
|
|
|
2016-02-23 02:36:42 -08:00
|
|
|
Licence: MIT Licence
|
2015-06-27 00:58:45 -07:00
|
|
|
Author: Thomas Voegtlin
|
|
|
|
Language: Python
|
|
|
|
Homepage: https://electrum.org/
|
|
|
|
|
|
|
|
|
|
|
|
.. image:: https://travis-ci.org/spesmilo/electrum.svg?branch=master
|
|
|
|
:target: https://travis-ci.org/spesmilo/electrum
|
|
|
|
:alt: Build Status
|
2017-11-08 13:31:13 -08:00
|
|
|
.. image:: https://coveralls.io/repos/github/spesmilo/electrum/badge.svg?branch=master
|
|
|
|
:target: https://coveralls.io/github/spesmilo/electrum?branch=master
|
2017-11-08 08:58:17 -08:00
|
|
|
:alt: Test coverage statistics
|
|
|
|
|
2015-06-27 00:58:45 -07:00
|
|
|
|
|
|
|
|
|
|
|
|
2016-03-05 22:44:10 -08:00
|
|
|
|
|
|
|
|
|
|
|
Getting started
|
|
|
|
===============
|
|
|
|
|
2017-04-01 19:55:09 -07:00
|
|
|
Electrum is a pure python application. If you want to use the
|
|
|
|
Qt interface, install the Qt dependencies::
|
2016-03-05 22:44:10 -08:00
|
|
|
|
2017-09-22 20:54:38 -07:00
|
|
|
sudo apt-get install python3-pyqt5
|
2016-03-05 22:44:10 -08:00
|
|
|
|
2017-04-01 19:55:09 -07:00
|
|
|
If you downloaded the official package (tar.gz), you can run
|
2016-03-05 22:44:10 -08:00
|
|
|
Electrum from its root directory, without installing it on your
|
2016-03-18 01:20:00 -07:00
|
|
|
system; all the python dependencies are included in the 'packages'
|
|
|
|
directory. To run Electrum from its root directory, just do::
|
2015-06-27 00:58:45 -07:00
|
|
|
|
|
|
|
./electrum
|
|
|
|
|
2016-10-15 03:12:10 -07:00
|
|
|
You can also install Electrum on your system, by running this command::
|
|
|
|
|
2017-09-19 06:24:17 -07:00
|
|
|
sudo apt-get install python3-setuptools
|
2017-08-31 21:13:46 -07:00
|
|
|
python3 setup.py install
|
2016-10-15 03:12:10 -07:00
|
|
|
|
|
|
|
This will download and install the Python dependencies used by
|
|
|
|
Electrum, instead of using the 'packages' directory.
|
|
|
|
|
2017-04-01 19:55:09 -07:00
|
|
|
If you cloned the git repository, you need to compile extra files
|
2016-03-05 22:44:10 -08:00
|
|
|
before you can run Electrum. Read the next section, "Development
|
|
|
|
Version".
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Development version
|
|
|
|
===================
|
|
|
|
|
|
|
|
Check out the code from Github::
|
|
|
|
|
|
|
|
git clone git://github.com/spesmilo/electrum.git
|
|
|
|
cd electrum
|
|
|
|
|
2016-03-17 04:52:40 -07:00
|
|
|
Run install (this should install dependencies)::
|
|
|
|
|
2017-08-31 21:13:46 -07:00
|
|
|
python3 setup.py install
|
2016-03-17 04:52:40 -07:00
|
|
|
|
2016-03-05 22:44:10 -08:00
|
|
|
Compile the icons file for Qt::
|
|
|
|
|
2017-09-22 20:54:38 -07:00
|
|
|
sudo apt-get install pyqt5-dev-tools
|
|
|
|
pyrcc5 icons.qrc -o gui/qt/icons_rc.py
|
2016-03-05 22:44:10 -08:00
|
|
|
|
|
|
|
Compile the protobuf description file::
|
|
|
|
|
|
|
|
sudo apt-get install protobuf-compiler
|
|
|
|
protoc --proto_path=lib/ --python_out=lib/ lib/paymentrequest.proto
|
|
|
|
|
2016-10-15 03:12:10 -07:00
|
|
|
Create translations (optional)::
|
2016-03-05 22:44:10 -08:00
|
|
|
|
|
|
|
sudo apt-get install python-pycurl gettext
|
|
|
|
./contrib/make_locale
|
|
|
|
|
|
|
|
|
|
|
|
|
2015-06-27 00:58:45 -07:00
|
|
|
|
2016-03-05 22:44:10 -08:00
|
|
|
Creating Binaries
|
|
|
|
=================
|
|
|
|
|
2015-06-27 00:58:45 -07:00
|
|
|
|
2017-04-01 19:55:09 -07:00
|
|
|
To create binaries, create the 'packages' directory::
|
2015-06-27 00:58:45 -07:00
|
|
|
|
2016-03-17 04:52:40 -07:00
|
|
|
./contrib/make_packages
|
2015-06-27 00:58:45 -07:00
|
|
|
|
2016-03-18 01:20:00 -07:00
|
|
|
This directory contains the python dependencies used by Electrum.
|
2016-03-05 22:44:10 -08:00
|
|
|
|
2017-09-26 17:40:22 -07:00
|
|
|
Mac OS X / macOS
|
2016-03-05 22:44:10 -08:00
|
|
|
--------
|
2015-06-27 00:58:45 -07:00
|
|
|
|
2016-04-17 10:59:18 -07:00
|
|
|
::
|
2015-06-27 00:58:45 -07:00
|
|
|
|
2016-04-17 10:59:18 -07:00
|
|
|
# On MacPorts installs:
|
2017-09-26 17:40:22 -07:00
|
|
|
sudo python3 setup-release.py py2app
|
2016-04-17 10:59:18 -07:00
|
|
|
|
|
|
|
# On Homebrew installs:
|
2017-09-26 17:40:22 -07:00
|
|
|
ARCHFLAGS="-arch i386 -arch x86_64" sudo python3 setup-release.py py2app --includes sip
|
2016-04-17 10:59:18 -07:00
|
|
|
|
2015-06-27 00:58:45 -07:00
|
|
|
sudo hdiutil create -fs HFS+ -volname "Electrum" -srcfolder dist/Electrum.app dist/electrum-VERSION-macosx.dmg
|
2016-03-05 22:44:10 -08:00
|
|
|
|
|
|
|
Windows
|
|
|
|
-------
|
|
|
|
|
2016-04-17 10:59:18 -07:00
|
|
|
See `contrib/build-wine/README` file.
|
2016-03-05 22:44:10 -08:00
|
|
|
|
|
|
|
|
|
|
|
Android
|
|
|
|
-------
|
|
|
|
|
2016-04-17 10:59:18 -07:00
|
|
|
See `gui/kivy/Readme.txt` file.
|