Skip to main content

Settings

The editor keeps your settings in one settings.json file. The file is described by the settings schema, which editors such as VS Code use for completion and checking.

The Settings document​

Open it with File › Settings, with Ctrl+, or from the command palette. It opens as a tab, and opening it again switches to the open tab. It needs no project, so you can change a setting from the start page.

The page list on the left holds General, Appearance, Keyboard shortcuts, Run and Extensions. The pages of the extensions that have settings are listed under Extensions, ordered by the extension's name. The fields of the selected page are on the right. Each field has a label, a help text and, when the setting needs a restart, the note Requires restart.

PageWhat is on it
Generalnetprints.language (a drop-down of System and the shipped languages — English for now — applied after a restart) and netprints.enableAnimations
Appearancenetprints.editor.theme, the Dark and Light presets and a preview of them (see Themes)
Keyboard shortcutsevery command with its shortcuts; stored in the keyboard section (see Commands and shortcuts)
Runrun.stopTimeoutSeconds and run.linuxTerminal
Extensionsnetprints.extensionPaths, netprints.trustedProjects and the list of loaded extensions with their version and the folder they came from

Every setting in the table at the end of this page is on one of these pages, and nothing is settable only by editing the file.

Fields​

A page is built from the setting's schema, so a setting always has the editor that fits its type.

Setting typeEditor
Yes or noA check box
Whole or decimal numberA text box that checks the text is a number; the allowed range is checked when you save
TextA text box
Text with a fixed set of valuesA drop-down
Path to a file or a folderA text box with Browse…
List of textA list where you add, remove and move entries; a list of paths also has Browse…

The box above the page list filters the fields of every page by label and description, ignoring case. A page with no matching field disappears from the list, and Extensions stays while one of the pages under it matches. Clearing the box shows everything again.

Saving and validation​

A value is checked when its field loses focus or you press Enter. A list, a check box and a drop-down are checked as soon as you change them.

  • A value that is not valid shows the reason under the field and is not saved. The file keeps the last good value.
  • A valid value is saved to settings.json at once, and applied at once unless the field says Requires restart.
  • A value that did not change writes nothing.

Restart​

When you save a field that needs a restart, the bar Restart to apply appears at the top of the document. Restart now leaves the editor the way File › Exit does, so the prompt about unsaved work still appears. The setting is already saved, so it applies the next time you start the editor.

Extension pages​

An extension that registers a settings section gets a page under Extensions, without writing any user interface. Its fields come from the same schema rules as above; the label is the property name in words and the help text is the property's description. A section of an extension that is not loaded is not shown, and it stays in the file unchanged.

An unreadable settings file​

If settings.json cannot be read, the editor starts with the default value of every setting. Before the first save it copies the unreadable file to settings.json.unreadable-<timestamp> next to it, so nothing you had written is lost, and then writes a new file. Unknown sections and keys in a readable file are always kept as they are.

All built-in settings​

The table is generated from the schema; do not edit it by hand.

KeyTypeDefaultAllowedRestartDescription
netprints.extensionPathslist of stringemptya folder pathYesFolders searched for extensions. Each subfolder that holds a manifest is loaded at the next start
netprints.trustedProjectslist of stringemptya file pathProject files whose extensions you allowed to load
netprints.enableAnimationsbooleantrueTurns the interface animations on. Turn them off to reduce motion
netprints.languagestringemptychoices from netprints.languagesYesThe interface language: en (English), the only language shipped so far. Empty uses the system language
run.stopTimeoutSecondsinteger51 to 600Seconds a stopped program has to exit before its process tree is killed
run.linuxTerminalstringemptyup to 512 characters; matches ^[^\x00-\x1F\x7F]*$Linux only: the terminal command that hosts a run in an external terminal. Empty detects one
keyboard.bindingslist of objectemptyYour changes to the default key bindings, one entry per changed command
netprints.editor.themestringdarkdark, light, systemThe theme variant the editor starts in
netprints.editor.darkPresetstringnetprints.darkup to 128 characters; matches ^[a-z0-9]+([._-][a-z0-9]+)*$; choices from netprints.presets.darkThe id of the preset the Dark variant uses
netprints.editor.lightPresetstringnetprints.lightup to 128 characters; matches ^[a-z0-9]+([._-][a-z0-9]+)*$; choices from netprints.presets.lightThe id of the preset the Light variant uses