Py Editor MAC USER MANUALpythoneditor.io ↗ · Version 27.0.3 (33)

Open, create or clone a project

A project is a folder. Use the launcher to create one, open one from disk, clone a repository or return to work you opened before.

Open the project launcher

  1. Choose File → Show Project Launcher (⇧⌘L).
  2. Read RECENTLY OPENED for the projects you used last.

The Welcome to Py Editor window lists up to six recent project cards.

Create a project in a new folder

  1. In the launcher, click New Python Project.
  2. Enter the project name in Save As.
  3. Check Where and change the destination folder if you want.
  4. Click Create.

The project opens in its own window with main.py and pyproject.toml in the Project panel. Creating a project does not close other project windows.

Open a folder that is not in the launcher yet

  1. Click Open Project in the launcher, or choose File → Open Project… (⌘O).
  2. Select the folder in the macOS chooser. Press Command-Shift-G and enter a path if you know it.
  3. Click Open.

The folder opens in a new project window and its files appear in Project. The folder then appears in the launcher list. Opening a folder does not create a Python environment or run anything, so a folder of documents opens the same way.

Find a project you opened before

  1. Choose File → Show Project Launcher.
  2. Type part of the project name, its pyproject.toml description or its path into Search a workspace, or type a path…. Press Command-K to return focus to the field.
  3. Use the Up and Down arrow keys to select a result under RESULTS.
  4. Press Return to open it.

Click Clear workspace search at the end of the field to return to the recent list. The search covers projects the launcher already knows; use Open Project the first time you open a folder.

Reopen a recent project from the menu

Choose File → Recent Projects and pick a project name. The toolbar's project chip menu also lists up to six recent projects.

Clone a repository

Cloning needs Helper.

  1. Click Clone Repository in the launcher, or choose Git → Clone….
  2. Enter the repository address in Repository URL.
  3. Check Save in, and click Choose… to pick a different parent folder.
  4. Click Clone.

Clone stays unavailable until the URL supplies a usable repository name. Py Editor clones the repository and opens it as a project.

Switch between open project windows

Choose the project name from the macOS Window menu to bring an already-open project forward. Its files and panel arrangement are as you left them. This switches existing windows; it does not create a project.

Remove a project from the launcher list

  1. Control-click the project card in the launcher.
  2. Choose Remove from Projects.

The card disappears from the list. The folder stays on disk, and you can open it again with Open Project.