# places

> **Tool `tools/install/places.py`** (library, Installing builds). Where an installed build goes on each system, and where its player's data goes.

A library: other tools and your own scripts import it. [Source on GitHub](https://github.com/tanepiper/game-frame/blob/main/tools/install/places.py).

## Its own help

This is the help text in the tool itself, as `./gameframe tool places` prints it.

```text
Where an installed build goes on each system, and where its player's data goes.

The programs go in a GameFrame folder among the system's applications. The data (settings,
library, saves) goes in the user's own data folder, so a new install never touches it.

| System  | Programs                                   | Data                                          |
|---------|--------------------------------------------|-----------------------------------------------|
| macos   | /Applications/GameFrame/NAME.app (else ~/Applications/GameFrame) | ~/Library/Application Support/GameFrame/NAME |
| windows | %LOCALAPPDATA%\Programs\GameFrame\NAME    | %APPDATA%\GameFrame\NAME                      |
| linux   | $XDG_DATA_HOME/GameFrame/NAME (~/.local/share) | $XDG_CONFIG_HOME/GameFrame/NAME (~/.config) |

Windows and Linux install per user, with no administrator rights. On macOS /Applications is
used when this user can write to it, as an administrator can.
```