Settings

An overview of the various configuration options.

Accessing the settings

Global Settings

Global settings apply to all projects, unless overridden by project-level settings.

You can access the global settings using the Pico-Go > Global settings option in the Command Palette.

Project Settings

Project settings override global settings, though not all global settings can be overridden.

You can access the project settings by using the Pico-Go > Project settings option in the Command Palette.

Options

auto_connect

Autoconnect on USB. If false, manual_com_device should be set.

ProjectGlobalDefault
noyestrue

autoconnect_comport_manufacturers

USB COM port manufacturers. Used with auto_connect to try and identify a Pico board.

ProjectGlobalDefault
noyes"MicroPython", "Microsoft"

ctrl_c_on_connect

If true, executes a ctrl-c on connect to stop running programs.

ProjectGlobalDefault
yesyesfalse

ftp_password

The password to use for authenticating with the Pico-Go FTP server.

ProjectGlobalDefault
noyespico

manual_com_device

Used when auto_connect is false. E.g. COM3 or /dev/tty.usbmodem0000000000001.

ProjectGlobalDefault
yesyestrue

open_on_start

Whether to open the terminal and connect to the board when starting Code. The default setting (from v1.2 onward) is to not launch the Pico Console unless the project has been configured as a Pico-Go project.

ProjectGlobalDefault
yesyesfalse at global level settings
true at project level settings

py_ignore

Comma-separated list of files and folders to ignore when uploading (no wildcard or regular expressions supported).

ProjectGlobalDefault
yesyes[]

python_path

This allows you to set the path to the Python executable manually instead of relying on Python being in your PATH. E.g. /path/to/python3.

ProjectGlobalDefault
noyesnull

reboot_after_upload

Reboots your board after any upload or download action.

ProjectGlobalDefault
yesyestrue

safe_boot_on_upload

Safe-boot before upload.

ProjectGlobalDefault
yesyesfalse

statusbar_buttons

Which quick-access buttons to show in the status bar.

ProjectGlobalDefault
yesyes['status', 'run', 'upload', 'download', 'disconnect', 'listserial', 'settings', 'projectsettings', 'getversion']

sync_all_file_types

If enabled, all files will be uploaded no matter the file type (sync_file_types will be ignored).

ProjectGlobalDefault
yesyesfalse

sync_file_types

Types of files to be synchronized.

ProjectGlobalDefault
yesyes"py,txt,log,json,xml,html,js,css,mpy"

sync_folder

Folder to synchronize. Empty to sync project’s main folder.

ProjectGlobalDefault
yesyes""