Options

--settings-dir <directory>

Reads all settings (such as profile information) from the specified <directory>. If the directory does not exist, it will be created.

The default value is system-specific. For example:

Linux: $HOME/.config/QtProject/qbs

Windows: %APPDATA%\QtProject\qbs

macOS: $HOME/Library/Preferences/qbs

--list [<root> ...]

Lists keys under the key <root> or all keys if the root is not specified.

Possible values are:

defaultProfile is the default profile to use if a profile is not specified

preferences accepts build preferences as second-level keys

profiles accepts profile names as second-level keys

--unset <key>

Removes the specified <key>.

--export <file>

Exports settings to the specified <file>.

--import <file>

Imports settings from the specified <file>.

--help|-h|-?

Displays help for the command.

Parameters

<key>

Typically, a <key> consists of several levels separated by periods. The first level shows a root value, such as preferences or profiles. The root determines whether the second-level keys are build preferences or profile names. The lower level keys consist of a module name, followed by a property name.

Examples

Lists the existing profiles:

qbs config --list profiles

Shows the default profile:

qbs config defaultProfile

Note: If no output is shown, the default profile used is the built-in profile none, which sets no properties.

Sets the profile called gcc as the base profile of the Qt profile called myqt:

qbs config profiles.myqt.baseProfile gcc

Adds the location of a custom module to your preferences, to make the module accessible in several projects: