Getting Started


This guide will teach you how to install LÖVR, create a project, and run it.

Installing LÖVR

First, download LÖVR from the home page or click here. Extract the zip archive and open up the folder. You should see the lovr.exe executable and a bunch of .dll files.

Archive Contents

Double click on lovr.exe to open LÖVR. You should see a window with the LÖVR logo in it. This is what's shown if you run LÖVR without specifying a project.

The Default Project

We're going to make a project so we see something more interesting than the logo.

Creating a Project

A LÖVR project is just a folder. The folder can have anything necessary for your app, like 3D models, sound files, or Lua code. There isn't any required structure for the folder, so you can organize it however you want.

There is one special file that LÖVR looks for though, called main.lua. If you put a main.lua file in your project folder, LÖVR will run the code in there when the project starts.

Create a file called main.lua in a project folder and type the following Lua code in it:

function lovr.draw(pass)
  pass:text('hello world', 0, 1.7, -3, .5)

Don't worry if you're confused about the code, it's not important to understand it all right now. In short, we declared the lovr.draw callback and used Pass:text in there to render some text in the world. We'll learn more about how this works in the next guide.

Running a Project

To run a LÖVR project, drop its folder onto lovr.exe. You can also run lovr.exe from the command line and pass the path to the project folder as the first argument.

Drag and Drop

On macOS and Linux, the project can be run by running the lovr executable with the path to the project folder as an argument.

On macOS, the executable is located at If you put in the /Applications directory, you can add alias lovr="/Applications/" to your .zprofile to make it so you can run with lovr main.lua from the terminal.

If you followed the example above, you should see the following in VR:

Hello World


Next Steps

The next guide will teach you how to make fancier projects using Callbacks and Modules.

If you want to learn more about Lua, some good resources are:

  1. Programming in Lua
  2. Learn Lua in 15 Minutes