User Settings Directory

Index of All Documentation » Wing Pro Reference Manual » Introduction »


The first time you run Wing, it will create your User Settings Directory automatically. This directory is used to store your license, preferences, default project, history, and other files used internally by Wing. It also contains any user-defined snippets, scripts, color palettes, syntax colors, file sets, and shared perspectives.

Wing cannot run without this directory. If it cannot be created, Wing will exit.

The settings directory is created in a location appropriate to your operating system. That location is listed as your Settings Directory in the About Box accessible from the Help menu.

On Windows the settings directory is called Wing IDE 6 and is placed within the per-user application data directory. For Windows running on c: with an English localization the location is:

c:\Users\${username}\AppData\Roaming\Wing IDE 6

In Wing Personal the settings directory is instead named Wing Personal 6.0 and in Wing 101 it is called`` Wing 101 6.0``.

On Linux and OS X the settings directory is a sub-directory of your home directory:

~/.wingide6

In Wing Personal this directory is instead called .wing-personal6 and in Wing 101 it is called .wing-101-6.

Cache Directory

Wing also creates a Cache Directory that contains the source analysis caches, auto-save directory, and a few other things. This directory is also listed in Wing's About box, accessed from the Help menu.

On Windows, the cache directory is located in the AppData\Local area. On Linux, it is ~/.cache/wingide6 and on OS X, it can be found with the symbolic link ~/.wingide6/cache-dir-symlink.

In Wing Personal, this directory is instead called wingpersonal6 and in Wing 101 it is called wing101-6.

Overriding Settings and Cache Directories

The default location of the settings directory can be changed by passing --settings=fullpath on the command line, where fullpath is the full path of the directory to use. If the directory does not exist it will be created only if its parent directory exists. Otherwise, Wing falls back to using the default location for the settings directory.

Similarly, the default location of the cache directory can be changed with --cache=fullpath.

Shared User Settings Directory

Another way to override the default settings directory is to create a directory named user-settings inside of the Wing installation directory. When this is present, Wing will use it instead of the default location.

Creating this directory allows settings to be shared between multiple users that log into the same machine. Permissions on the directory do need to allow read and write for all users that will be using Wing.

This is not recommended if multiple users log into the same machine concurrently because settings changed by one user will be overwritten by another user without any notice, and the default project file will be locked if opened by multiple users.

If the Wing installation directory is shared on a network drive, this directory should never be created because the User Settings Directory is not designed to be used on multiple machines.