Compiling instructions

From Bitmessage Wiki
Revision as of 18:16, 19 November 2012 by Atheros (talk | contribs)
Jump to navigation Jump to search

This page should help novice users run Bitmessage from the source code files.

Windows

  1. Download and install the latest revision of Python 2.7 (currently Python 2.7.3 from here). The Windows x86 MSI Installer is the right choice for most people. (64-bit users may want the 64-bit version).
  2. Test that it installed:
    1. Open a command prompt by going to Start > Run. Type 'cmd' then press enter.
    2. type 'python'. If python is installed, you should see the python version and the prompt: '>>>'
    3. If you see a message such as: "'Python is not recognized as an internal or external command..." then you must add the python path to your path environmental variable:
      1. Find the location where Python was installed (in particular, the location where python.exe exists). It might simply be in c:\Python2.7
      2. Follow these directions to add the Python path to your path variable.
      3. Close the command prompt window and reopen it.
      4. Try running 'python' again.
    4. Press Ctrl-Z to exit Python.
  3. Bitmessage has only one dependency (PyQt) which you will need to download yourself. Download and install PyQt from here. You will want the Binary Package since it is already compiled for you. Be sure to select the version for Python 2.7. It is labeled as Py2.7.
  4. Download the source code for PyBitmessage from GitHub. If it is in a zip file, you will need to extract it. There should be a number of files (around ten) and an rsa folder.
  5. To run Bitmessage, double click on the bitmessagemain.py file, or in a command prompt, change directories to the directory holding bitmessagemain.py and type 'python bitmessagemain.py'.

If you change user interface files

You can use Qt's Designer application to change .ui files. After you do this, you will need to 'compile' them into .py files.

  1. In a command prompt, change directories to the directory of your .ui file.
  2. Run 'pyuic4 example.ui > example.py' If you get a message similar to 'pyuic4 is not recognized as an internal or external command' then you must add the PyQt directory to your system's path variable. This directory should hold pyuic4.bat. It might be in C:\Python27\Lib\site-packages\PyQt4. Remember to close the command window and reopen it after you change your path variable.

If you add icons to bitmessage_icons.qrc, then you must run this command: pyrcc4 bitmessage_icons.qrc -o bitmessage_icons_rc.py

Optional: Compile into a stand-alone EXE

  1. Download PyInstaller.
  2. Copy all of the source code files to the PyInstaller directory (which contains pyinstaller.py).
  3. Run 'pyinstaller.py --onefile main.py'