CLI tool
Kruszoneq/macUSB avatar
Kruszoneq/macUSB

macUSB: a guided bootable USB creator for Mac, from legacy macOS to Windows 11

The all-in-one bootable USB creator for Mac

2,933 stars143 forksSwiftMIT

At a glance

What is it?
macUSB is a notarized SwiftUI app that writes bootable USB media on Apple Silicon and Intel Macs, with a built-in macOS downloader and Linux and Windows image support. It is a narrow tool with a real dependency on macOS permissions.
Who is it for?
Adopt macUSB if you are on an Apple Silicon or Intel Mac and need bootable media for a legacy macOS installer, a Linux ISO, or a Windows image, and you accept that the app needs Full Disk Access and Allow in the Background enabled in System Settings before workflows will succeed. Skip it if you are not on macOS, or if you want a scriptable command-line pipeline rather than a guided app.
Can I use it commercially?
Yes. MIT is a permissive licence: you can use, modify and sell software built on it, as long as you keep its copyright and licence notices.
Is it still maintained?
Yes. The repository last received commits 2 days ago.
What is it written in?
Mainly Swift, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on September 30, 2026, and from our analysis. They are not legal advice.

Editorial analysis

The problem macUSB targets: legacy macOS installers on modern Macs

The README is explicit about the origin of the project. Creating bootable USB installers for macOS Catalina and older on modern Macs, especially Apple Silicon models, is difficult because legacy installer workflows conflict with newer system requirements. That is the specific gap macUSB was written to close, and it is why the repository carries topics such as apple-silicon, legacy-macos and rufus-alternative.

The audience follows from that. This is not a general-purpose disk utility for people who already have a working shell pipeline. It is for Mac users who need a bootable stick and do not want to reconstruct the steps each time: someone reviving an old PowerPC or Intel machine, someone installing a Linux distribution on a Mac, or someone preparing Windows installation media from macOS. The README also notes that user feedback pushed the app past its original scope, adding an integrated macOS downloader and support for Linux and Windows media. The result is described as an all-in-one tool for bootable USB workflows on Mac.

How macUSB works: a guided app plus a privileged helper

The repository layout shows two Swift targets: macUSB, the app itself, and macUSBHelper, a separate helper component. That split is the architectural core. Writing a bootable image to a raw device needs privileges the sandboxed app does not have, so the helper performs the privileged work while the app drives the flow and shows progress.

The user-facing sequence is staged and reviewable. You pick a source, either a local file or something fetched through the built-in Downloader, then select a target USB drive, then review the operation details before starting. The README describes monitoring creation stage by stage and reviewing the final result, with the option to safely eject the drive directly from the final screen. For Linux images, the workflow includes guidance for the expected unreadable-disk prompt that macOS shows during creation, which is a small but telling detail: the app does not hide the operating system's behaviour, it explains it.

For Windows, the Windows workflow offers optional configuration for selected Windows restrictions and first-run setup choices. Sources can be local installers and disk images, and macUSB can calculate SHA-256 checksums for supported .dmg, .cdr and .iso sources, plus manually selected raw .img images. That checksum step matters when you are about to overwrite a drive with a file you downloaded somewhere other than Apple's servers.

Installing macUSB and creating your first bootable drive

The README gives two installation routes: GitHub Releases and Homebrew. The Homebrew route is the shorter one and installs the app as a cask.

bash
brew install --cask macusb

After that, launch macUSB from Applications. The README warns that creating bootable media erases all data on the selected USB drive, so plug in a drive you are willing to lose before you start.

Before the first write, the README states that you should enable Allow in the Background and Full Disk Access for macUSB in System Settings, and that without them creation workflows may fail. Allow in the Background lives under General, Login Items & Extensions; Full Disk Access lives under Privacy & Security, Full Disk Access. The repository ships screenshots of both panes under docs/readme-assets/permissions/.

With permissions set, the flow is: choose a local source or use the built-in Downloader to fetch a macOS installer from Apple, select the target USB drive, review the operation details, start the process, then eject from the final screen. If you prefer not to use Homebrew, the latest release is on the project's GitHub Releases page.

Permissions and failure modes you should expect

The most concrete limitation in the README is not a missing feature, it is a dependency: Allow in the Background and Full Disk Access must be enabled, or creation workflows may fail. That phrasing is deliberately hedged, and it means the failure is not always a clean error dialog. If you have just installed the app and a write stalls or aborts, check those two System Settings panes before you blame the USB drive.

