Lua Virtual Reality Engine
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
bjorn b5c14da4a6 Pass:line errors if only 1 point is provided; 4 days ago
.github Actions; Sponsors; README; 6 days ago
deps LÖVR no longer depends on system-installed Vulkan; 3 weeks ago
etc Actions; Sponsors; README; 6 days ago
src Pass:line errors if only 1 point is provided; 4 days ago
.gitignore Tweak gitignore; 1 year ago
.gitmodules LÖVR no longer depends on system-installed Vulkan; 3 weeks ago
CMakeLists.txt CMake: Don't recompile shaders on every build; 2 weeks ago
LICENSE Year; 11 months ago Actions; Sponsors; README; 6 days ago
Tupfile.lua rm Android flavors for now; 4 weeks ago


A simple Lua framework for rapidly building VR experiences.

You can use LÖVR to easily create VR experiences without much setup or programming experience. The framework is tiny, fast, open source, and supports lots of different platforms and devices.

Build Version Matrix

Homepage | Documentation | FAQ


  • Cross-Platform - Runs on Windows, Mac, Linux, Android, WebXR.
  • Cross-Device - Supports Vive/Index, Oculus Rift/Quest, Windows MR, and has a VR simulator.
  • Beginner-friendly - Simple VR scenes can be created in just a few lines of Lua.
  • Fast - Writen in C11 and scripted with LuaJIT, includes optimized single-pass stereo rendering.
  • Asset Import - Supports 3D models (glTF, OBJ), skeletal animation, HDR textures, cubemaps, fonts, etc.
  • Spatialized Audio - Audio is automatically spatialized using HRTFs.
  • Vector Library - Efficient first-class support for 3D vectors, quaternions, and matrices.
  • 3D Rigid Body Physics - Including 4 collider shapes, triangle mesh colliders, and 4 joint types.
  • Compute Shaders - For high performance GPU tasks, like particles.

Getting Started

It's really easy to get started making things with LÖVR. Grab a copy of the executable from, then write a main.lua script and drag it onto the executable. Here are some example projects to try:

Hello World

function lovr.draw(pass)
  pass:text('Hello World!', 0, 1.7, -3, .5)

Spinning Cube

function lovr.draw(pass)
  pass:cube(0, 1.7, -1, .5, lovr.timer.getTime())

Hand Tracking

function lovr.draw(pass)
  for _, hand in ipairs(lovr.headset.getHands()) do
    pass:sphere(vec3(lovr.headset.getPosition(hand)), .1)

3D Models

function lovr.load()
  model ='model.gltf')

function lovr.draw(pass)
  pass:draw(model, x, y, z)

More examples are on the docs page.


You can build LÖVR from source using CMake. Here are the steps using the command line:

mkdir build
cd build
cmake ..
cmake --build .

See the Compiling Guide for more info.


  • Documentation: Guides, tutorials, examples, and API documentation.
  • FAQ: Frequently Asked Questions.
  • Slack Group: For general LÖVR discussion and support.
  • Matrix Room: Decentralized alternative to Slack.
  • Nightly Builds: Nightly builds for Windows.
  • Compiling Guide: Information on compiling LÖVR from source.
  • Contributing: Guide for helping out with development 💜
  • LÖVE: LÖVR is heavily inspired by LÖVE, a 2D game framework.



MIT, see LICENSE for details.