Skip to content
User guide

Mouse Halo User Guide

From launching the app to adjusting the display and checking things when something goes wrong. Installation steps are on the download page.

App interface: Japanese. Japanese labels are shown in parentheses, for example Quit (終了).

Getting started

Getting started

Mouse Halo is a menu bar app that shows a ring around your mouse pointer and a ripple where you click. The display starts as soon as you launch it.

No window opens. Look for the round icon in the menu bar.

Your guide: Madoka
  1. Open “Mouse Halo” in the Applications folder.
  2. A ring appears around the pointer. No icon appears in the Dock; a round icon appears in the menu bar at the top of the screen.
  3. Click somewhere and check that a ripple spreads out.
Basics

Basics

The panel that opens when you click the menu bar icon (a drawing that reproduces its items and default values; the labels are in Japanese as in the app)

Turning the display on and off

Click the menu bar icon and flip the switch at the top right of the panel. While it is off, neither the ring nor ripples appear, and the menu bar icon changes to a hollow circle.

Pausing it for a moment (0.2.3 and later)

Hold the Option key and click the menu bar icon to hide the ring and ripples right away; option-click again, or just click the icon, to bring them back. Use it when you briefly need the display out of the way, for example when a screen capture app needs to pick a window. While paused, the icon shows a pause mark. Reopening the app clears the pause.

Quitting the app

Press Quit (終了) at the bottom right of the panel. To use it again, open it from the Applications folder.

Updating to a new version

From 0.2.0, the app automatically checks once a day whether a new version is available. When it finds one, the menu bar icon changes to an arrow and the details of the new version appear in the panel’s Update (アップデート) section.

  1. Press Update now (今すぐ更新).
  2. The app checks the downloaded file’s SHA-256, its Developer ID signature and Apple notarization, then replaces itself, and Mouse Halo restarts. If these can’t be confirmed, nothing is changed.

To check right away, press Check (確認). If you don’t want automatic checks, turn off Check automatically (自動で確認する); the app then connects only when you press Check (確認).

Opening automatically at login

From 0.2.0, open the menu bar icon and turn on Launch at login (ログイン時に起動). When it is on, Mouse Halo also appears in the list under System Settings → “General” → “Login Items”. If “システム設定で許可すると有効になります” (Takes effect once allowed in System Settings) appears, press “システム設定を開く” (Open System Settings) and allow Mouse Halo.

If you use 0.1.0, press “+” under System Settings → “General” → “Login Items” and add Mouse Halo.

Settings

Settings

Changes take effect immediately and are saved automatically. The next time you launch the app, it starts with the same look.

ItemRangeDefaultTips
Color (色)Any color, chosen with the color pickerLight blueA color that doesn’t blend in with the backgrounds you often use is easier to find
Size (サイズ)28–120 px (ring diameter)54 pxLarger for big screens and presentations
Opacity (透明度)20–100%82%Lighter for everyday work and stronger for screen sharing are easier to see
Check automatically (自動で確認する)On / offOnWhen on, the app checks once a day whether a new version is available

Click ripples and Input Monitoring

Depending on your macOS version and settings, the “Input Monitoring” permission may be needed to show click ripples over other apps. The ring itself needs no permission.

After changing the permission, quit the app once and open it again.

Your guide: Madoka
  1. Open System Settings

    Open “Privacy & Security” → “Input Monitoring”.

  2. Turn on Mouse Halo

    If Mouse Halo is in the list, turn its switch on.

  3. Reopen the app

    Choose Quit (終了) from the menu bar icon, then open it again from the Applications folder.

All Mouse Halo receives is the fact that a mouse button was pressed. It doesn’t monitor keyboard input, and it doesn’t look at which app or what content you clicked.

Troubleshooting

Troubleshooting

Nothing appears when I open it

Mouse Halo doesn’t open a window. Check that there is a round icon in the menu bar, then click it and check that the switch at the top right of the panel is on. If you have many menu bar icons, it may be hidden from view.

Only the click ripples don’t appear

Turn the permission on by following “Click ripples and Input Monitoring” above, then reopen the app. If the ring appears, the display itself is working.

The ring isn’t visible on one particular screen

Try moving the pointer a long way. When you connect or disconnect a display, Mouse Halo rebuilds the display for each screen. If it still doesn’t appear, reopen the app.

Update now (今すぐ更新) doesn’t update the app

If you opened the app from somewhere other than the Applications folder (such as inside the disk image), or you don’t have permission to replace it, it can’t be updated from within the app. Get the new DMG from “ダウンロードのページ” (Download page) in the panel and replace the app following the same steps as How to install. Your settings are kept.

The ring is too prominent or too faint

Adjust it with Opacity (透明度) and Size (サイズ) in the panel. A color similar to the background is hard to see, so also try changing Color (色).

Clicks or drags don’t work well

The ring is built so that it doesn’t receive mouse input, so normally it has no effect. If you are concerned, turn it off with the switch in the panel and see whether anything changes. If it does, please contact us with details of your setup.

Glossary

Glossary

Menu barThe horizontal strip along the very top of the screen. App icons line up on its right side
Ring (halo)The ring of light shown around the pointer
RippleA ring that spreads out from where you clicked and fades away
Input MonitoringA macOS permission that lets an app receive keyboard and mouse input even over other apps
NotarizationApple’s automated check for known malware. When updating, the app also checks that the file has been notarized
Login itemsThe list of apps that open automatically when you log in to your Mac (found under “General” in System Settings)