# Vault Display — Kiosk Setup

## Goal

Launch seven browser windows automatically, one for each shop display:

- matrix-1
- matrix-2
- matrix-3
- matrix-4
- counter
- tv
- window

Each browser window opens:

```text
/public/display.php?screen=SCREEN_KEY
```

## Windows

Use:

```text
scripts/windows/start-vault-display.bat
```

or:

```powershell
powershell -ExecutionPolicy Bypass -File scripts/windows/start-vault-display.ps1
```

To start automatically on login:

1. Press `Win + R`.
2. Run `shell:startup`.
3. Place a shortcut to `start-vault-display.bat` in that folder.

Edit monitor positions inside:

```text
scripts/windows/start-vault-display.ps1
```

## Linux Mint / Ubuntu

Use:

```bash
chmod +x scripts/linux/start-vault-display.sh
./scripts/linux/start-vault-display.sh
```

To autostart:

```bash
mkdir -p ~/.config/autostart
cp scripts/linux/vault-display-autostart.desktop ~/.config/autostart/
```

Then edit the `Exec=` path in:

```text
~/.config/autostart/vault-display-autostart.desktop
```

## Monitor Positioning

The launchers include default positions for seven 1920x1080 screens.

You will almost certainly need to adjust these based on the actual OS display layout.

### Linux check

```bash
xrandr --query
```

### Windows check

Open:

```text
Settings → System → Display
```

Then arrange displays and note their order.

## Recommended Shop Use

For the four-screen matrix, arrange the OS display layout as:

```text
[ matrix-1 ] [ matrix-2 ]
[ matrix-3 ] [ matrix-4 ]
```

Then put other screens wherever Windows/Linux reports them.

The app itself uses the `screen=` key to decide content. The OS positions only determine where the windows open.