1.  Released Versions

1.1  GNU/Linux

Debian and RPM packages are available for the first release of Shoebot:

• Debian, Ubuntu: http://tinkerhouse.net/shoebot/packages/deb/shoebot_0.1-1_all.deb
• Fedora, CentOS, OpenSUSE, Mandriva: http://tinkerhouse.net/shoebot/packages/rpm/shoebot-0.1-1.rpm

The release source can also be downloaded here:

• http://tinkerhouse.net/shoebot/packages/shoebot_0.1-1.tar.gz

1.2  Mac OS X

A Mac OS X version is not yet packaged, but the development version can be installed (see below).

1.3  Windows

There isn't a packaged Windows version yet, but you can grab the source and libraries and start playing. Check the 'To install on Windows' section below.

2.  Development versions

2.1  To install on GNU/Linux

Shoebot uses Mercurial for version control, and depends on a few common libraries. These are available on most major GNU/Linux distributions; fire up your terminal and type:

Debian/Ubuntu:

    sudo apt-get install mercurial \
    python-cairo python-gtk2 python-gobject python-pygments python-imaging

Fedora:

    yum install pycairo pycairo-devel pygtk2 pygtk2-devel \
    pygobject2 pygobject2 pygobject2-devel python-imaging

Fedora:

    yum install mercurial

Gentoo:

    emerge mercurial

Make a temporary directory to download all source files into, and then get the source itself.

    mkdir ~/src
    cd ~/src
    hg clone https://code.goto10.org/hg/shoebot

You should now see a new shoebot/ directory. The only remaining step is to install it proper.

    cd shoebot
    sudo python setup.py install

Now head over to the Getting Started page to read on how to use Shoebot.

2.2  To install on Mac OS X

Shoebot was tested on Mac OS X on an Intel Mac; while we can't promise this will work for you - as Shoebot is being developed mainly in GNU/Linux - here are the steps that will hopefully make Shoebot work on your Mac.

First, you'll require MacPorts to install the necessary dependencies. After getting it, run the following commands in a terminal window (Applications, Utilities, Terminal):

    sudo port -v install cairo +glitz +quartz +pdf
    sudo port install pycairo  
    sudo port install mercurial

For using the text capabilities, Freetype is also needed: (not sure if this is the right command, please email me if you test it!)

    sudo port install freetype

Make a temporary directory to get the Shoebot source files, and then get the source itself.

    mkdir ~/src
    cd ~/src
    hg clone https://code.goto10.org/hg/shoebot

You should now see a new shoebot/ directory. The only remaining step is to install it proper:

    cd shoebot
    sudo python setup.py install

Now head over to the Getting Started page to read on how to use Shoebot.

2.3  To install on Windows

On windows, Python runtime and some libraries are required.

Python 2.5.2

• http://www.python.org/download/releases/2.5.2/

GTK+ runtime for Win32 (project page)

• http://sourceforge.net/project/downloading.php?group_id=98754&filename=gtk-2.12.9-win32-2.exe

PyGTK, PyCairo, PyGobject (project page)

• http://ftp.gnome.org/pub/GNOME/binaries/win32/pygtk/2.12/pygtk-2.12.1-2.win32-py2.5.exe
• http://ftp.gnome.org/pub/GNOME/binaries/win32/pycairo/1.4/pycairo-1.4.12-1.win32-py2.5.exe
• http://ftp.gnome.org/pub/GNOME/binaries/win32/pygobject/2.14/pygobject-2.14.1-1.win32-py2.5.exe

GtkSourceView2, PyGTKsourceview2 (project page)

• http://ftp.gnome.org/pub/GNOME/binaries/win32/gtksourceview/2.2/gtksourceview-2.2.2.zip
• http://ftp.gnome.org/pub/GNOME/binaries/win32/pygtksourceview/2.2/pygtksourceview-2.2.0.win32-py2.5.exe

unpack gtksourceview-2.0.zip into the GTK installation directory (usually, on GTK+ runtime for Win32, this is C:\GTK containing folders bin, share, etc,...).

unpack pygtksourceview-2.0.zip into the python installation directory (usually where the python runtime is. this is C:\Python25).

PIL Python Imaging Library for windows (project page)

• http://effbot.org/downloads/PIL-1.1.6.win32-py2.5.exe

Shoebot

• https://code.goto10.org/hg/index.cgi/shoebot/archive/13e54c70387a.zip
  • 　It is needed newer than revision 13e54c70387a.

how to install shoebot:

• unpack the Shoebot zip-file and do "setup.py install" on command line.

for example. unpack shoebot-13e54c70387a.zip into "C:\temp\shoebot-13e54c70387a". open a command line prompt(ex: [win]+R -> execute "cmd.exe"). Do "setup.py install".

    C:\>cd temp\shoebot-13e54c70387a
    C:\temp\shoebot-13e54c70387a>c:\Python25\python.exe setup.py install

Installation is complete.

note, on rev:13e54c70387a. ICON_FILE path is missing.

ICON_PATH of "shoebot-ide" and "gtkui.py" are missing.

Change ICON_FILE of "shoebot-ide" and "gtkui.py" to..

    --------
     if sys.platform != 'win32':
    -     ICON_FILE = '/usr/share/shoebot/icon.png'
    +     ICON_FILE = '/usr/share/pixmaps/shoebot-ide.png'
     else:
          import os.path
    -     ICON_FILE = os.path.join(sys.prefix, 'share', 'shoebot', 'icon.png')
    +     ICON_FILE = os.path.join(sys.prefix, 'share', 'pixmaps', 'shoebot-ide.png')
    --------

How to start shoebot-ide

execute this command.

    c:\Python25\python c:\Python25\Scripts\shoebot-ide

2.4  To update to the latest version

To update your copy of Shoebot, just change to the shoebot source directory and run a Mercurial update and re-run the install command:

    cd ~/src/shoebot/
    hg update
    sudo python setup.py install

3.  Inkscape Plugin

Once the development version of ShoeBot is installed, and Inkscape, you can install the Inkscape Plugin:

    cd ~/src
    hg clone http://freehg.org/u/rlafuente/shoebot-inkscape/
    cp shoebot-inkscape/* ~/.inkscape/extensions/

4.  Libraries

Some of the libraries distributed with Nodebox are in the process of being adapted for the use with Shoebot. The porting process is still in progress, so there are things that may not work as expected. The libraries can be retrieved from this unofficial repository, where you can find instructions to install them. For library reference and tutorials and for notes about the license, at the moment you will have to see the corresponding section of Nodebox's site

That's all there is to it!