<p align="middle"> <a href="https://onlyswitch.click"> <img alt="AppIcon" src="https://github.com/jacklandrin/OnlySwitch/blob/main/OnlySwitch/Assets.xcassets/AppIcon.appiconset/icon_256x256@2x.png?raw=true" width="128px" align="center" /> </a> </p>

‼️ Auto-updating has failed from 2.5.6 and below, please manually update or use Homebrew.

OnlySwitch

Menubar is smaller, you only need an All-in-One switch.

Install by Homebrew

brew install only-switch

Manually Download

Download the app

Communities

Telegram group: https://t.me/OnlySwitchforMac

Discord: https://discord.gg/UzSNpYdPZj

What's the OnlySwitch?

OnlySwitch provides a series of toggle switches to simplify your routine work, such as Hidden desktop icons, dark mode, and hide notch of the new Macbook Pro. The switches show on your status bar, you can control them effortlessly. Switch and Shortcuts items can be customized (remove/add or sort) to show on the list. These functionalities even can be put on your desktop as Widgets.

Since Version 1.7, Shortcuts can be imported into OnlySwitch.

Since Version 2.0, supports keyboard shortcuts. You can control your all switches and Shortcuts with the keyboard.

<p align="center"> <img alt="Only Switch" src="https://github.com/user-attachments/assets/40d94175-6487-4c59-b09e-2261ac5b8453" width="80%" align="center" /> </p>

Since Version 2.3.6, the Switches Availability (including Player and Hide Menu Bar Icons) is moved to System's menu bar.

Since Version 2.5.0, OnlySwitch has started to support Apple Widgets (Sonoma and above).

Since Version 2.5.4, OnlySwitch has Only Control appearance.

Shortcuts Gallery

Everyone can contribute macOS Shortcuts for OnlySwitch now. Please read How to contribute to Shortcuts Gallery. The shared Shortcuts will be displayed here:

<p align="center"> <img alt="Sits in the status bar" src="https://github.com/jacklandrin/OnlySwitch/assets/3782279/a9d90eed-c540-4183-9332-396dce0f72d4" width="70%" align="center" /> </p>

Switch list

Native Switches:

| Switch | status | Switch | status | |:--------------------|-----------------|:-------------------------|:------------------| | Hide desktop | finished | Hide notch | exist some issues | | Dark mode | finished | Low power mode | require password | | Screen Saver | finished | Show Finder Path Bar | finished | | Night Shift | finished | Mute mic | finished | | Autohide Dock | finished | Small launchpad icon | finished | | Airpods | finished | Pomodoro timer | finished | | Bluetooth | finished | Show extension name | finished | | Xcode cache | finished | Show user library folder | finished | | Autohide Menu Bar | finished | Mute | finished | | Show hidden files | finished | Empty pasteboard | finished | | Radio Station | finished | Empty trash | finished | | Keep awake | finished | Show Recent Apps on Dock | finished | | Spotify | finished | Apple Music | finished | | Screen Test & Clean | finished | Hide Menu Bar Icons | partly finished | | FKey | finished | Back Noises | finished | | Dim Screen | finished | Eject Discs | finished | | Hide Windows | partly finished | True Tone | finished | | Top Sticker | partly finished | Key Light | finished | | Only Agent | finished | Authenticator | finished |

Since Version 1.3, switches can be added to or removed from the list.

Shortcuts Gallery:

| Shortcuts | Remark | Shortcuts | Remark | |----------------------------------|-------------------------------------------------|----------------------------------|:--------| | Toggle Scroll Direction | Monteray | Invert Scroll Direction(Ventura) | Ventura | | DarkMode Switch | | Network Details | | | Split-Screen Apps | | Passwords | | | Google Translate | | IP Address Information | | | Autohide menu bar in full screen | Monteray | Flush DNS Cache | | | Do Not Disturb | Monteray or higher | Upcoming Events | | | S-GPT | works with S-GPT Encoder, needs OpenAI API key | S-GPT Encoder | |

Evolution Gallery:

| Evolution | Remark | Evolution | Remark | |---------------------|--------|--------------------|:------------------------| | Stage Manager | | Update Software | installed via App Store | | Hide desktop Widget | Sonoma | Hide Desktop Icons | Sonoma | | Clamshell | | Wifi Switch | |

Shortcuts Actions

| Actions | status | |---------------------|-------------------| | Get wallpaper image | exist some issues | | Get wallpaper url | finished | | Is dark mode | finished | | Set dark mode | finished |

Supported Languages 🇺🇳

English, Simplified Chinese, German, Croatian, Turkish, Polish, Filipino, Dutch, Italian, Russian, Spanish, Japanese, Somali, Korean, French, Ukrainian, Slovak, Portuguese (BR), Czech

Welcome to pull requests for these

• support other languages
• fix bugs

If you have other good ideas 💡, feel free to send an E-mail to me.

Donate

If you like it, help support this app by giving me a cup of coffee to keep coding. Donate here

🤖 Only Agent

Only Switch starts to support Only Agent since 2.6.0. You can control your mac by English via AI now. After you write down your purpose, AI can generate an Apple Script to engage it. If the Agent mode is on, the script will be immediately executed. There are two available model providers, with Ollama, OpenAI and Gemini. Feel free to contribute more providers.

It supports only macOS 26.0 and above.

<p align="center"> <img alt="Only Agent" src="https://github.com/user-attachments/assets/3710ebf6-f93c-4436-bce2-6fcf2727e3e1" width="70%" align="center" /> </p>

OpenClaw (natural language)

You can also control OnlySwitch by natural language using OpenClaw. An OpenClaw-compatible skill is included in this repo: say things like "empty trash", "toggle keep awake", or "turn on dark mode" and OpenClaw will trigger the matching switch via deeplink. See OpenClaw/README.md for setup (extra skill directory or copy into ~/.openclaw/skills).

Only Widget

Only Switch supports Apple Widgets since version 2.5.0. The Widgets can be edited to any built-in switches and buttons. Clicking them will trigger the reflection of relevant switches and buttons. You can put Only Widgets anywhere, desktop or notification center.

Since version 2.5.2, Only Widget supports Evolution.

NOTE: After updating version 2.5.0, you might need to reset your language. If your widgets didn't follow your language settings, please kill Only Widget process, it will update.

<img width="370" alt="Only Widget" src="https://github.com/jacklandrin/OnlySwitch/assets/3782279/0c1be202-9e5f-41dd-b62d-52d5a7147139">

Evolution🔥

Evolution has come following version 2.4, you can freely DIY the switches and buttons that you want. Currently, evolution supports Shell and Apple Script. They also can be invoked by hotkeys. Next, evolution will be able to be distributed by users as a shortcut utility platform.

Evolution settings page is implemented with TCA. PS: Evolution feature needs macOS 13.0 and above.

Everyone can contribute Evolution for OnlySwitch since version 2.4.3. Please read How to contribute to Evolution Gallery. The shared Evolutions will be displayed here:

<p align="center"> <img alt="Sits in the status bar" src="https://github.com/jacklandrin/OnlySwitch/assets/3782279/f3299ae0-0222-49a3-864a-80c6601bac6a" width="70%" align="center" /> </p>

How to create an Evolution?

So far, Evolution offers two types, with Switch and Button.

1. Button is very simple, when Run button is pressed, the script you added will be executed.
2. Regarding Switch, there are four fields you can edit.

• Check status: When OnlySwitch list appeared or some settings are changed, the switch status will be checked whether on or off. At this moment, the script of check status will be executed. You can press the debug button to output the result of