Skip to content

brndnsvr/WakeyWakey

Repository files navigation

WakeyWakey

A tiny macOS menu bar app that keeps your Mac awake by simulating subtle mouse movements only when you're idle.

Website: wakeywakey.app

Install

Homebrew (recommended)

brew install --cask brndnsvr/tap/wakeywakey

Manual Download

Download WakeyWakey v1.0.2 (macOS 15.0+, Apple Silicon)

Or visit Releases for all versions.

  1. Download the DMG above
  2. Open it and drag WakeyWakey to Applications

Getting Started

  1. Launch WakeyWakey from Applications
  2. Grant Accessibility permission when prompted (required for mouse movement)
  3. Click the coffee cup icon in your menu bar to enable

Features

  • Menu bar only — no Dock icon, stays out of your way
  • Smart activation — only jiggles after 42 seconds of inactivity
  • Timer options — enable for 1, 4, or 8 hours with auto-disable
  • Launch at Login — start automatically with your Mac
  • Multi-monitor support — cursor stays on the current display

Usage

Click the menu bar icon (coffee cup) to access:

Menu Item Action
Enable/Disable Toggle mouse jiggle on/off
Enable for 1/4/8 hours Auto-disable after set time
Launch at Login Start with macOS
Quit Exit the app

Icon states:

Disabled Enabled
Disabled Enabled

Permissions

WakeyWakey needs Accessibility permission to simulate mouse movement. On first launch, it will open System Settings for you. Grant permission and relaunch.

If it doesn't work:

  1. Go to System Settings → Privacy & Security → Accessibility
  2. Find WakeyWakey and toggle it on
  3. Relaunch the app

Troubleshooting

  • App doesn't jiggle — Wait 45+ seconds without touching mouse/keyboard
  • No menu bar icon — Make sure you're running from /Applications

Development

Want to build from source? See DEVELOPMENT.md.

License

MIT

About

Simple macOS app to simulate user activity for keeping the system out of sleep

Topics

Resources

License

Stars

Watchers

Forks

Contributors