Installing Glue
===============
Glue only depends on one external library, `Pillow `_. a friendly fork of `PIL `_.
This libraries require some external codes in order to manipulate ``jpeg`` images. These codecs aren't available by default in some Linux distributions neither OSX, so it's necessary to install them manually.
OSX
---
If you are using OSX, the easiest way to install the jpeg decoder is using `Homebrew `_.
Before installing ``Homebrew`` you'll need to install Xcode, then you can follow these steps:
.. code-block:: bash
$ brew install jpeg
$ sudo pip install glue
.. note::
If you are using Snow Leopard (10.6) you should install glue using ``sudo env ARCHFLAGS='-arch i386 -arch x86_64' pip install glue``
Debian/Ubuntu
-------------
If you are using Debian/Ubuntu installing ``glue`` is really easy:
.. code-block:: bash
$ apt-get install libjpeg62 libjpeg62-dev zlib1g-dev python-dev
$ sudo pip install glue
You can also install it using the native package:
.. code-block:: bash
$ apt-get install glue-sprite
Windows
-------
1. Install Python, if not yet available. `Python 2.7.2 Windows installer `_.
2. Install PIL, check `this website `_ for a matching version (`PIL-1.1.7 for Python 2.7 `_)
3. Install Python's ``easy_install`` `easy_install installer for Python 2.7 `_.
4. Add Python's Scripts dir to your Path. Add ``;C:\Python27\Scripts`` to the end of the line.
5. Start the cmd and type
.. code-block:: bash
$ easy_install glue
6. Easy isn't?
Development version
-------------------
The source code of Glue is available on Github `https://github.com/jorgebastida/glue/ `_.