**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, use the GDevelop icon on your desktop to launch it. On MacOS, open GDevelop from the Applications folder or drag it to your dock for permanent placement.

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

Create a new project

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

In the next window you can choose from templates/examples or create a blank project. A template is already including some assets and events to get you started, the blank project including nothing so you need to start from scratch.

You can select the location where would you like to store your new project on the bottom of the window:

Once you have selected the default location for your project, click on the name of a starter 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 you need to browse your local file system to open a project. GDevelop 5 project files are normally saved as “.json” file. Find it, and select it to open.

The icon of this file is depends on whether you have any default application installed on your computer to edit such file.

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 should be presented with the editors like when you created the 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: get started with tutorials

Continue by reading the basic concepts to know to use GDevelop.

It's then recommended to 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.