|
|
|
|
Electrum - Lightweight Bitcoin client
|
|
|
|
|
=====================================
|
|
|
|
|
|
|
|
|
|
::
|
|
|
|
|
|
|
|
|
|
Licence: MIT Licence
|
|
|
|
|
Author: Thomas Voegtlin
|
|
|
|
|
Language: Python (>= 3.6)
|
|
|
|
|
Homepage: https://electrum.org/
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
.. image:: https://travis-ci.org/spesmilo/electrum.svg?branch=master
|
|
|
|
|
:target: https://travis-ci.org/spesmilo/electrum
|
|
|
|
|
:alt: Build Status
|
|
|
|
|
.. image:: https://coveralls.io/repos/github/spesmilo/electrum/badge.svg?branch=master
|
|
|
|
|
:target: https://coveralls.io/github/spesmilo/electrum?branch=master
|
|
|
|
|
:alt: Test coverage statistics
|
|
|
|
|
.. image:: https://d322cqt584bo4o.cloudfront.net/electrum/localized.svg
|
|
|
|
|
:target: https://crowdin.com/project/electrum
|
|
|
|
|
:alt: Help translate Electrum online
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Getting started
|
|
|
|
|
===============
|
|
|
|
|
|
|
|
|
|
Electrum itself is pure Python, and so are most of the required dependencies.
|
|
|
|
|
|
|
|
|
|
Non-python dependencies
|
|
|
|
|
-----------------------
|
|
|
|
|
|
|
|
|
|
If you want to use the Qt interface, install the Qt dependencies::
|
|
|
|
|
|
|
|
|
|
sudo apt-get install python3-pyqt5
|
|
|
|
|
|
|
|
|
|
For elliptic curve operations, libsecp256k1 is a required dependency::
|
|
|
|
|
|
|
|
|
|
sudo apt-get install libsecp256k1-0
|
|
|
|
|
|
|
|
|
|
Alternatively, when running from a cloned repository, a script is provided to build
|
|
|
|
|
libsecp256k1 yourself::
|
|
|
|
|
|
|
|
|
|
./contrib/make_libsecp256k1.sh
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Running from tar.gz
|
|
|
|
|
-------------------
|
|
|
|
|
|
|
|
|
|
If you downloaded the official package (tar.gz), you can run
|
|
|
|
|
Electrum from its root directory without installing it on your
|
|
|
|
|
system; all the python dependencies are included in the 'packages'
|
|
|
|
|
directory. To run Electrum from its root directory, just do::
|
|
|
|
|
|
|
|
|
|
./run_electrum
|
|
|
|
|
|
|
|
|
|
You can also install Electrum on your system, by running this command::
|
|
|
|
|
|
|
|
|
|
sudo apt-get install python3-setuptools python3-pip
|
|
|
|
|
python3 -m pip install --user .
|
|
|
|
|
|
|
|
|
|
This will download and install the Python dependencies used by
|
|
|
|
|
Electrum instead of using the 'packages' directory.
|
|
|
|
|
|
|
|
|
|
If you cloned the git repository, you need to compile extra files
|
|
|
|
|
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
|
|
|
|
|
git submodule update --init
|
|
|
|
|
|
|
|
|
|
Run install (this should install dependencies)::
|
|
|
|
|
|
|
|
|
|
python3 -m pip install --user .
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Create translations (optional)::
|
|
|
|
|
|
|
|
|
|
sudo apt-get install python-requests gettext
|
|
|
|
|
./contrib/pull_locale
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Creating Binaries
|
|
|
|
|
=================
|
|
|
|
|
|
|
|
|
|
Linux (tarball)
|
|
|
|
|
---------------
|
|
|
|
|
|
|
|
|
|
See :code:`contrib/build-linux/README.md`.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Linux (AppImage)
|
|
|
|
|
----------------
|
|
|
|
|
|
|
|
|
|
See :code:`contrib/build-linux/appimage/README.md`.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Mac OS X / macOS
|
|
|
|
|
----------------
|
|
|
|
|
|
|
|
|
|
See :code:`contrib/osx/README.md`.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Windows
|
|
|
|
|
-------
|
|
|
|
|
|
|
|
|
|
See :code:`contrib/build-wine/README.md`.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Android
|
|
|
|
|
-------
|
|
|
|
|
|
|
|
|
|
See :code:`electrum/gui/kivy/Readme.md`.
|
