# OnlySwitch: All-in-One Menu Bar Toggle App for macOS

> OnlySwitch is a free, open-source macOS menu bar application that puts over 30 system toggles in a single dropdown: dark mode, keep awake, hide notch, AirPods management, Pomodoro timer, Bluetooth, and more. It also accepts imported macOS Shortcuts and supports widgets, keyboard shortcuts, and remote control from an iPhone or iPad.

**jacklandrin/OnlySwitch** — ⚙️ All-in-One menu bar app, hide 💻MacBook Pro's notch, dark mode, AirPods, Shortcuts

- Repository: https://github.com/jacklandrin/OnlySwitch
- Website: https://onlyswitch.click/
- Stars: 5,935 · Forks: 240
- Language: Swift
- License: MIT
- Published: 2026-09-11 · Updated: 2026-09-11 · Language: en
- Canonical page: https://hysenlabs.com/projects/jacklandrin-onlyswitch

## What OnlySwitch Provides

macOS exposes many system settings through Control Center, System Settings, and keyboard shortcuts, but retrieving a specific toggle requires navigating multiple levels of menus or memorizing a keyboard shortcut. OnlySwitch consolidates the most commonly needed toggles into a single menu bar dropdown. The README lists more than 30 native switches, including dark mode, keep awake, screen saver, night shift, autohide dock, autohide menu bar, Bluetooth, AirPods, Spotify and Apple Music controls, Pomodoro timer, mute microphone, mute system audio, show hidden files, empty trash, empty clipboard, show Finder path bar, eject discs, hide desktop icons, dim screen, FKey function row toggle, and the hide notch feature for MacBook Pro models with a display notch. The switches can be added, removed, and reordered in the list to show only the ones each user needs.

## Shortcuts Gallery and the Evolution Gallery

Since version 1.7, macOS Shortcuts can be imported into OnlySwitch and appear alongside the native switches. The README includes a Shortcuts Gallery table listing community-contributed shortcuts: Toggle Scroll Direction, Dark Mode Switch, Split-Screen Apps, Google Translate, Do Not Disturb, Flush DNS Cache, Upcoming Events, Network Details, and several others. Contributing to the Shortcuts Gallery requires following the ShortcutsGalleryContributing.md file in the repository root. The Evolution Gallery provides additional items that extend OnlySwitch beyond simple toggles: Stage Manager, Update Software (for App Store apps), and similar features. Contributing to the Evolution Gallery follows EvolutionGalleryContributing.md. Both galleries are separate from the app's built-in switches and expand what the dropdown can trigger.

## Installing OnlySwitch on macOS

The recommended installation method is Homebrew:

```bash
brew install only-switch
```

Alternatively, download the app directly:

```bash
https://github.com/jacklandrin/OnlySwitch/releases/latest/download/OnlySwitch.dmg
```

The app is not available on the Mac App Store, so macOS Gatekeeper will prompt to allow it on first launch when downloaded manually. Homebrew handles this automatically. The README includes a note about auto-updates: users on version 2.5.6 or below must update manually or through Homebrew, because auto-updating failed in those older versions.

On macOS 26.2, some users have reported that the OnlySwitch icon does not appear in the menu bar after launch. The fix is to open System Settings, go to Menu Bar, find OnlySwitch in the list, and enable it. The issue is documented in the README with specific troubleshooting steps.

## Keyboard Shortcuts, Widgets, and the iOS Remote

Version 2.0 added system-wide keyboard shortcuts so every switch and imported Shortcut can be triggered without opening the dropdown. Version 2.5.0 introduced Apple Widgets support on macOS Sonoma and later, letting users pin frequently used switches directly to the desktop. The Only Control panel (added in version 2.5.4) provides a compact floating interface as an alternative to the dropdown. Version 2.7.0 added an optional Desktop Pet: a small always-on-top companion that can be dragged anywhere on the screen and clicked to show or dismiss the Only Control panel. Version 2.7.5 added the OnlyRemote feature: installing the OnlyRemote app on an iPhone or iPad and enabling iOS Remote in OnlySwitch settings allows controlling the Mac's switches over the local network. These features stack on top of each other: a user can combine desktop widgets, keyboard shortcuts, and iOS remote control within the same installation.

## Known Limitations and Edge Cases

Several switches in the README are marked as having issues or partial implementation. Hide Notch is listed as having some existing issues. Hide Windows is marked as partly finished. Top Sticker is also partly finished. Low Power Mode requires a password prompt. Hide Menu Bar Icons is partly finished, which is relevant to users who want to collapse other menu bar icons through OnlySwitch. The OnlySwitch icon visibility bug on macOS 26.2 (described in the README with a fix) is an OS-level interaction rather than an app bug; later macOS versions may also introduce similar conflicts. The app is MIT licensed, so forking it to add custom switches is permitted. The architecture documentation in ARCHITECTURE.md provides guidance for contributors who want to build new switch types.

## OnlySwitch vs. OneSwitch

OneSwitch is a commercial macOS menu bar application by Sindre Aarsaether that covers similar functionality: a set of toggles accessible from the menu bar. The key difference is price and licensing: OneSwitch is a paid application (sold through the Mac App Store and the developer's site), while OnlySwitch is free and MIT licensed. Both apps support dark mode, keep awake, Bluetooth, and other common toggles. OnlySwitch adds the Shortcuts Gallery integration and the iOS remote feature, which OneSwitch does not provide in the same form. OnlySwitch is not on the Mac App Store, which affects how updates are delivered and how Gatekeeper treats the downloaded binary. For users who prefer App Store sandboxing and automatic updates, OneSwitch's distribution model is an advantage. For users who want no-cost and extensible source code, OnlySwitch is the appropriate choice.

## Conclusion

OnlySwitch is the right tool for macOS users who want one-tap access to system settings that macOS scatters across multiple preference panels or does not expose directly at all (hide notch, clear clipboard, eject discs). The app is free, MIT licensed, and installable via Homebrew. It is not on the Mac App Store, which means it requires either Homebrew or a manual download and Gatekeeper exception. Users on macOS 26.2 should check System Settings for a menu bar icon visibility issue documented in the README before assuming the app is broken. OnlySwitch is under active development: the latest release was on 2026-09-27.

## FAQ

### how to use only switch

Install OnlySwitch via brew install only-switch or download the DMG from the releases page. After launching, click the OnlySwitch icon in the menu bar to open the dropdown of system toggles. Switches can be reordered or hidden in the app's preferences.

### one switch to only switch

OneSwitch is a paid macOS menu bar app sold through the Mac App Store. OnlySwitch is a free, MIT-licensed alternative available via Homebrew. Both provide system toggles in the menu bar; OnlySwitch additionally supports imported macOS Shortcuts and an iOS remote control app.

### Does OnlySwitch work on the latest macOS?

OnlySwitch targets modern macOS versions, including Sonoma and later for the Widgets feature. The README documents a known icon visibility issue on macOS 26.2 with a fix: enable OnlySwitch under System Settings and then Menu Bar. Version 2.8.0 was released on 2026-09-26.

## Sources

- [jacklandrin/OnlySwitch on GitHub](https://github.com/jacklandrin/OnlySwitch)
- [License: MIT](https://github.com/jacklandrin/OnlySwitch/blob/main/LICENSE)
- [Project website](https://onlyswitch.click/)
- [README](https://github.com/jacklandrin/OnlySwitch/blob/main/README.md)
- [Releases](https://github.com/jacklandrin/OnlySwitch/releases)

---

Hysen Labs editorial analysis, written from the project's own repository and release notes. Cite the canonical page: https://hysenlabs.com/projects/jacklandrin-onlyswitch
