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.
OnlySwitch is built on open-source principles to guarantee security, privacy, and full reproducibility. All sensitive data transformations run locally on your hardware with zero telemetry or unexpected cloud dependencies.
Key Technical Features & Capabilities
Import macOS Shortcuts into OnlySwitch and control switches and Shortcuts with keyboard shortcuts.: Streamlined desktop functionality optimized for macOS and Windows.
Customize which controls appear and arrange them to fit your workflow. Built-in switches are grouped by category and can be searched by name.: Streamlined desktop functionality optimized for macOS and Windows.
Manage every optional page from one place: OnlySwitch Settings → Tabs shows or hides tabs in the menu-bar list and Only Control.
Use Apple Widgets on macOS Sonoma and later, including Evolution controls.: High-performance integrated capability designed for native OnlySwitch workflow.
Open the compact Only Control interface for a focused control panel.: High-performance integrated capability designed for native OnlySwitch workflow.
**Control your Mac from iPhone or iPad with OnlyRemote.**: High-performance integrated capability designed for native OnlySwitch workflow.
Enable the optional Desktop Pet, drag it anywhere, click it to show or dismiss Only Control, and skip to the next track or radio station with playback animations for Apple Music, Spotify, and Radio.: Streamlined desktop functionality optimized for macOS and Windows.
Enable Turn off after sleep for Keep Awake to turn it off when you manually put your Mac to sleep.: Streamlined desktop functionality optimized for macOS and Windows.
Architecture & Technology Stack
Primary Languages: Swift
Frameworks & UI Runtime: SwiftUI / AppKit
Build Systems & Tooling: Xcode / Node.js / Cargo
Supported Platforms: macOS 12.0+ (Apple Silicon M1-M4 & Intel x86_64), Windows 10/11 x64, Linux
System Requirements
Specification
Minimum Requirement
Recommended Specification
Operating System
macOS 12.0 Monterey / Windows 10 x64
macOS 14.0+ Sonoma / Windows 11 x64
Processor Architecture
Apple Silicon (M1+) or Intel Core i5 x64
Apple Silicon Unified Memory (M2/M3/M4)
Memory (RAM)
4 GB Unified RAM
8 GB+ High-Speed RAM
Storage Space
300 MB available local disk space
1 GB+ SSD storage
GPU Acceleration
Metal 2 / DirectX 12 compatible
Apple Neural Engine / Vulkan capable
Installation & Setup Guide
macOS Installation (Recommended)
1
Download the verified .dmg release installer directly from CookApps.
2
Open the disk image and drag OnlySwitch.app into your /Applications folder.
3
Launch OnlySwitch via Spotlight (Cmd + Space) or Launchpad.
Alternatively, install using Homebrew if available:
bash
brew install only-switch
Windows Installation
1
Download the official installer package (.exe / .msi).
2
Run the executable and follow the setup wizard.
3
Launch OnlySwitch from the Start Menu or desktop shortcut.
Building from Source (Development Setup)
bash
git clone https://github.com/jacklandrin/OnlySwitch.git
cd OnlySwitch
pnpm install || cargo build --release
pnpm run build
How to Use & Workflow
1
Application Launch & Workspace: Open OnlySwitch to load the responsive native workspace.
2
Configuration & Preferences: Press Cmd + , (macOS) or Ctrl + , (Windows) to configure hardware acceleration, custom directories, and display themes.
3
Primary Operation: Drag-and-drop source files or input parameters directly into the central window.
4
Execution & Export: Initiate the processing pipeline and verify output files saved directly to your chosen local directory.
Troubleshooting & Common Issues
Problem: macOS Gatekeeper displays *"App is damaged and can't be opened"* or unnotarized developer notice.
Root Cause: macOS quarantine flag set on binaries downloaded outside the Mac App Store.
Resolution: Open Terminal and run:
bash
xattr -cr /Applications/OnlySwitch.app
Alternatively, navigate to System Settings > Privacy & Security and select Open Anyway.
Problem: High memory consumption during batch processing operations.
Root Cause: Large media buffers retaining uncompressed state.
Resolution: Adjust batch concurrency in settings or process assets in focused batches.
How to Use & Getting Started
## Installation & Setup Guide
### macOS Installation (Recommended)
1. Download the verified `.dmg` release installer directly from CookApps.
2. Open the disk image and drag **OnlySwitch.app** into your `/Applications` folder.
3. Launch OnlySwitch via Spotlight (`Cmd + Space`) or Launchpad.
Alternatively, install using Homebrew if available:
```bash
brew install only-switch
```
### Windows Installation
1. Download the official installer package (`.exe` / `.msi`).
2. Run the executable and follow the setup wizard.
3. Launch **OnlySwitch** from the Start Menu or desktop shortcut.
### Building from Source (Development Setup)
```bash
git clone https://github.com/jacklandrin/OnlySwitch.git
cd OnlySwitch
pnpm install || cargo build --release
pnpm run build
```
Ready to run OnlySwitch?
100% Free & Open-Source native desktop software. Star the repository to support development.