.. _doc_project_manager:

Using the Project Manager
=========================

When you launch Godot, the first window you see is the Project Manager. It lets
you create, remove, import, or play game projects.

.. image:: img/editor_ui_intro_project_manager_01.webp

To change the editors language click on the "Settings" Button in the top right
corner. 

.. image:: img/editor_ui_intro_project_manager_02.webp

Then on the settings page select the language you want from the dropdown menu.

.. image:: img/editor_ui_intro_project_manager_10.webp

.. _doc_creating_and_importing_projects:

Creating and importing projects
-------------------------------

To create a new project:

1. Click the **New** button on the top-left of the window.
2. Give the project a name, choose an empty folder on your computer to save the
   files, and select a rendering backend.
3. Click the **Create & Edit** button to create the project folder and open it in the editor.

.. image:: img/editor_ui_intro_project_manager_04.webp

Using the file browser
~~~~~~~~~~~~~~~~~~~~~~

Click the **Browse** button to open Godot's file browser and pick a location or type
the folder's path in the Project Path field.

.. image:: img/editor_ui_intro_project_manager_05.webp

When you see the green tick on the right, it means the engine detects an empty
folder. You can also click the **Create Folder** button to create an empty
folder based on your project's name.

Opening and importing projects
------------------------------

The next time you open the Project Manager, you'll see your new project in the
list. Double click on it to open it in the editor.

.. image:: img/editor_ui_intro_project_manager_06.webp

You can similarly import existing projects using the **Import** button. Locate the
folder that contains the project or the **project.godot** file to import and
edit it.

.. image:: img/editor_ui_intro_project_manager_08.webp

When the folder path is correct, you'll see a green checkmark.

.. image:: img/editor_ui_intro_project_manager_09.webp

Downloading demos and templates
-------------------------------

From the **Asset Library Projects** tab you can download open source project
templates and demos from the :ref:`Asset Library <doc_what_is_assetlib>` to help
you get started faster.

The first time you open this tab you'll notice that it's asking you to go online.
For privacy reasons the project manager, and Godot editor, can't access the internet
by default. To enable accessing the internet click the "Go Online" button. This will
also allow project manager to notify you about updates. If you wish to turn this off
in the future go into project manager settings and change "Network Mode" to "Offline"

Now that Godot is connected to the internet you can download a demo or template, to
do this:

1. Click on its title.
2. On the page that opens, click the download button.
3. Once it finished downloading, click install and choose where you want to save
   the project.

.. image:: img/editor_ui_intro_project_manager_03.webp

Managing projects with tags
---------------------------

For users with a lot of projects on one PC it can be a lot to keep track of. To aid
in this Godot allows you to create project tags. To add a tag to a project click on the
project in the project manager, then click on the "Manage Tags" button

.. image:: img/editor_ui_intro_project_manager_11.webp

This will open up the manage project tags window. To add a tag click the plus button.

.. image:: img/editor_ui_intro_project_manager_12.webp

Type out the tag name, and click "ok". Your project will now have a tag added to it.
These tags can be used for any other project in your project manager. In addition tags
will stay with projects. So if you tag your project, send it to another machine and
import it into the project manager you will see the tags you created.

To remove a tag from your project manager it must be removed from all the projects it's
used by. Once that's done close the project manager, open it up again, and the tag should
be gone.