|||

Setup

Assuming you have Racket downloaded and installed for your platform, you can install r-cade using raco:

$ raco pkg install r-cade

The only Racket dependency r-cade has are the CSFML bindings. The bindings for it can be found here, but should automatically be installed as well by raco.

Once that’s done, you will need to install a few 3rd party dynamic libraries as well, specific to your platform:

For some of these packages, you may need to choose between 32- and 64-bit. If you don’t know which to choose, simply execute this at the command line to find out:

$ racket -e "(system-type 'word)"

NOTE: I develop on Windows, so if any of the instructions here for MacOS X or Linux are incorrect or could be better, please send me an email!

Once you have completed the setup, feel free to head over to the tutorials.

Windows

On Windows, after installing all the dynamic libraries, please make sure you update your PATH environment variable to include the locations of the DLL files. Once done, you will need to close any terminals or DrRacket and relaunch them so they get the updated environment.

CSFML

Download CSFML library, and unzip it anywhere you want (I personally unzipped it to C:). Then edit your environment variables and add <path-to-CSFML>\bin to your PATH. This will ensure that the dynamic libraries can be found.

OpenAL

Simply download the Windows installer and run it. This will install the OpenAL dynamic library to your Windows\System32 folder and you won’t need to do anything else.

libsndfile

Head over to libsndfile and download the installer and run it. By default, this will install libsndfile (64-bit) to C:\Program Files\Mega-Nerd\libsndfile (the 32-bit version will install to Program Files (x86). You will need to add the <path-to-libsndfile>\bin to your PATH environment variable.

MacOS X

On MacOS X, all the appropriate dependencies can be installed using Homebrew:

$ brew install csfml
$ brew install openal-soft
$ brew install libsndfile

Linux

NOTE: On Linux, installing SFML/CSFML from a package system (e.g. apt-get or yum) installs a bugged version that will not work with R-cade. Instead, you need to download, compile, and install it yourself manually. Instructions for this can be found here:

https://pryp.in/blog/12/build-sfml-and-csfml-on-linux.html

A special shout-out to @elephanter for this!

The page linked above isn’t 100% complete as it doesn’t cover RedHat/CentOS very well. As I get more information, I’ll update this page appropriately.

Debian/Ubuntu

OpenAL and libsndfile can be installed using apt-get:

$ sudo apt-get install libopenal-dev
$ sudo apt-get install libsndfile1

RedHat/CentOS

OpenAL and libsndfile can be installed using yum:

$ sudo yum install openal-soft
$ sudo yum install libsndfile