# Install the Desktop App

The Fluxlay desktop app renders wallpapers on your desktop and connects to the dev server for live preview.

## Download

Visit the [download page](/download) and select the installer for your platform.

## Supported Platforms

| Platform         | Architecture          | Format          |
| ---------------- | --------------------- | --------------- |
| macOS            | Apple Silicon (arm64) | `.dmg`          |
| macOS            | Intel (x64)           | `.dmg`          |
| Windows 11 22H2+ | x64                   | `.exe` / `.msi` |

Windows 10 is supported on a best-effort basis. On Windows, wallpapers render across all virtual desktops (per-Space switching is not available due to WorkerW limitations) and are hidden when a fullscreen game is running.

## First Launch

1. **macOS**: open the `.dmg` and drag Fluxlay to Applications. **Windows**: run the `.exe` (or `.msi`) installer.
2. Launch Fluxlay.
3. Grant the required permissions when prompted (macOS: accessibility, screen recording).
4. The Fluxlay icon appears in your menu bar (macOS) or system tray (Windows) — the app runs in the background.

## Verify Installation

Run the dev server from a wallpaper project:

<PackageManagerCommand type="exec" command="fluxlay dev" />

The desktop app automatically detects the dev server and renders the wallpaper on your desktop.
