Repolode
Submit
jacklandrin

jacklandrin/OnlySwitch

An all-in-one macOS menu bar app that puts everyday system switches, shortcuts, system monitoring and widgets in one customizable place.

Open-source alternative to:iStat Menus

View on GitHubWebsite
Stars
6,039
Forks
246
Open issues
54
Last commit
yesterday

What is it?

OnlySwitch is a macOS menu bar app that collects everyday system controls, such as hiding desktop icons, toggling dark mode, keeping the Mac awake, managing the notch, and muting the microphone, into a single customizable list. Users can add, remove and reorder switches and macOS Shortcuts, assign keyboard shortcuts to them, and place controls on the desktop or in Notification Center as widgets.

Beyond built-in switches, it includes a System Monitor for CPU, GPU, memory, disk and network usage, a Codex Usage tab, a Dock window preview, and an optional desktop pet. Evolution lets users build custom buttons and switches backed by Shell or AppleScript scripts, and Only Agent turns plain-English requests into AppleScript using Ollama, OpenAI or Gemini providers. Remote control from iPhone or iPad is available through the companion OnlyRemote app, and OpenClaw can trigger switches through deeplinks.

The app is written in Swift and SwiftUI and follows The Composable Architecture. Several features depend on recent macOS versions, and some rely on private macOS APIs that may break after system updates.

Key features

  • 01Customizable menu bar switches for hiding desktop icons, dark mode, keep awake and more.
  • 02Import macOS Shortcuts and bind keyboard shortcuts to switches and Shortcuts.
  • 03Desktop and Notification Center widgets that trigger controls.
  • 04System Monitor for CPU, GPU, memory, disk and network usage.
  • 05Evolution lets you write custom Shell or AppleScript switches and buttons.
  • 06Only Agent generates AppleScript from natural language with Ollama, OpenAI or Gemini.

Use cases

  • Quickly toggling hidden files, dark mode or keep-awake without opening System Settings.
  • Adding one-click Mac controls to the desktop or Notification Center as widgets.
  • Controlling a Mac from an iPhone or iPad over the local network with OnlyRemote.
  • Building personal automation buttons backed by AppleScript or shell commands.

Quick start

  1. 1

    Install OnlySwitch with Homebrew

    brew install only-switch
  2. 2

    Launch OnlySwitch and enable it under System Settings → Menu Bar if its icon is missing

  3. 3

    Click the OnlySwitch menu-bar icon to open the control list, then open settings to customize switches

Things to know

  • macOS only, and some features require macOS 26 or later.
  • Some features rely on private, undocumented macOS APIs and may stop working after a system update.
  • Automatic updating is broken in version 2.5.6 and earlier.

In collections

macOS menu bar appsOpen-source AI agent frameworks & appsOpen-source Mac apps

Topics

#macos#menubar-app#swiftui#system-monitor#shortcuts#widgets#automation#applescript#ai#ai-agents

FAQ

What is OnlySwitch?
An all-in-one macOS menu bar app that puts everyday system switches, shortcuts, system monitoring and widgets in one customizable place. OnlySwitch is a macOS menu bar app that collects everyday system controls, such as hiding desktop icons, toggling dark mode, keeping the Mac awake, managing the notch, and muting the microphone, into a single customizable list. Users can add, remove and reorder switches and macOS Shortcuts, assign keyboard shortcuts to them, and place controls on the desktop or in Notification Center as widgets.
Is OnlySwitch free to use? What license does it have?
OnlySwitch is open source under the MIT license. Check the license terms before using it in commercial products.
Is OnlySwitch still maintained?
Actively maintained. The last commit to OnlySwitch was on Nov 6, 2026.
What can I use OnlySwitch for?
Quickly toggling hidden files, dark mode or keep-awake without opening System Settings. Adding one-click Mac controls to the desktop or Notification Center as widgets. Controlling a Mac from an iPhone or iPad over the local network with OnlyRemote. Building personal automation buttons backed by AppleScript or shell commands.
How do I install OnlySwitch?
Install OnlySwitch with Homebrew: brew install only-switch Launch OnlySwitch and enable it under System Settings → Menu Bar if its icon is missing Click the OnlySwitch menu-bar icon to open the control list, then open settings to customize switches
Where can I get OnlySwitch?
The source code and installation instructions are on GitHub: https://github.com/jacklandrin/OnlySwitch

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects