love /

Filename Size Date modified Message
1.1 KB
Update hgignore
706 B
Added tag 11.1 for changeset 0ab246b5045d
58.4 KB
Fix cmake policy warning
140 B
Created bitbucket-pipelines.yml.
74.8 KB
Copy the data size of old uniforms to the new uniform when reinitializing shader uniforms after love.window.setMode.
66.5 KB
Add accidentally removed email address to the license file
6.9 KB
Added a basic iOS readme.
3.5 KB
Mention automagic being unnecessary when using a source release (resolves #1382)

LÖVE is an awesome framework you can use to make 2D games in Lua. It's free, open-source, and works on Windows, Mac OS X, Linux, Android, and iOS.

Build Status: Windows


We use our wiki for documentation.
If you need further help, feel free to ask on our forums, and last but not least there's the irc channel #love on OFTC.



Follow the instructions at the megasource repository page.


Run platform/unix/automagic from the repository root, then run ./configure and make.

$ platform/unix/automagic
$ ./configure
$ make

When using a source release, automagic has already been run, and the first step can be skipped.

Mac OS X

Download the required frameworks from here and place them in /Library/Frameworks/.

Then use the Xcode project found at platform/xcode/love.xcodeproj to build the love-macosx target.


Download the required libraries from here and place the include and libraries folders
into the platform/xcode/ios folder.

Then use the Xcode project found at platform/xcode/love.xcodeproj to build the love-ios target.

See readme-iOS.rtf for more information.


Visit the Android build repository for build instructions.

Repository information

We use the 'default' branch for development, and therefore it should not be considered stable.
Also used is the 'minor' branch, which is used for features in the next minor version and it is
not our development target (which would be the next revision - version numbers are formatted major.minor.revision.)

We tag all our releases (since we started using mercurial), and have binary downloads available for them.

Experimental changes are developed in the separate love-experiments repository.


The best places to contribute are through the Bitbucket issue tracker and the official IRC channel.
For code contributions, pull requests and patches are welcome. Be sure to read the source code style guide.


Releases are found in the 'downloads' section on bitbucket, are linked on the site,
and there's a ppa for ubuntu, ppa:bartbes/love-stable.

There are also unstable/nightly builds:


  • SDL2
  • OpenGL 2.1+ / OpenGL ES 2+
  • OpenAL
  • Lua / LuaJIT / LLVM-lua
  • FreeType
  • PhysicsFS
  • ModPlug
  • mpg123
  • Vorbisfile
  • Theora