Building Shoes on Linux

Building Shoes on Linux

Note on Ruby versions

You should build Shoes with 1.9.1 or 1.9.2, 1.8.7 may work, but isn't guaranteed right now.

Some other details

One should note that in the following, ${SHOES_DIR} is just wherever you want to install your shoes installation to. If you are unsure what to use, just use ~/shoes here. You can make this file hidden (to keep your filesystem navigator from getting cluttered) by using "~/.shoes" instead.

Linux users should install dependencies through the distro’s package manager (these are the yum, apt-get and so on commands you will see below).

Building on Fedora

The following has been tested on Fedora 7, but should work on Fedora 6, CentOS v5 and RHEL5 as well:

git clone git://github.com/shoes/shoes.git ${SHOES_DIR}
cd ${SHOES_DIR} 
gem install bundler
sudo yum install -y giflib-devel cairo-devel libpixman-devel pango-devel libjpeg-devel gtk2-devel libcurl-devel ruby-devel portaudio-devel
rake

Building on Debian

git clone git://github.com/shoes/shoes.git ${SHOES_DIR} 
cd ${SHOES_DIR} 
gem install bundler
sudo apt-get install libcairo2-dev libpixman-1-dev libpango1.0-dev libungif4-dev libjpeg62-dev libgtk2.0-dev libsqlite3-dev libcurl4-openssl-dev portaudio19-dev ruby1.8-dev rake 
rake

Building on Ubuntu

# Install dependencies
sudo apt-get install git-core libcairo2-dev libpixman-1-dev libpango1.0-dev libgif-dev libjpeg-dev libgtk2.0-dev vlc libvlc-dev portaudio19-dev libsqlite3-dev libcurl4-openssl-dev makeself curl

# If using Ubuntu 11.04, fix some path issues (see note below for 64-bit path)
sudo ln -s /usr/lib/i386-linux-gnu/libjpeg.so /usr/lib/libjpeg.so
sudo ln -s /usr/lib/i386-linux-gnu/libsqlite3.so /usr/lib/libsqlite3.so

# Install RVM (see https://rvm.beginrescueend.com/rvm/install/ for detailed instruction) 
bash < <(curl -s https://rvm.beginrescueend.com/install/rvm)
echo [[ -s "$HOME/.rvm/scripts/rvm" ]] && . "$HOME/.rvm/scripts/rvm" # Load RVM function' >> ~/.bash_profile
source ~/.bash_profile

# Test RVM install (should output 'rvm is a function')
type rvm | head -1

# Install ruby and required gems
rvm install 1.9.2
rvm use 1.9.2
gem install bundler

# Clone Shoes source and build
git clone git://github.com/shoes/shoes.git ${SHOES_DIR}
cd ${SHOES_DIR}
rvm use 1.9.2
rake

Ubuntu notes

• Older Ubuntus may get apt-get errors with portaudio19-dev, which was previously known as libportaudio19-dev.

• Ubuntu 11.04 added some architecture-specific directories in /usr/lib that may require manual intervention. For a 32-bit install:

    sudo ln -s /usr/lib/i386-linux-gnu/libjpeg.so /usr/lib/libjpeg.so
    sudo ln -s /usr/lib/i386-linux-gnu/libsqlite3.so /usr/lib/libsqlite3.so
  

  On a 64-bit install:

    sudo ln -s /usr/lib/x86_64-linux-gnu/libjpeg.so /usr/lib/libjpeg.so 
    sudo ln -s /usr/lib/x86_64-linux-gnu/libsqlite3.so /usr/lib/libsqlite3.so
  

Generically:

git clone git://github.com/shoes/shoes.git 
cd shoes 
gem install bundler
gem install mechanize
rake

Building on Arch Linux

There is a package available in AUR. If you have yaourt installed, just

$ yaourt -S shoes-git

Otherwise, build it like any other package from the AUR.

How to Run

Once installed (wherever you set #{SHOES_DIR} to), you can run shoes by entering the command #{SHOES_DIR}/dist/shoes.

If you would prefer a desktop link that will start shoes for you, you can create a custom application launcher which points to this command. In Ubuntu, you can do this by right clicking on the desktop and selecting "Create Launcher" from the drop-down. Enter in "Shoes" for the name and the command #{SHOES_DIR}/dist/shoes into the "command" section. Note though that if you use a ~ in #{SHOES_DIR}, you must replace that with the actual location of your home folder. If your username is bob on the computer, then you would replace ~ with /home/bob/ in the command you enter into this field. Once you click "OK" you should be able to run shoes straight from your desktop. (You can also go through a similar process in order to make the application launchable from you Applications Menu).