Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time

This package provides Haskell bindings for the SDL2 library.

What is SDL2?

SDL (Simple DirectMedia Layer) is a library for cross-platform development of interactive applications. SDL provides routines for managing windows, rendering graphics, processing sound, collecting input data, and much more.

The Haskell sdl2 library provides both a high- and low-level API to interface with SDL.

You may also want to check out:

  • sdl2-image - For handling different image formats such as jpg and png.
  • sdl2-mixer - For playing audio.
  • sdl2-gfx - For drawing graphics primitives such as circles and polygons.
  • sdl2-ttf - For handling true type fonts.


Build Status

If you don't have SDL 2.0.6 or higher on your system via your package manager, you can install it from the official SDL site.

On Ubuntu you can install from source with a simple

./configure && make -j4 && sudo make install

On OSX you can install SDL with homebrew. pkg-config is also recommended.

brew install sdl2 pkg-config

On Windows you can install SDL with pacman under MSYS2 (or use stack's embedded MSYS2).

pacman -S mingw-w64-x86_64-pkg-config mingw-w64-x86_64-SDL2

Get Started

Take a look at the getting started guide.


We need your help! The SDL API is fairly large, and the more hands we have, the quicker we can reach full coverage and release this to Hackage. There are a few ways you can help:

  1. Browse and find functions that aren't exposed in the high-level bindings.

  2. The above can be somewhat laborious - an easier way to find out what's missing is to write code.

    Both of these would be useful if they were translated to Haskell, and we'd be happy to store this code in this repository.

  3. Documentation is welcome, but may not be the best use of your time as we are currently in a period of rapid development as we find the most productive API.


Using cabal repl

You can use cabal repl as a development tool, but you'll need to configure the project in a slightly non-standard way first:

cabal configure --ghc-option=-fPIC

You only need to do this once (unless you reconfigure). From this point, cabal repl should Just Work.

If you get an Invalid window error, try the -fno-ghci-sandbox option. For example, in ghci:

:set -fno-ghci-sandbox