Get help with
Tap Zap.

Install on MacOS

Download TapZap-mac.dmg from the post-purchase page. Double-click it, then drag the Tap Zap icon onto the Applications shortcut. Eject the DMG when the copy finishes. Open Applications and double-click Tap Zap to launch.

The first launch may take an extra second while MacOS verifies the signature with Apple's notary service. After that, Tap Zap lives in the menu bar — there is no main window. Click the icon to open the popover.

Tap Zap is a universal binary signed by Developer ID Application: Miriam Strehlau and notarized by Apple. It runs natively on Apple Silicon and Intel Macs from MacOS 12 onward.

"Apple cannot verify this app" or Gatekeeper warning

If MacOS blocks the first launch with a warning that the developer cannot be verified, the app was downloaded outside of Safari and lost its quarantine attribute, or your Gatekeeper policy is strict. The fix is one of two paths:

1. Right-click (or Control-click) Tap Zap in Applications and choose Open. Confirm Open in the dialog. MacOS records the exception and never asks again.
2. On MacOS Sonoma and later, open System Settings → Privacy & Security, scroll to the bottom, and click Open Anyway next to the message about Tap Zap. Authenticate with Touch ID or your password.

If neither button appears, the binary is fine but the download was corrupted. Re-download the DMG and try again.

Install on Windows

Download TapZap_v2.34_windows_setup.exe. Right-click the installer, choose Properties, and tick Unblock at the bottom of the General tab if it appears, then click OK. This is Windows's mark-of-the-web — leaving it on can confuse the installer.

Run the installer and follow the prompts. Tap Zap installs to %LocalAppData%\Programs\Tap ZAP\ and adds a Start Menu shortcut. Launch it from the Start Menu after install.

"TapZap_v2.34_windows_setup.exe isn't commonly downloaded"

This is your browser warning you before the file finishes downloading — it is not Windows, and not a virus report. Chrome and Edge flag any installer they have not seen many times before. Tap Zap is a small independent app, so it has not built up that download history yet.

In Chrome: click the downloads icon in the toolbar (or press Ctrl+J), find TapZap_v2.34_windows_setup.exe in the list, click the arrow or ⋮ next to it, and choose Keep → Keep anyway.

In Edge: open the downloads flyout, hover TapZap_v2.34_windows_setup.exe, click ⋯ → Keep, then Show more → Keep anyway.

If Edge refuses to let you through at all, you are not doing it wrong. Depending on your SmartScreen settings, Edge can block an unsigned installer outright with no working "keep anyway" path. Downloading in a different browser is the quickest way around it, and a customer confirmed Firefox works. The file is identical whichever browser fetches it.

If you would rather verify the file first, the SHA-256 checksum of the current installer is published below — compare it before you run anything.

Windows SmartScreen "unrecognized app"

After the download completes, Windows shows a second, separate dialog: a blue Windows protected your PC box. Click More info, then Run anyway.

The Windows installer is not yet code-signed, which is why these warnings can appear. A Windows signing certificate is on the roadmap. The MacOS build is signed and notarized by Apple. For Windows, confirm you downloaded from tapzap.app and compare the checksum below before choosing to run an unsigned installer.

Verifying the Windows installer

Since the installer is unsigned, you can confirm you got the real file. In PowerShell:

Get-FileHash $env:USERPROFILE\Downloads\TapZap_v2.34_windows_setup.exe -Algorithm SHA256

The current TapZap_v2.34_windows_setup.exe (v2.34) should print:

A52ABDD22F7B64A9DAAA4E61A4A6DC2F93C1066B51E9556337846F175DCC8B32

If it matches, the file is exactly what we published. If it does not, delete it and download again from tapzap.app/download. You can also upload the file to VirusTotal for an independent scan.

First launch walkthrough

The popover opens on launch until you activate a license. After activation, Tap Zap runs silently in the background — click the menu bar icon (MacOS) or the system tray icon (Windows) any time to open the popover. Right-click the icon for the menu (Quit, Settings, etc.).

Drag the WARMTH slider to set the color temperature, drag BRIGHTNESS to dim, and use DAY / EVENING / NIGHT presets to jump to common settings. The big red ZAP button at the bottom toggles the filter on and off.

Where to find your license key

After purchase, your license key is delivered two ways. The first is the email receipt from DodoPayments — check your inbox (and spam folder) for a message titled "Your Tap Zap license key" with the key in the body. The second is the post-purchase page at tapzap.app/download: if you still have the redirect URL from checkout open, the page shows your key with a Copy button.

How to activate

Open Tap Zap and paste your key into the license field. Click Activate. A boot animation plays for at least three seconds while Tap Zap reaches the license server, registers your device, and confirms a seat. Once the animation finishes, the filter controls unlock.

The three-second minimum is intentional. It gives the network call enough time to resolve and prevents a flicker between states if your license server response is fast.

