OnlySwitch

![](https://badgen.net/github/release/jacklandrin/onlyswitch) ![](https://img.shields.io/badge/UI-SwiftUI-green)
[![Listed on TakoAPI](https://takoapi.com/api/badge/jacklandrin-onlyswitch)](https://takoapi.com/agents/jacklandrin-onlyswitch)
![](https://img.shields.io/badge/Platform-Tahoe-blue) ![](https://img.shields.io/badge/License-MIT-orange)

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

# OnlySwitch

**English** · [Deutsch](README.de.md) · [简体中文](README.zh-CN.md)

**A smaller menu bar starts with one all-in-one switch.**

OnlySwitch puts everyday macOS controls—such as hiding desktop icons, changing appearance, keeping the Mac awake, and managing the notch—into one customizable menu-bar app. Add, remove, and reorder switches and Shortcuts, assign keyboard shortcuts, or place controls on the desktop as widgets.

<p align="center">
  <img alt="OnlySwitch controls" src="doc/images/onlyswitch-controls.png" width="55%" />
</p>

<table>
  <tr>
    <td valign="top" width="33%"><img alt="OnlySwitch screenshot gallery" src="doc/images/onlyswitch-screenshots.png" width="100%" /></td>
    <td valign="top" width="33%"><img alt="OnlySwitch sound mixer" src="doc/images/onlyswitch-sound-mixer.png" width="100%" /></td>
    <td valign="top" width="33%"><img alt="OnlySwitch system monitor" src="doc/images/onlyswitch-system-monitor.png" width="100%" /></td>
  </tr>
</table>

## Installation

### Homebrew

```sh
brew install only-switch
```

### Manual download

[Download the latest OnlySwitch DMG](https://github.com/jacklandrin/OnlySwitch/releases/latest/download/OnlySwitch.dmg).

> [!IMPORTANT]
> Automatic updating is broken in version 2.5.6 and earlier. If you are on one of those versions, update manually or reinstall with Homebrew.

## Quick start

1. Launch OnlySwitch and enable it under **System Settings → Menu Bar** if macOS does not show its icon.
2. Click the OnlySwitch menu-bar icon to open the control list.
3. Open settings to add, remove, and reorder switches or Shortcuts, configure hotkeys, and enable optional features.
4. On supported macOS versions, add Only Widget from the widget gallery for desktop or Notification Center access.

To control OnlySwitch from an iPhone or iPad, install [OnlyRemote from the App Store](https://apps.apple.com/us/app/onlyremote/id6793657946), then open **iOS Remote** in OnlySwitch settings to enable local-network access and pair the device.

<p align="center">
  <img alt="OnlyRemote controls on iPad" src="https://github.com/user-attachments/assets/8cbba2ca-ff02-4600-9c6f-265fd91d1d67" width="70%" />
</p>

<p align="center">
  <img alt="OnlyRemote App Store QR code" src="https://raw.githubusercontent.com/jacklandrin/OnlySwitch/main/OnlySwitch/Resource/Ads/OnlyRemoteQRCode.jpeg" width="160" />
</p>

## Features

###