Install Gloam—and verify what you downloaded.

Before you download

Use the version-pinned links on the official Gloam download section. The page publishes the current file size and SHA-256 digest from the same release manifest used to build the links. A matching digest shows that your local file matches the published artifact; it does not establish that every behavior in an app is safe.

• Mac requires macOS 13 or later.
• Windows requires 64-bit Windows 10 version 1809 or later, or Windows 11.
• The Windows build is self-contained; no separate .NET runtime is required.
• Download only from the pinned GitHub release linked by jtrlabs.com.

Install on macOS

1. Download Gloam.dmg. Save it to Downloads and wait for the browser to finish.
2. Optional: verify SHA-256. Open Terminal and run shasum -a 256 ~/Downloads/Gloam.dmg. Compare all 64 characters with the macOS digest on the release-integrity panel.
3. Open the disk image. Double-click Gloam.dmg. Drag Gloam into the Applications shortcut in the disk image.
4. Launch from Applications. Eject the disk image, open Applications, and double-click Gloam. macOS may ask you to confirm the first launch because the app came from the internet.
5. Look for the menu-bar icon. Gloam is a menu-bar app, so it does not remain in the Dock. Its popover opens on first launch.

If the Mac app does not appear

• Check the right side of the menu bar; use Control Center if icons are crowded.
• Open Activity Monitor and search for Gloam before launching a second copy.
• Confirm that the app was copied to Applications rather than run permanently from the read-only disk image.
• For a managed work Mac, your administrator may prevent third-party software from running.

Install on Windows

1. Download Gloam-Windows.zip. The current archive is about 63.2 MB.
2. Optional: verify SHA-256. Open PowerShell and run Get-FileHash "$env:USERPROFILE\Downloads\Gloam-Windows.zip" -Algorithm SHA256. Compare it with the Windows ZIP digest on the download page.
3. Extract the archive. Right-click the ZIP, select Extract All, and choose a stable location such as Documents\Gloam. Do not run the EXE from inside the ZIP.
4. Launch Gloam.exe. Gloam opens a popover and places its icon in the notification area. If the icon is hidden, open the taskbar overflow menu.
5. Keep the EXE in place. Gloam is portable. If you enable Launch at login, Windows stores the current EXE path; moving it afterward breaks that startup entry until you launch it from the new location and toggle the setting again.

If Windows filtering has no visible effect

• Turn off HDR for the affected display under Settings → System → Display → HDR; Windows can ignore gamma ramps while HDR is active.
• Update the graphics driver if Windows Night light is also unavailable or the display driver is listed as Basic Display.
• Some DisplayLink adapters and recent NVIDIA configurations can limit or ignore gamma changes.
• Try a stronger Gloam preset and verify the filter toggle is on before troubleshooting brightness.

Recommended first-run setup

1. Select Focus (5000K) in a bright room or Dusk (3400K) near sunset.
2. Move to Natural (6500K) temporarily for photo, video, print, or brand-color work.
3. Open Schedule. macOS can calculate sunrise and sunset with approximate location permission; Windows 1.0.3 uses the times you enter.
4. Enable breaks and try the default interval for a day before making it more aggressive.
5. Test every external display. Gamma support depends on the display path and driver.

Update without losing settings

Download the new pinned release and verify it. On Mac, quit Gloam, replace the existing Applications copy, then reopen it. On Windows, quit from the tray, extract the new archive, and replace the old EXE in the same folder. Settings remain separate from the executable: macOS uses local application preferences; Windows uses %APPDATA%\Gloam\state.json.

Uninstall cleanly

Mac

Quit Gloam from its menu, then move Gloam.app from Applications to Trash. The app resets display gamma when it quits normally.

Windows

Quit Gloam from the notification area, disable Launch at login first, then delete Gloam.exe and its folder. To remove saved settings too, delete %APPDATA%\Gloam.