"Invalid license key"

The most common causes, in order:

• Whitespace or hidden characters from copy/paste — the key has no spaces. Re-copy directly from the email or download page.
• The key belongs to a different product. Tap Zap keys are issued only by DodoPayments for product pdt_0NXz1tGljWw2jLeIByK4C.
• The order was refunded. Refunded keys are revoked automatically. Email support if you believe this is a mistake.
• You are entering an old beta key from a previous version. Beta keys do not transfer.

"Device limit reached"

Each license includes three device seats. If you have used all three, Tap Zap will not activate on a fourth machine until you free a seat.

To free a seat, launch Tap Zap on the device you want to retire, open the license panel, and click Deactivate. The seat returns immediately. Then activate on the new machine. If the old device is no longer accessible (lost, sold, wiped), email support with your purchase email and we will reset a seat for you.

Transferring to a new computer

Deactivate on the old computer first, then activate on the new one. Keys are not bound to a specific device — they are bound to a seat count. Deactivating and reactivating the same key on a different machine uses the seat that was just freed.

Lost your key

If you still have the post-checkout redirect URL with a payment_id parameter, opening that URL re-shows the key. Otherwise email [email protected] with the email address you used to buy. We look up the order on DodoPayments and resend the key.

Offline grace period

Tap Zap continues to work for seven days if license validation fails because of network issues — flaky Wi-Fi, captive portals, VPNs, DNS problems. After seven days without a successful re-validation, the filter controls lock until Tap Zap can reach live.dodopayments.com again.

The grace period only applies to network failures. If the server explicitly returns "invalid" or "deactivated", the gate locks immediately.

Quarterly re-validation

Roughly every 90 days, Tap Zap pings the license server in the background to confirm your seat is still valid. This is normal and silent. As long as you have network access at some point during that window, you will never see anything change.

Warmth slider

The warmth slider changes requested RGB values from neutral toward red. At its strongest setting the requested values are R=1.0, G=0.0, B=0.0 before software brightness scaling. The 0K label names that setting; it is not a physical color temperature or proof of zero blue optical output. Panel, profile, and active mode affect what light is emitted.

Brightness slider

The brightness slider applies software dimming on top of your hardware brightness. By default it goes down to 10%, which is well below most laptop hardware floors. The hardware backlight stays where it is — Tap Zap scales display transfer values on Mac, a Magnification color matrix by default on Windows, or gamma ramps in Windows Legacy Mode.

If you need to go below 10%, enable Allow Extreme Dim in Windows settings (Tap Zap menu → Settings). On MacOS the floor is fixed at 10% to prevent the screen from going completely black during PWM-Safe mode.

DAY / EVENING / NIGHT presets

The three preset buttons jump the warmth slider to exact Kelvin points on the curve:

• DAY — 4000K. Mild warmth, suitable for daytime work when overhead lighting is cool.
• EVENING — 2700K. Roughly incandescent. Common reading temperature after sundown.
• NIGHT — 0K. Red-screen appearance. The strongest requested RGB warmth setting Tap Zap offers; not a measurement of emitted wavelengths.

A preset button shows as active when the warmth slider is within 2% of the preset value. Drag the slider away from a preset and the highlight clears.

PWM-Safe Mode

Support depends on the display and connection. Some M5 Pro/Max configurations remain unresolved, with no confirmed fix or completion date.

PWM-Safe Mode pins your hardware backlight to 100% while Tap Zap handles all dimming in software. On built-in laptop panels, Tap Zap uses Apple's DisplayServices framework (MacOS) or WMI (Windows) to lock the backlight. On external monitors, Tap Zap tries DDC/CI (Windows) to do the same — only externals that expose DDC/CI control are supported.

On some displays, maximum hardware brightness reduces brightness-control PWM. Other LCD or OLED panels still modulate. This lock does not guarantee flicker-free output or certify safety. The toggle hides itself if no controllable display is present.

On Windows, Tap Zap polls every two seconds to confirm the lock and auto-reverts if it cannot. On MacOS, ambient light compensation is held off the entire time the app is running so it cannot fight the lock.

Menu bar / system tray icon

On MacOS, Tap Zap shows a custom PDF icon in the menu bar — bright red when the filter is active, monochrome when off. Click to open the popover. Right-click for the menu (Quit, Settings, About).

On Windows, Tap Zap shows a system tray icon next to the clock. Click to open. Right-click for the menu.

ZAP button

The big red ZAP button at the bottom of the popover toggles the filter on and off instantly. Slider settings persist across toggles — turning the filter off does not reset your warmth or brightness, it just stops applying them.

Hotkeys

If your version of Tap Zap ships with a global hotkey for ZAP, it is configurable in Settings. Older builds do not include hotkey support — check the changelog for your version.

My screen didn't tint

Walk this checklist:

