> For AI agents: the complete documentation index is available at https://retrowin.de5.net/llms.txt, the full documentation bundle is available at https://retrowin.de5.net/llms-full.txt.

# RetroWin FAQ

## Why can't RetroWin detect some app windows?

RetroWin needs Accessibility permission to track windows. Go to **System Settings → Privacy & Security → Accessibility** and make sure RetroWin is enabled.

## macOS says the app is damaged or can't be opened.

Since RetroWin is not distributed through the App Store, macOS Gatekeeper may block it. Go to **System Settings → Privacy & Security**, find the RetroWin prompt, and click **Open Anyway**. Alternatively, run the following command in Terminal:

```bash
xattr -cr /Applications/RetroWin.app
```

## Can I use RetroWin alongside the native macOS Dock?

Yes. RetroWin runs independently and does not replace or modify the Dock. You can use both at the same time, or hide the Dock via **System Settings → Desktop & Dock → Automatically hide and show the Dock**.

## Does RetroWin affect system performance?

RetroWin is lightweight and uses minimal CPU and memory. Window tracking polls once per second and has negligible impact on performance.

## How do I switch themes?

Right-click the Start button and select **Settings**, or click **Settings** in the Start Menu. Go to the **Theme** tab to switch between Windows 98, Windows XP, Windows 7, Windows 8.1, Windows 10, and Windows 11.

## Does it support multiple monitors?

Yes. You can enable or disable the taskbar on each monitor independently in **Settings → General**.

## How do I pin an app to the taskbar?

Right-click on any running app's taskbar button and select **Pin to Taskbar**. Pinned apps remain on the taskbar even when closed, and you can drag to reorder them.

## Can I make the taskbar auto-hide?

Yes. Enable **Auto-Hide** in **Settings → Taskbar**. The taskbar will slide off-screen and reappear when you move your mouse to the bottom edge.

You can also manually show or hide the taskbar from the RetroWin icon in the macOS menu bar (**Show Taskbar** / **Hide Taskbar**).

## The taskbar doesn't auto-hide in fullscreen. What can I do?

Most native fullscreen apps are detected automatically, but some apps (especially Chrome, Electron, or near-fullscreen windows) may not trigger auto-hide reliably.

As a workaround, click the RetroWin icon in the macOS menu bar and choose **Hide Taskbar**. The taskbar stays hidden until you choose **Show Taskbar** again — bottom-edge hover will not bring it back while it is manually hidden.

## Why does an app still appear on the taskbar after I closed its window?

On macOS, clicking the red close button (×) only closes the window — it does not quit the app. The app continues running in the background, which is why it still shows on the taskbar. If you want the app to disappear from the taskbar after closing its window, you have two options:

- Go to **RetroWin Settings → Taskbar** and enable **Follow Window** for that app.
- Right-click the app on the taskbar and select **Close** to fully quit it.

## Why do I need to re-grant Accessibility permission after every update?

macOS ties Accessibility permission to the app's code signature. Since RetroWin is not signed with an Apple Developer certificate, each update produces a different signature, and macOS treats it as a new app. To fix this after updating:

1. Go to **System Settings → Privacy & Security → Accessibility**
2. Select RetroWin in the list, click the **"−"** button to remove it
3. Relaunch RetroWin
4. A system prompt will appear — click **Allow** to re-grant permission

## Which macOS versions are supported?

RetroWin requires macOS 15.0 (Sequoia) or later, and supports both Apple Silicon and Intel Macs.