# Simple DirectMedia Layer 3.0

This is the SDL3 wiki. SDL2 is [over here](/SDL2)!

## Try it right now!

SDL3 has officially stabilized the API and ABI, and a preview release is available at
[the GitHub page](https://github.com/libsdl-org/SDL/releases/tag/preview-3.1.6).
We will still be adding things to the API but not changing or removing anything, so it's
safe to start porting your projects from SDL2.

Need some motivation? Here's a list of [New Features](NewFeatures) that you can
enjoy today in SDL3!

## What is it?

Simple DirectMedia Layer is a cross-platform development library designed to
provide low level access to audio, keyboard, mouse, joystick, and graphics
hardware via OpenGL/Direct3D/Metal/Vulkan. It is used by video playback
software, emulators, and popular games including
[Valve](https://valvesoftware.com)'s award winning catalog and many
[Humble Bundle](https://www.humblebundle.com) games.

SDL officially supports Windows, macOS, Linux, iOS, and Android, and several
other platforms.

SDL is written in C, works natively with C++, and has bindings available for
several other languages, including C#, Python, and [Rust](https://crates.io/crates/sdl3).

SDL 3.0 (often shortened to "SDL3") is distributed under the
[zlib license](https://www.libsdl.org/license.php). This license allows you
to use SDL freely in any software.

This is the SDL wiki; SDL's main website is [libsdl.org](https://libsdl.org/).

This wiki is your portal to documentation and other resources for SDL 3.0.

## Using the SDL documentation Wiki

- [Source Code](SourceCode): How to download the source code to SDL.
- [Installation](Installation): How to install SDL on your platform of choice
  and link your program against it.

## API references

The official documentation for the API.  Look here to find detailed
information about the functions, structures, enumerations and macros.

- [API by category](APIByCategory)
- [Complete API index](CategoryAPI)
- [All functions](CategoryAPIFunction)
- [All datatypes](CategoryAPIDatatype)
- [All structures/unions](CategoryAPIStruct)
- [All enums](CategoryAPIEnum)
- [All macros](CategoryAPIMacro)
- [API Quick Reference](QuickReference)

## Other sources of information

- Want to learn about a feature in SDL you haven't used before?
  Our [tutorials](Tutorials) are great place to get started!
- Here is a collection of [articles](Articles) that have been written
  about SDL3.
- Here is a collection of external [libraries](Libraries), to extend SDL
  functionality.
- Looking for more information than you can get online?
  Check out the [books](Books) list.
- A few of the most commonly asked questions about using SDL are answered
  in the [FAQs](FAQs) section.
- We have [forums/mailing lists](https://discourse.libsdl.org/) for talking
  with other humans, and of course,
  [a Discord server](https://discord.gg/BwpFGBWsv8). Both are great places
  to keep up with the latest news, help other users out, and ask questions.

## Other stuff

We hope you find everything you are looking for and enjoy using SDL!

If anything is not addressed somewhere here, feel free to
[open an issue](https://github.com/libsdl-org/SDL/issues) or
[submit a pull request](https://github.com/libsdl-org/SDL/pulls).

**Enjoy!**