**This is an old revision of the document!**

Getting Started

Try GDevelop online or download the desktop version

When you have downloaded GDevelop, open the installer and install the software.:

  • On Windows machines, after launching the installer, use the GDevelop icon on your desktop to launch it. You can also uncompress the installer file (like a zip file) and put the software in any folder.
  • On MacOS, launch the DMG file, drag GDevelop into Applications, and open GDevelop from the Applications folder.
  • On Linux, uncompress the archive and launch the executable.

Once the application is launched, you will be presented with the start page. The start page allows you to open an existing project or to create a new project.

Create a new project

To create a new project select the relevant option on the start page.

A new window will open. This window presents a list of options that allows you to choose from templates/examples or to create a blank project. The examples contain a template that is already to use. The template includes some assets and events to get you started.

Selecting the blank project includes no assets or events. Think of it as you would a blank sheet of paper. This template allows you to start from scratch.

At the bottom of the window, you can select the location where would you like to store your new project.

Once you have selected the default location for your project, click on the name of a starter template or an example to open the game.

Re-open an existing project

To re-open an existing project, select the relevant option on the start page.

Next, browse your local file system to open a project. GDevelop 5 project files are normally saved as “.json” files. Find it in the file menu that opens and select it to open the game.

The icon for this file depends on whether or not you have any default application installed on your computer to edit a “json” files.

By default, the locations of the saved game.json files are:
  • Windows: C:/Users/YourUserName/GDevelop Projects,
  • macOS and Linux: GDevelop Projects directory in your home folder.

Once you have the project open, you will be presented with the Gdevelop editors. Just as you've seen when you created a game for the first time.

Note: GDevelop 4 users, you can learn here how to save your project to open it with GDevelop 5.

Next step: start with tutorials

Continue reading the basic concepts to know how to use Gdevelop.

The tutorials, along with the documentation, are the best ways to learn. It is highly recommended that you read and follow a tutorial!

Learn more about GDevelop

For further information on how to use GDevelop, visit the following pages where everything is explained in more detail:


Be sure to check all examples bundled with GDevelop! They are a good way to learn about the different capabilities of the software.