# Troubleshooting

The most common "nothing is happening" cases, and what the menu's status
line tells you about each one.

## Nothing is showing at all

Work top to bottom:

1. **Is the app running?** Look for the hyperbin item in your menu bar
   (macOS) or system tray (Windows). If it's missing, launch it from
   Applications / the Start menu
2. **Is the animation enabled?** Tick **Show Animation** in the menu — it
   can be off without changing any other setting
3. **Is the Trash actually full enough?** In the default *More Trash, More
   Effect* mode, nothing happens until the Trash passes the **Trash
   Threshold** (100 MB by default). Switch **Amount** to *Just a Little* or
   *Oh the Horror!* to test without waiting for the threshold
4. **Does the status line name a problem?** The line at the top of the menu
   says why the effect is idle — for example a missing permission on macOS,
   or the Trash icon being off screen

## "Trash icon is off screen"

The effect sits on top of the Trash icon in the Dock, so there is nothing
to draw on while the Dock is hidden. Reveal the Dock (move the pointer to
its edge) and the effect returns — revealing an auto-hidden Dock can lag up
to a second.

## macOS: the effect won't track the bin

Both permissions need to be granted — see [Getting
Started](/docs/hyperbin/getting-started):

- **Accessibility** — without it there is no icon to draw on. The app shows
  the system prompt; grant it and tracking starts immediately, no restart
- **Full Disk Access** — without it the app can't size the Trash, so it
  draws nothing and says so. Grant it in **System Settings → Privacy &
  Security → Full Disk Access**, then relaunch hyperbin

> **Note — A menu item that opens the right pane**
> When a permission is the blocker, the menu shows an item that opens
> whichever System Settings pane fixes it, so you don't have to hunt for it
> yourself.

## The menu bar icon looks wrong or is missing

- If there's no icon at all in the menu bar, the app may have failed to
  load its artwork — relaunch, or reinstall from a fresh download
- On macOS the icon adapts to your menu bar's appearance automatically
- On Windows it re-renders when you switch between light and dark mode

## The effect shivers or jumps

This was fixed in 1.1.0 (the bin's position is now read with sub-pixel
precision). If you're on an older build, update: **Check for Updates…** in
the menu.

## Still stuck?

Email [support@hypernuclear.com](mailto:support@hypernuclear.com) with:

- The OS and version (macOS / Windows)
- The hyperbin version (menu → **Check for Updates…** shows it)
- Exactly what the status line in the menu says
- Which effect and amount you have selected

---

From https://hypernuclear.com/docs/hyperbin/troubleshooting/