Go to file
Jon Layton 037a27e3cf BTC->ZCL-USD exchange rates, ux 2018-01-22 22:42:12 -06:00
.idea Fixed headers and verification 2018-01-17 02:23:18 -06:00
contrib include servers_testnet.json and checkpoints_testnet.json in every binary 2017-12-27 14:21:05 +01:00
gui Improve titlebar title 2018-01-18 22:35:42 -05:00
icons Replaced Electrum BTC icons for ZCL icons 2018-01-18 21:55:26 -05:00
lib BTC->ZCL-USD exchange rates, ux 2018-01-22 22:42:12 -06:00
plugins fix #3680 (trezor: spending from multisig) 2018-01-12 19:21:09 +01:00
pubkeys Add my own public key. 2015-06-26 14:49:02 +09:00
scripts revert mod imp name 2018-01-15 03:05:47 -04:00
snap updated snap packaging details 2017-10-20 23:23:32 +02:00
.gitignore Ported encoding/decoding of blocks to python3.5 based of the latest electrum 3.0.5 release 2018-01-13 16:50:41 -05:00
.travis.yml Cache pip installs in travis 2018-01-07 22:55:00 +01:00
AUTHORS Add self to AUTHORS 2015-11-09 22:53:27 +09:00
Info.plist Revert "follow-up f7200cb6162ba30f4ebd0e94d933f7b7d559cdb2: remove Info.plist" 2017-11-06 19:04:07 +01:00
LICENCE Relicensing 2016-02-24 10:20:30 +01:00
MANIFEST.in remove themes, check python3 in setup.py 2015-10-18 12:43:20 +02:00
README.rst Update git repo in readme to point to electrum-zcl 2018-01-20 16:19:31 +00:00
RELEASE-NOTES version 3.0.5 2018-01-08 01:22:12 +01:00
app.fil updates for i18n translations 2016-08-01 10:04:11 +02:00
clean.sh Added clean.sh, servers-orig 2018-01-14 21:34:22 -05:00
config test config sample file 2018-01-15 01:09:48 -04:00
electrum separate merchant UI from main project 2018-01-12 10:37:14 +01:00
electrum-env chmod +x electrum-env 2018-01-09 20:19:30 +02:00
electrum-mac Build instructions for Mac 2018-01-19 11:26:14 -06:00
electrum.conf.sample update doc for sample conf file 2016-04-12 20:01:28 +02:00
electrum.desktop Replaced Electrum BTC icons for ZCL icons 2018-01-18 21:55:26 -05:00
electrum.icns Updated mac icon to meet aesthetic of Windows icon 2017-07-25 00:03:36 -07:00
icons.qrc Adjust colors if dark color scheme is used 2017-10-04 15:17:20 +02:00
requirements_travis.txt Cache pip installs in travis 2018-01-07 22:55:00 +01:00
setup-mac.sh Mac installation works great - added setup-mac.sh and updated readme 2018-01-19 20:49:32 -06:00
setup.py Updating setup.py file with new project info and dependencies 2018-01-18 23:17:05 -06:00
tox.ini Let travis run the test using Python3 2017-08-26 08:28:24 +02:00

README.rst

ZCL Electrum - Lightweight Zclassic Client
==========================================

Forked from **spesmilo/electrum**: https://github.com/spesmilo/electrum

Original Project Info
---------------------
::

  Licence: MIT Licence
  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
.. 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



Getting started
===============

Electrum is a pure python application. If you want to use the
Qt interface, install the Qt dependencies.


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::

    ./electrum


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/BTCP-community/electrum-zcl.git
    cd electrum-zcl

For Mac:
--------

Using Homebrew::

    # Install Homebrew
		/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

		# (Optionally)
		sudo chown -R "$USER":admin /usr/local
		sudo chown -R "$USER":admin /Library/Caches/Homebrew

    # Install python3
		brew install python3
		brew link python3
		brew postinstall python3

		# Python setuptools
		curl https://bootstrap.pypa.io/ez_setup.py -o - | python3

    # Install pyqt5
		pip3 install pyqt5

		# Setup
		python3 setup.py install
		pyrcc5 icons.qrc -o gui/qt/icons_rc.py

		# Run
		./electrum

Alternatively, copy the generated `build/scripts-3.6/electrum` to the main directory::

    cp -f build/scripts-3.6/electrum electrum-mac
    ./electrum-mac


For Linux:
----------

Install Dependencies::

    sudo apt-get install python3-pyqt5
    sudo pip2 install pyblake2

    sudo apt-get install python3-setuptools
    python3 setup.py install

Compile the icons file for QT::

    sudo apt-get install pyqt5-dev-tools
    pyrcc5 icons.qrc -o gui/qt/icons_rc.py

For the linux app launcher (start menu) icon::

    sudo desktop-file-install electrum.desktop

Compile the protobuf description file::

    sudo apt-get install protobuf-compiler
    protoc --proto_path=lib/ --python_out=lib/ lib/paymentrequest.proto

Create translations (optional)::

    sudo apt-get install python-requests gettext
    ./contrib/make_locale

Run::
    
    ./electrum



ZCL Hints and Debug
===================

There are several useful scripts in::

    scripts

This is a good initial check to determine whether things are working.::

    cd scripts
    python3 block_headers

It should run, validating chunks without error.

Also be sure to check out:::

    ~/.electrum-zcl/

    `~/.electrum-zcl/wallets/` has your wallet files - this folder can be backed up.

    `~/.electrum-zcl/config` has your Electrum connection object.


=================


To create binaries, create the 'packages' directory::

    ./contrib/make_packages

This directory contains the python dependencies used by Electrum.

Mac OS X / macOS
----------------

::
    
    # On MacPorts installs: 
    sudo python3 setup-release.py py2app
    
    # On Homebrew installs: 
    ARCHFLAGS="-arch i386 -arch x86_64" sudo python3 setup-release.py py2app --includes sip
    
    sudo hdiutil create -fs HFS+ -volname "Electrum" -srcfolder dist/Electrum.app dist/electrum-VERSION-macosx.dmg

Windows
-------

See `contrib/build-wine/README` file.


Android
-------

See `gui/kivy/Readme.txt` file.