1. The filter is on. The ZAP button glows red when active. The menu bar / tray icon is also red.
2. No conflicting app is running. Quit f.lux, Iris, Night Shift, True Tone, or any other gamma-table or color-management software. They will fight Tap Zap for the gamma tables and the loudest writer wins.
3. On Windows, try Legacy Mode in Settings. The default Magnification API path doesn't cover every scenario; Legacy Mode falls back to gamma ramps which work everywhere except DRM video.
4. Restart Tap Zap. Quit from the menu and relaunch.
5. If nothing helps, restart the machine. Some display drivers cache gamma state across sessions.

"PWM-Safe Mode not supported on this display"

Your display does not expose a way for Tap Zap to control its backlight. Either it is an external monitor without DDC/CI, or it is connected through an adapter chain that strips DDC/CI (some USB-C hubs, KVMs, or HDMI splitters). Tap Zap will still work normally — you just don't get backlight pinning on that display.

Filter disappears after sleep/wake (MacOS)

This is a known MacOS behavior. After a sleep/wake cycle or display reconfigure, the system can reset the gamma tables. Tap Zap re-applies on its own in most cases, but occasionally a click on the menu bar icon is needed to force a re-apply. A full quit and relaunch always works.

See docs/DISPLAY_RECONFIG_REFERENCE.md in the source if you are curious about the exact retry logic.

Filter doesn't cover Netflix or fullscreen games (Windows)

Windows DRM video and exclusive-fullscreen games bypass the Magnification API. Switch to Legacy Mode in Settings — it uses gamma ramps instead, which the GPU applies before any DRM path. The trade-off: Legacy Mode is per-display gamma rather than full-screen color matrix, so colors at the extreme of the curve can look slightly different.

External monitor isn't getting tinted

Most likely a connection issue. Check that the monitor is plugged in via DisplayPort, HDMI, or Thunderbolt directly to the machine. Adapter chains, KVMs, and some docks can drop DDC/CI or block the Magnification API from reaching the display. If you are on MacOS, try unplugging and replugging the monitor while Tap Zap is running.

Slider feels sticky on MacOS 12

SwiftUI slider performance is genuinely worse on MacOS 12 than on later versions. Update to MacOS 13 or later if possible.

Wrong colors after disabling Tap Zap

Restart the machine first — usually that's all it takes. If colors still look off, the WindowServer is holding stale gamma. On MacOS, run defaults delete com.apple.windowserver in Terminal and log out, then log back in. On Windows, sign out and sign back in.

"License check failed" while online

Tap Zap reaches live.dodopayments.com over HTTPS. If your firewall, corporate proxy, VPN, or DNS resolver blocks that host, the check fails. Try disabling the VPN or switching networks. If you are on a managed corporate machine, ask IT to allow *.dodopayments.com.

Captive portals (hotel Wi-Fi, airport Wi-Fi) also block API calls until you log into the portal. Open a browser, complete the captive portal flow, then retry.

Supported MacOS

MacOS 12 (Monterey) and later. Tap Zap ships as a universal binary, so Apple Silicon and Intel Macs both run native code. There is no Rosetta requirement.

Supported Windows

Windows 10 build 1903 and later, and any version of Windows 11. Any GPU vendor — Intel, AMD, NVIDIA, integrated or discrete — is supported. Tap Zap is DPI-unaware and uses the system scaling factor.

Multi-monitor

The same warmth and brightness settings apply to all connected displays simultaneously. Hot-plug works — connect or disconnect a display while Tap Zap is running and it adjusts automatically.

External monitors with vs. without DDC/CI

External displays that expose DDC/CI brightness control get the full PWM-Safe Mode treatment — Tap Zap pins their backlight at 100% along with any built-in panel. Displays without DDC/CI are skipped, which can make a mixed setup look uneven if PWM-Safe Mode is on. The fix: leave PWM-Safe off if your externals don't all support DDC/CI.

MacBook Pro miniLED (14" / 16")

The 2021+ MacBook Pro miniLED panels use local dimming zones. Applying extreme red at very low brightness can cause visible blooming around bright UI elements. This is a hardware quirk of the panel, not Tap Zap. The effect lessens at higher brightness or warmth settings closer to neutral.

Apple Studio Display & Pro Display XDR

Both are fully supported. The Studio Display does not expose DDC/CI, so PWM-Safe Mode is skipped on it, but warmth and brightness work normally.

What data Tap Zap collects

None beyond license validation. When Tap Zap pings live.dodopayments.com to check your seat, it sends your license key, a stable device ID, and a timestamp. There is no analytics, no telemetry, no crash reporting service, no third-party SDKs. The full Privacy Policy has the formal version.

Why Tap Zap needs network access

License validation only. Tap Zap never opens an outbound connection for any other purpose. If you block its network access entirely, it falls into the seven-day offline grace period and then locks until it can re-validate.

