Vagrantfile to automate the install of Player-3.0.2 and Stage-4.1.1 in a Ubuntu VM.
Clone or download
Pull request Compare This branch is 25 commits ahead of samueljackson92:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Player/Stage Install Script

A couple of bash scripts to automate the installation process of Player 3 and Stage 4 for Ubuntu, as well as the Vagrantfile used to build the vagrant box.

tl;dr: I just want to use Player/Stage

To jump-start, see Installing via vagrant below. You do not need to clone this repo.

What's New

This is a fork of the original Player/Stage Install Script at samueljackson92/player-stage-install-script. It contains the following changes:

  • Player 3.0.2 and Stage 4.1.1 are used
  • A Vagrantfile has been added to simplify installation in a Ubuntu-based virtual machine using Vagrant. However, a preconfigured box is already available.
  • The install script now uses git and subversion to pull the sources instead of using wget if these tools are installed. This should counteract SourceForge's wonky download behavior.

Installing via vagrant (recommended)

To use the preconfigured Player/Stage box, first install Vagrant. Next, create a Vagrantfile with the following content in your project root:

# -*- mode: ruby -*-
# vi: set ft=ruby :

Vagrant.configure(2) do |config| = "sunside/playerstage"

To bring up the virtual machine, type:

$ vagrant up

which will download the box (if necessary) and start the VM. To connect to it, type:

$ vagrant ssh

You can then execute player and stage commands.

g++, make, cmake etc. are already installed. By default, Vagrant will mount your current working directory to the /vagrant directory within the box. In the easiest case, you just cd /vagrant and build your project.

To shut down the virtual machine (without deleting it), type

$ vagrant halt

More information on how to use Vagrant can be found at the Getting Started tutorial on

Manual Installation

These scripts will automatically update bashrc with correct paths as well as downloading, compiling and installing Player and Stage from source. The script effectively automates the commands outlined in the following two guides:

This script should work with Ubuntu from 11.04+. I've tested it on a fresh install of Ubuntu 12.04 64 bit in a VM and it seems to work fine. I'm unsure if it will work with versions of Ubuntu below 11.04.


The script has now been patched to fix a minor compliation bug with Ubuntu 12.10.


Before installing Player/Stage, ensure that all other versions of Player/Stage have been removed from the machine. If compiled from source this can be done by entering into the directory where Player or Stage was built and running:

$ sudo make uninstall

Also check that any old files relating to Player or Stage have been removed from both /usr/local/lib and /usr/local/lib64 in case this mucks with the paths. Finally, make sure that any path varaibles relating to Player/Stage are removed from the bashrc.

Installing Player/Stage

First, either clone the git repo or download a tarball/zip file containing the files and extract them. Then cd into the directory. Change the two scripts to have executable permissions using the following command:

$ chmod +x

Next, run This adds the path variables stored in path.txt to the bashrc. It's important to do this so that Player/Stage can find each other correctly.

$ ./

Finally, run the script to download, compile and install Player/Stage. The script should get all of the required dependancies if they are not already installed on the system. It will then create a folder called src in the home directory where Player/Stage will be downloaded, complied and installed to the system. Run it with the following.

$ ./

If all works as intended, Player/Stage should then be correctly setup for use with CS264's assignment files.