Repository files navigation

raylib is a simple and easy-to-use library to enjoy videogames programming.

raylib is highly inspired by Borland BGI graphics lib and by XNA framework and it's specially well suited for prototyping, tooling, graphical applications, embedded systems and education.

NOTE for ADVENTURERS: raylib is a programming library to enjoy videogames programming; no fancy interface, no visual helpers, no auto-debugging... just coding in the most pure spartan-programmers way.

Ready to learn? Jump tocode examples!

• NO external dependencies, all required libraries are bundled into raylib
• Multiple platforms supported:Windows, Linux, MacOS, Android, HTML5... and more!
• Written in plain C code (C99) in PascalCase/camelCase notation
• Hardware accelerated with OpenGL (1.1, 2.1, 3.3 or ES 2.0)
• Unique OpenGL abstraction layer (usable as standalone module):rlgl
• MultipleFonts formats supported (TTF, XNA fonts, AngelCode fonts)
• Outstanding texture formats support, including compressed formats (DXT, ETC, ASTC)
• Full 3D support, including 3D Shapes, Models, Billboards, Heightmaps and more!
• Flexible Materials system, supporting classic maps andPBR maps
• Animated 3D models supported (skeletal bones animation)
• Shaders support, including model andpostprocessing shaders.
• Powerful math module for Vector, Matrix and Quaternion operations:raymath
• Audio loading and playing with streaming support (WAV, OGG, MP3, FLAC, XM, MOD)
• VR stereo rendering support with configurable HMD device parameters
• Huge examples collection with+115 code examples!
• Bindings to+40 programming languages!
• Free and open source.

raylib uses on itscore module the outstandingGLFW3 library, embedded in the form ofrglfw module, to avoid external dependencies.

raylib uses on itsraudio module, the amazingminiaudio library to support multiple platforms and multiple audio backends.

raylib uses internally several single-file header-only libraries to support different fileformats loading and saving, all those libraries are embedded with raylib and available insrc/external directory. Checkraylib Wiki for a detailed list.

On Android platform,native_app_glue module (provided by Android NDK) and native Android libraries are used to manage window/context, inputs and activity life cycle.

On Raspberry Pi platform (native mode),Videocore API andEGL libraries are used for window/context management. Inputs are processed usingevdev Linux libraries

On Web platform, raylib usesemscripten provided libraries for several input events management, specially noticeable the touch events support.

raylib binary releases for Windows, Linux and macOS are available at theGithub Releases page.

raylib is also available via multiplepackage managers on multiple OS distributions.

You can download and install raylib using thevcpkg dependency manager:

  git clone https://github.com/Microsoft/vcpkg.git  cd vcpkg  ./bootstrap-vcpkg.sh  ./vcpkg integrate install  vcpkg install raylib

The raylib port in vcpkg is kept up to date by Microsoft team members and community contributors. If the version is out of date, pleasecreate an issue or pull request on the vcpkg repository.

raylib Wiki contains detailed instructions on building and usage on multiple platforms.

• Working on Windows
• Working on macOS
• Working on GNU Linux
• Working on FreeBSD
• Working on Raspberry Pi
• Working for Android
• Working for Web (HTML5)
• Working for UWP (Universal Window Platform)
• Working anywhere with CMake

Note that Wiki is open for edit, if you find some issue while building raylib for your target platform, feel free to edit the Wiki or open and issue related to it.

raylib has been developed on Windows platform usingNotepad++ andMinGW GCC compiler but it can be used with other IDEs on multiple platforms.

Projects directory contains several ready-to-useproject templates to build raylib and code examples with multiple IDEs.

Note that there are lots of IDEs supported, some of the provided templates could require some review, please, if you find some issue with some template or you think they could be improved, feel free to send a PR or open a related issue.

• Webpage:http://www.raylib.com
• Discord:https://discord.gg/raylib
• Twitter:http://www.twitter.com/raysan5
• Twitch:http://www.twitch.tv/raysan5
• Reddit:https://www.reddit.com/r/raylib
• Patreon:https://www.patreon.com/raylib
• YouTube:https://www.youtube.com/channel/raylib

If you are using raylib and enjoying it, please, join ourDiscord server and let us know! :)

raylib is licensed under an unmodified zlib/libpng license, which is an OSI-certified, BSD-like license that allows static linking with closed source software. CheckLICENSE for further details.