The second constraint is destructive by design. The README's warning is unambiguous: creating bootable media erases all data on the selected USB drive. There is no documented undo, and the README does not document rollback for a partially written drive. If the drive held anything you need, that is on you before you press start, not after.

Third, the app is macOS-only. The platform badge reads macOS, and the architecture badge reads Apple Silicon and Intel. If you are on Windows or Linux, macUSB is simply not the tool, regardless of what the USB media it produces can boot. The README also does not document a command-line interface, so anyone wanting a scriptable, repeatable pipeline driven from CI or a shell script will not find one described here.

Where macUSB sits next to Rufus and other writers

The repository tags itself rufus-alternative, which invites the comparison directly. Rufus is a Windows application; macUSB is a macOS application. That single difference decides most cases. If your only machine is a Mac and you need to produce installation media, Rufus is not available to you without a Windows host or a virtual machine, and macUSB is built for exactly that situation.

The difference in approach goes further than the host operating system. macUSB wraps the write in a guided sequence with a confirmation screen, a stage-by-stage progress view, and an eject step at the end, and it bundles a downloader that pulls macOS installers, including Public Beta releases, from Apple servers. A general-purpose image writer typically expects you to supply the image yourself and does not know anything about macOS installer formats. Conversely, a general-purpose writer is not going to offer the Apple Silicon compatibility handling for older macOS installers that the README lists as a key feature. If your work is writing arbitrary raw images on Linux, macUSB offers nothing you do not already have.

Maintenance, releases and what the MIT licence means here

The last push to the repository was on 2026-09-23, and the most recent release listed is v2.5 from 2026-09-20, following v2.4 in August 2026 and v2.3.1 in June 2026. The repository is not archived. The cadence visible in those three releases is roughly every six to eight weeks, which is enough to suggest the project is being kept current, though the release notes themselves are not part of the documentation, so what changed in each version is not something this article can describe.

Upgrade cost is low in the ordinary case. Homebrew users get new versions through the cask, and the README states that every update and feature is available to everyone, with the project remaining completely free. The repository is MIT licensed, which is permissive and places few obligations on anyone reusing the code; the LICENSE.txt file at the top level is the authoritative text, and reading it is the right move if you intend to redistribute or embed the code rather than just run the app. Nothing here is legal advice.

One maintenance consideration is worth stating plainly: the app depends on macOS privacy controls and on Apple's installer distribution staying reachable. The downloader fetches from Apple servers, and the permissions requirement is set by macOS, not by the project. Both are outside the maintainer's control.

Editorial conclusion

Adopt macUSB if you are on an Apple Silicon or Intel Mac and need bootable media for a legacy macOS installer, a Linux ISO, or a Windows image, and you accept that the app needs Full Disk Access and Allow in the Background enabled in System Settings before workflows will succeed. Skip it if you are not on macOS, or if you want a scriptable command-line pipeline rather than a guided app. Before your first write, confirm the target drive is expendable, since the README states creation erases all data on the selected USB drive, and check the permissions screenshots under docs/readme-assets/permissions/ against your own System Settings panes.

Frequently asked questions

What is macUSB?

macUSB is a guided macOS app for creating bootable USB media on Apple Silicon and Intel Macs, using local files or its built-in macOS downloader. It is MIT licensed and distributed through GitHub Releases and a Homebrew cask.

What tool can I use on my Mac to create a bootable USB drive?

macUSB is one option: it creates bootable media from local installers and disk images, from macOS installers downloaded through its built-in downloader, and from supported Linux and Windows .iso images. It runs on Apple Silicon and Intel Macs.

How do I create a bootable macOS installer on a USB drive with macUSB?

Install macUSB, enable Allow in the Background and Full Disk Access in System Settings, then choose a local source or use the built-in Downloader to fetch a macOS installer from Apple. Select the target USB drive, review the operation details, start the process, and eject from the final screen.

Can Rufus make a macOS bootable USB, and how does macUSB differ?

Rufus is a Windows application, while macUSB is a macOS app, so on a Mac the two are not interchangeable. macUSB also bundles a macOS downloader and compatibility handling for older macOS installers on Apple Silicon, which a general-purpose image writer does not provide.

Official sources

  1. Kruszoneq/macUSB on GitHub
  2. License: MIT
  3. Project website
  4. README
  5. Releases
Add this badge to your README

If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.

Add this badge to your README

markdown
[![Hysen Labs](https://hysenlabs.com/badge/kruszoneq-macusb.svg)](https://hysenlabs.com/projects/kruszoneq-macusb)