---
title: DonutHole
slug: donuthole
docTags: 
createdAt: 2025-02-11T16:16:45.532Z
---

A JAR file that gives Java macOS Desktop Developers the ability to mouse and keyboard through translucent pixels, which has been broken in Java since release 1.7 in 2011.

:::CtaButton{label="Videos and Screenshots" externalHref="https://videos.nebulasoftware.com/channels/cTnIDrV0wI" openInNewTab="true"}

:::

# Installation Instructions

## Download Installer

The installers automatically update themselves, so these are always the most current versions.  The DonutHole application also automatically updates itself, so it too will always be at the most current version.

[Linux](https://updates.nebulasoftware.com/Linux/DonutHole/Install_DonutHole.sh)

[Mac Apple Silicon](https://updates.nebulasoftware.com/Mac/Apple_Silicon/DonutHole/Install_DonutHole_Apple_Silicon.dmg)

[Mac Intel](https://updates.nebulasoftware.com/Mac/Intel/DonutHole/Install_DonutHole_Intel.dmg)

[Windows](https://updates.nebulasoftware.com/Windows/DonutHole/Install_DonutHole.exe)

# Linux

Linux does not suffer from the same issue as Mac, so DonutHole is not needed on Linux.

## Mac

### Requirements

DisplaySwitcher requires macOS 11.0 Big Sur or later, on either:

- Intel-based Macs (x86\_64)
- Apple Silicon Macs (arm64)

Separate installers are provided for each architecture for maximum DisplaySwitcher performance.

“Not sure which version you’re running?  See this chart of macOS version names and numbers:  [https://en.wikipedia.org/wiki/MacOS\_version\_history](https://en.wikipedia.org/wiki/MacOS_version_history)

**Security**

- DisplaySwitcher is signed and notarized by Apple for security and compatibility with macOS Gatekeeper.

// todo

### Uninstall

The installer automatically replaces previous installations, so you don't ever need to uninstall, else you want to stop using DonutHole.

Just dragging `/Applications/DonutHole` folder to the Trash will leave a few items behind.  Run the uninstall to remove that folder plus:

- The macOS entry for the Open at Login running of DonutHole.
- The Desktop DonutHole icon.

Read instructions below, or watch this demo video.

// todo embed anything block for the video

::::WorkflowBlock
:::WorkflowBlockItem
Using Finder, open `/Applications/DonutHole` and double click `uninstall.app`.
// todo screenshot
:::

:::WorkflowBlockItem
It will ask for your administrator password.
// todo screenshot
:::
::::

### Install

Use the installer, `Install DonutHole Intel.dmg` or `Install DonutHole Apple Silicon.dmg`, to install DonutHole.

Read instructions below, or watch this demo video.

// todo embed anything block with the video

::::WorkflowBlock
:::WorkflowBlockItem
Double click the installer's `.dmg` file to open its volume, which shows the actual DonutHole installer.
// todo screenshot
:::

:::WorkflowBlockItem
Double click the installer in the .dmg's opened volume.
// todo screenshot
:::

:::WorkflowBlockItem
It will ask for your administrator password.
// todo screenshot
:::

:::WorkflowBlockItem
After the installer complets, close the .dmg open volume, eject the .dmg volume, delete the .dmg.
// todo screenshot
:::
::::

## Windows

Windows does not suffer from the same issue as Mac, so DonutHole is not needed on Windows.