README.md

   1 Cura\r
   2 ====\r
   3 \r
   4 Read this, it's important!\r
   5 ===========================\r
   6 \r
   7 This is the development version of Cura for LulzBot 3D Printers by Aleph Objects, Inc. It is available here:\r
   8 https://github.com/alephobjects/Cura\r
   9 \r
  10 This branch is based on the upstream version maintained by daid and Ultimaker:\r
  11 https://github.com/daid/Cura\r
  12 \r
  13 \r
  14 Development\r
  15 ===========\r
  16 \r
  17 Cura is developed in Python with a C++ engine. The part you are looking at right now is the Python GUI.\r
  18 The C++ engine is responsible for generating the actual toolpath. For development of the engine check out https://github.com/Ultimaker/CuraEngine\r
  19 \r
  20 Issues\r
  21 ===========\r
  22 \r
  23 Before posting issues (either Bugs, Feature requests or Requests for information) please read our policies carefully. These will be regulary updated and can be found at https://github.com/daid/Cura/wiki/Issue-policies\r
  24 \r
  25 \r
  26 Packaging\r
  27 ---------\r
  28 \r
  29 Cura development comes with a script "package.sh", this script has been designed to run under *nix OSes (Linux, MacOS, FreeBSD). For Windows the package.sh script can be run from bash using git.\r
  30 The "package.sh" script generates a final release package. You should not need it during development, unless you are changing the release process. If you want to distribute your own version of Cura, then the package.sh script will allow you to do that.\r
  31 \r
  32 Both MacOS and Linux require some extra instructions for development, as you need to prepare an environment. Look below at the proper section to see what is needed.\r
  33 \r
  34 Fedora\r
  35 --------\r
  36 \r
  37 Fedora builds Cura by using ```mock```, thereby enabling it to build RPMs for\r
  38 every distribution that ```mock``` has a configuration file for. In pratice\r
  39 this means that Fedora can build RPMs for several versions of Fedora, CentOS\r
  40 and RHEL.\r
  41 \r
  42 Cura can be built under a regular user account, there is no need to have root\r
  43 privileges. In fact, having root privileges is very much discouraged.\r
  44 \r
  45 However, the user account under which the build is performed needs to be a\r
  46 member of the 'mock' group. This is accomplished as follows:\r
  47 \r
  48 ```bash\r
  49 sudo usermod -a -G mock "$(whoami)"\r
  50 ```\r
  51 \r
  52 To install the software that is required to build Cura, run the following\r
  53 commands:\r
  54 \r
  55 ```bash\r
  56 sudo yum install -y git rpmdevtools rpm-build mock arduino\r
  57 \r
  58 # Ensure that the Arduino tools can be found by the build\r
  59 sudo mkdir -p /usr/share/arduino/hardware/tools/avr\r
  60 sudo ln -sf /usr/bin /usr/share/arduino/hardware/tools/avr/bin\r
  61 \r
  62 ```\r
  63 \r
  64 To build and install Cura, run the following commands:\r
  65 \r
  66 ```bash\r
  67 # Get the Cura software, only required once\r
  68 git clone https://github.com/daid/Cura.git Cura\r
  69 \r
  70 # Build for the current system\r
  71 cd Cura\r
  72 ./package.sh fedora\r
  73 \r
  74 # Install on the current system\r
  75 sudo yum localinstall -y scripts/linux/fedora/RPMS/Cura-*.rpm\r
  76 ```\r
  77 \r
  78 Examples of building other configurations:\r
  79 \r
  80 ```bash\r
  81 # Build for Fedora rawhide x86-64 and i386\r
  82 ./package.sh fedora fedora-rawhide-x86_64.cfg fedora-rawhide-i386.cfg\r
  83 \r
  84 # Since only the basename of the mock configurations is used, this also works:\r
  85 ./package.sh fedora /etc/mock/fedora-21-x86_64.cfg /etc/mock/fedora-rawhide-i386.cfg\r
  86 ```\r
  87 \r
  88 Debian and Ubuntu Linux\r
  89 --------\r
  90 \r
  91 To build and install Cura, run the following commands:\r
  92 \r
  93 ```bash\r
  94 git clone https://github.com/daid/Cura.git\r
  95 \r
  96 sudo apt-get install python-opengl python-numpy python-serial python-setuptools python-wxgtk2.8 curl\r
  97 # Run this also if you're building for 32bit Debian\r
  98 sudo apt-get install gcc-multilib g++-multilib\r
  99 \r
 100 cd Cura\r
 101 \r
 102 ./package.sh debian_amd64          # or debian_i386 for 32bit\r
 103 # this will prompt for your root password to run dpkg-deb\r
 104 \r
 105 sudo dpkg -i ./scripts/linux/cura*.deb\r
 106 ```\r
 107 \r
 108 Mac OS X\r
 109 --------\r
 110 The following section describes how to prepare working environment for developing and packaing for Mac OS X.\r
 111 The working environment consist of build of Python, build of wxPython and all required Python packages.\r
 112 \r
 113 We assume you already have Apple hardware with [64bit processor](http://support.apple.com/kb/HT3696) and you are familiar with tools like [virtualenv](http://pypi.python.org/pypi/virtualenv), [virtualenvwrapper](http://virtualenvwrapper.readthedocs.org/en/latest/) and [pip](http://www.pip-installer.org/en/latest/). Also ensure you have modern compiler installed.\r
 114 \r
 115 \r
 116 ###Install Python\r
 117 You'll need **non-system**, **framework-based**, **universal** with **deployment target set to 10.6** build of Python 2.7\r
 118 \r
 119 **non-system**: Output of\r
 120 `python -c "import sys; print sys.prefix"`\r
 121 should *not* start with *"/System/Library/Frameworks/Python.framework/"*.\r
 122 \r
 123 **framework-based**: Output of\r
 124 `python -c "import distutils.sysconfig as c; print(c.get_config_var('PYTHONFRAMEWORK'))"`\r
 125 should be non-empty string. E.g. *Python*.\r
 126 \r
 127 **universal**: Output of\r
 128 ``lipo -info `which python` ``\r
 129 should include both i386 and x86_64. E.g *"Architectures in the fat file: /usr/local/bin/python are: i386 x86_64"*.\r
 130 \r
 131 **deployment target set to 10.6**: Output of\r
 132 ``otool -l `which python` ``\r
 133 should contain *"cmd LC_VERSION_MIN_MACOSX ... version 10.6"*.\r
 134 \r
 135 The easiest way to install it is via [Homebrew](http://mxcl.github.com/homebrew/) using the formula from Cura's repo:\r
 136 `brew install --build-bottle --fresh Cura/scripts/darwin/python.rb --universal`\r
 137 Note if you already have Python installed via Homebrew, you have to uninstall it first.\r
 138 \r
 139 You can also install [official build](http://www.python.org/ftp/python/2.7.3/python-2.7.3-macosx10.6.dmg).\r
 140 \r
 141 \r
 142 FreeBSD\r
 143 --------\r
 144 On FreeBSD simply use the Port Tree (`cd /usr/ports/cad/cura`) to create (`make package`) and install (`make install`) the package as root. Port will check for all necessary dependencies. You can also use the provided binary package with `pkg install Cura`.\r
 145 \r
 146 If you want to create an archive for local use the `package.sh freebsd` script (as an ordinary user) will give you a tarball with the program.\r
 147 \r
 148 \r
 149 ###Configure Virtualenv\r
 150 Create new virtualenv. If you have [virtualenvwrapper](http://virtualenvwrapper.readthedocs.org/en/latest/) installed:\r
 151 `mkvirtualenv Cura`\r
 152 \r
 153 wxPython cannot be installed via pip, we have to build it from source by specifing prefix to our virtualenv.\r
 154 \r
 155 Assuming you have virtualenv at *~/.virtualenvs/Cura/* and [wxPython sources](http://sourceforge.net/projects/wxpython/files/wxPython/2.9.4.0/wxPython-src-2.9.4.0.tar.bz2) at *~/Downloads/wxPython-src-2.9.4.0/*:\r
 156 \r
 157 1. `cd` into *~/Downloads/wxPython-src-2.9.4.0/* and configure the sources:\r
 158 \r
 159         ./configure \\r
 160         CFLAGS='-msse2 -mno-sse3 -mno-sse4' \\r
 161         CXXFLAGS='-msse2 -mno-sse3 -mno-sse4' \\r
 162         --disable-debug \\r
 163         --enable-clipboard \\r
 164         --enable-display \\r
 165         --enable-dnd \\r
 166         --enable-monolithic \\r
 167         --enable-optimise \\r
 168         --enable-std_string \\r
 169         --enable-svg \\r
 170         --enable-unicode \\r
 171         --enable-universal_binary=i386,x86_64 \\r
 172         --enable-webkit \\r
 173         --prefix=$HOME/.virtualenvs/Cura/ \\r
 174         --with-expat \\r
 175         --with-libjpeg=builtin \\r
 176         --with-libpng=builtin \\r
 177         --with-libtiff=builtin \\r
 178         --with-macosx-version-min=10.6 \\r
 179         --with-opengl \\r
 180         --with-osx_cocoa \\r
 181         --with-zlib=builtin\r
 182 \r
 183 2. `make install`\r
 184     Note to speedup the process I recommend you to enable multicore build by adding the -j*cores* flag:\r
 185     `make -j4 install`\r
 186 3. `cd` into *~/Downloads/wxPython-src-2.9.4.0/wxPython/*\r
 187 4. Build wxPython (Note `python` is the python of your virtualenv):\r
 188 \r
 189         python setup.py build_ext \\r
 190         BUILD_GIZMOS=1 \\r
 191         BUILD_GLCANVAS=1 \\r
 192         BUILD_STC=1 \\r
 193         INSTALL_MULTIVERSION=0 \\r
 194         UNICODE=1 \\r
 195         WX_CONFIG=$HOME/.virtualenvs/Cura/bin/wx-config \\r
 196         WXPORT=osx_cocoa\r
 197 \r
 198 5. Install wxPython (Note `python` is the python of your virtualenv):\r
 199 \r
 200         python setup.py install \\r
 201         --prefix=$HOME/.virtualenvs/Cura \\r
 202         BUILD_GIZMOS=1 \\r
 203         BUILD_GLCANVAS=1 \\r
 204         BUILD_STC=1 \\r
 205         INSTALL_MULTIVERSION=0 \\r
 206         UNICODE=1 \\r
 207         WX_CONFIG=$HOME/.virtualenvs/Cura/bin/wx-config \\r
 208         WXPORT=osx_cocoa\r
 209 \r
 210 6. Create file *~/.virtualenvs/Cura/bin/pythonw* with the following content:\r
 211 \r
 212         #!/bin/bash\r
 213         ENV=`python -c "import sys; print sys.prefix"`\r
 214         PYTHON=`python -c "import sys; print sys.real_prefix"`/bin/python\r
 215         export PYTHONHOME=$ENV\r
 216         exec $PYTHON "$@"\r
 217 \r
 218 At this point virtualenv is configured for wxPython development.\r
 219 Remember to use `python` for pacakging and `pythonw` to run app for debugging.\r
 220 \r
 221 \r
 222 ###Install Python Packages\r
 223 Required python packages are specified in *requirements.txt* and *requirements_darwin.txt*\r
 224 If you use virtualenv, installing requirements as easy as `pip install -r requirements_darwin.txt`\r
 225 \r
 226 \r
 227 ###Package Cura into application\r
 228 Ensure that virtualenv is activated, so `python` points to the python of your virtualenv (e.g. ~/.virtualenvs/Cura/bin/python).Use package.sh to build Cura:\r
 229 `./package.sh darwin`\r
 230 \r
 231 Note that application is only guaranteed to work on Mac OS X version used to build and higher, but may not support lower versions.\r
 232 E.g. Cura built on 10.8 will work on 10.8 and 10.7, but not on 10.6. In other hand, Cura built on 10.6 will work on 10.6, 10.7 and 10.8.\r
 233 \r