Where your license is stored

On MacOS, the key and activation record live in your Keychain. The last validation timestamp is in ~/Library/Preferences/com.antigravity.tapzap2.plist.

On Windows, the key and activation record are stored in %APPDATA%\TapZap2\settings.ini, encrypted with DPAPI bound to your Windows user account. The timestamp is plaintext in the same INI.

Permissions Tap Zap doesn't need

Tap Zap does not need Accessibility permissions on MacOS. It does not need Screen Recording permissions. It manipulates gamma tables directly through CoreGraphics, which is a public API that doesn't gate on privacy controls.

On Windows, Tap Zap does not require administrator rights to run after install. The installer needs them, but the app itself runs as a normal user.

30-day money-back guarantee

Every Tap Zap license comes with a 30-day money-back guarantee, no questions asked. If Tap Zap doesn't work for you, doesn't run on your hardware, or just isn't what you expected, you get a full refund.

How to request a refund

Email [email protected] with the email address you used to purchase and your DodoPayments order ID (it's in the receipt email). We process refunds within two business days. There is no form, no flowchart, no retention call.

What a refund does to your license

Refunded keys are revoked across all three seats automatically when the refund is processed by DodoPayments. The next time Tap Zap re-validates (immediately, in most cases), the filter controls will lock. The app stays installed in case you want to re-purchase later, but it cannot be used.

Refund policy details

For the formal version, see the Refund Policy.

Tap Zap vs. MacOS Night Shift

Night Shift provides built-in warmth and scheduling. Tap Zap adds a red-screen setting, a separate software brightness slider, and hardware-brightness control on supported displays. A warm or red picture does not independently establish the emitted spectrum or physical flicker. Read the Night Shift comparison.

Tap Zap vs. f.lux

f.lux provides warmth, scheduling, dimming, and special color modes. Tap Zap offers a compact warmth-and-brightness workflow and a hardware-brightness lock on supported displays. Choose by documented capabilities and compatibility, rather than an unmeasured optical promise. Read the f.lux comparison.

Tap Zap vs. Iris

Iris offers color and software brightness controls with a broader range of settings. Tap Zap focuses on two sliders, three presets, and a ZAP button, with PWM-Safe hardware-brightness control where supported. Neither workflow guarantees a particular optical waveform on every display. Read the Iris comparison.

Don't run Tap Zap with other gamma tools

Other color utilities, operating-system warmth, and display modes can override or combine with Tap Zap adjustments. Tap Zap uses display transfer tables on Mac, a Magnification color matrix by default on Windows, and gamma ramps in Windows Legacy Mode. Compare one controller at a time and verify OFF, Quit, wake, and reconnection on each screen.

MacOS

Quit Tap Zap from the menu bar (right-click the icon → Quit). Open Applications and drag Tap Zap to the Trash. Empty the Trash.

For a complete clean, also remove preferences and Keychain entries:

• ~/Library/Preferences/com.antigravity.tapzap2.plist
• Open Keychain Access, search for tapzap2, and delete any matching entries.

Windows

Open Settings → Apps → Installed apps, find Tap Zap, and click Uninstall. Confirm the prompt.

For a complete clean, also delete %APPDATA%\TapZap2\.

Your license stays valid

Uninstalling does not deactivate your seat. You can reinstall and re-paste the same key any time within your three-seat limit. If you want to free a seat before uninstalling, click Deactivate in the license panel first.

What is PWM and why does it cause eye strain

Pulse-width modulation varies the on-time during each light-output cycle to control brightness. Some displays use it, others use different methods or combinations. Frequency, waveform, display mode, content, and viewing conditions matter. This documentation does not establish an eye-strain diagnosis or a universal comfort threshold.

Blue light, melatonin, and the 0K red approach

Evening light-exposure studies show effects on melatonin and circadian timing under specific conditions. They do not establish a clinical benefit from Tap Zap. Its 0K setting reduces the requested green and blue RGB values to zero, producing a red appearance on compatible display paths. Only an optical measurement can establish the emitted spectrum. See the research summary and study limits.

Gamma tables vs. hardware brightness

Hardware brightness and software picture levels are separate controls. Tap Zap reduces RGB picture values through Mac display transfer tables, a Windows Magnification color matrix by default, or gamma ramps in Windows Legacy Mode. PWM-Safe separately holds supported hardware brightness at 100%. This can reduce brightness-control PWM on some panels, but software values alone do not establish the optical waveform.

Why software can't eliminate PWM

A software brightness slider does not directly specify a panel’s optical waveform. Maximum hardware brightness can reduce brightness-control PWM on some displays, but other panels retain modulation. PWM-Safe holds supported hardware brightness at 100% and dims the picture in software; its name is not a safety certification. Appropriate display-specific measurements are needed for physical frequency, depth, or flicker-free claims.