Sitelet https://github.com/Pama-Lee/MacMiniMode
Skip to content

About

Keep a plugged-in MacBook awake with the lid closed: clamshell mode without an external display, auto-off on battery. 让 MacBook 合盖不休眠,当 Mac mini 用。

Topics

Resources

Stars

127 stars

Watchers

0 watching

Forks

Latest commit

 

History

10 Commits

Folders and files

Repository files navigation

Mac mini Mode icon

Mac mini Mode

Keep a plugged-in MacBook running with the lid closed. Unplug it and it sleeps like a normal laptop again.

Download for macOS   下载安装包

English · 简体中文(安装说明)

Install

  1. Click Download for macOS above to get MacMiniMode.pkg.
  2. Double-click it and follow the installer. You will be asked for your Mac password once.
  3. A new icon appears in the menu bar. It is already working, no restart needed.

The installer is signed and notarized by Apple, so macOS opens it without warnings. Requires macOS 12 or later, on Apple silicon or Intel.

Mac mini Mode installer

What it does

Mac mini Mode turns a MacBook into an always-on home server or headless Mac. It gives you clamshell mode without an external display or a dummy HDMI plug, and there is no caffeinate or sudo pmset disablesleep to remember. Because it follows the power adapter, your MacBook never stays awake inside your bag.

  • On when plugged in: sleep is disabled on AC power, so your Mac keeps running with the lid closed and no display attached.
  • Off when unplugged: normal sleep returns on battery. If the lid is already closed, the Mac sleeps right away.
  • Menu bar control: switch between Automatic, Always On and Always Off, and see the current state at a glance.
  • Health Check: one click checks whether Remote Login, Screen Sharing, the battery and power settings are ready, and copies diagnostics for bug reports.
  • Low-battery protection: in Always On on battery, sleep is allowed again at 10% so the Mac never runs itself flat.
  • Command line: macminimode status and macminimode on|off|auto, also usable from Shortcuts with Run Shell Script.

Updates

Once a day the app asks GitHub whether a newer version exists. If so it downloads the installer, verifies its signature, and asks before installing; Install opens the system installer. To turn this off, uncheck Check for Updates Automatically in the menu and use Check for Updates… when you want.

Troubleshooting

Update to the latest version first. If your Mac still sleeps with the lid closed, choose Health Check… from the menu bar icon, click Copy Diagnostics, and paste it in Issues. A common cause is remote desktop or cleaner software that rewrites power settings on a timer; the app now restores the setting right away and notes it in the log.

Uninstall

sudo /Applications/MacMiniMode.app/Contents/Resources/uninstall.sh

License

MIT

About

Keep a plugged-in MacBook awake with the lid closed: clamshell mode without an external display, auto-off on battery. 让 MacBook 合盖不休眠,当 Mac mini 用。

Topics

Resources

Stars

127 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages