Skip to Content
DocumentsGetting Started

Getting Started

1. Download and install

Download the installer for your platform from the homepage：

  • macOS: download the .dmg file and drag it to Applications
  • Windows: download the .exe installer and follow the wizard

System requirements: macOS 10.15+ / Windows 10+.

2. Grant Accessibility permission

VeilWin needs to read window bounds and track the focused window:

  • macOS: the first-run wizard guides you through granting Accessibility permission in System Settings → Privacy & Security → Accessibility. Dimming starts automatically once granted (status is always visible under Settings → General → Accessibility)
  • Windows: no extra permission needed

The permission is used locally only: window info is read to decide which window stays bright. Nothing is uploaded.

3. Enable dimming

  • Click “Enable dimming” in the tray menu, or press the default global hotkey ⌃⌥⌘H (macOS) / Ctrl+Alt+Super+H (Windows)
  • Everything except the focused window fades into the dark
  • Press the hotkey again to restore

4. Adjust the intensity

The default intensity is 40%. Adjust it under Settings → Appearance or with intensity hotkeys:

  • Intensity up/down: unbound by default — customize under Settings → Hotkeys (e.g. ⌃⌥↑)
  • The tray menu also offers quick intensity controls

5. Set up your first profile (optional)

  1. Open Settings → Profiles
  2. Create a new profile from the “Standard” or “Eye Care” template
  3. Tune intensity, tint, animation and focus scope
  4. Bind a hotkey for “Activate profile” under Settings → Hotkeys and switch with one key

6. Explore more

Stuck? Check the FAQ or email contact@once.work

Last updated
IntroductionHelp Center