Skip to content

Creating bootable macOS and OS X USB drives has never been easier!

License

Notifications You must be signed in to change notification settings

Kruszoneq/macUSB

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

38 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

macUSB macUSB

Creating bootable macOS and OS X USB drives has never been easier!

Platform Architecture License Security Vibe Coded Website

macUSB is a one-click tool that transforms your modern Mac (Apple Silicon) into a service machine capable of reviving older Apple computers.


β˜• Support

If you’d like to support the project, here’s a simple way.

Buy Me A Coffee

πŸ–ΌοΈ Preview

macUSB – UI preview

πŸš€ About the Project

With Apple's transition to its own silicon (M1, M2, M3...), preparing installation media for older Intel- and PowerPC-based computers has become a challenge. Many people encounter Terminal errors, issues with expired certificates in old installers, or simply a lack of compatibility with system tools.

macUSB solves this problem.

The application automates the entire process of creating a bootable USB drive. You don't need to search for commands online, worry about disk formatting, or manually fix validation errors in old installation files.

What do you gain?

  • Legacy Support: The ability to create installers for systems over a decade old (e.g., OS X Lion) directly on the latest Mac on Apple Silicon.

  • Time Saving: The app detects the system version in the .dmg, .iso, .cdr or .app file, formats the drive, and copies files automatically.

  • Auto Fixes: For certain systems (e.g., High Sierra/Mojave), the app automatically applies necessary fixes so the installer works despite expired Apple certificates.

  • PowerPC Revival: The app formats USB drives to the Apple Partition Map (APM) scheme required by PowerPC Macs and transfers the installer directly from .iso, .cdr or .dmg files. This allows for installation without the need for physical CDs/DVDs or FireWire drives.

    πŸ“– Guide: Step-by-step: Booting from USB on PowerPC Macs using Open Firmware

  • Security: Starting with version v1.1.2, the application is officially notarized by Apple. This guarantees that the software is free from malicious code and ensures a seamless, secure first launch on macOS without requiring any extra security workarounds.


Fun Fact: The application was created using the "Vibe Coding" method. Every single function has been rigorously verified for correct operation to ensure full stability. This project proves that programming barriers (even cross-architectural ones) can be overcome with determination and AI support while maintaining the highest standards of code quality.


βš™οΈ Requirements

Host Computer (where you run the app):

  • Processor: Both Apple Silicon and Intel are supported.
  • System: macOS Sonoma 14.6 or newer.
  • Storage: Minimum of 15 GB of free disk space is required to create the installers.

USB Drives & External Storage

  • Capacity: A minimum of 16 GB is required.
  • Speed: USB 3.0 or newer is highly recommended for faster installation times.
  • External Drives (HDD/SSD): By default, only USB flash drives are detected for safety. To use external disks, enable Options β†’ Enable external drives support.

Installation Files:

The program supports .dmg, .cdr and .iso disk images, as well as raw .app installer files.

Pro Tip: Where to get valid files?

  • OS X 10.7 - 10.8 and 10.10 – macOS 26: The most convenient solution is downloading via the free app Mist.
  • OS X 10.9: The recommended source is Mavericks Forever (macUSB support was developed based on the image from this site).
  • Mac OS X 10.4 – 10.6 (Intel): Disk images are available on the Internet Archive.
  • Mac OS X 10.4 – 10.5 (PowerPC): Images for PPC architecture can be found on Macintosh Garden.

πŸ’Ώ Supported Versions

The table lists systems supported by the application that are successfully recognized and written to a USB drive.

System Version Supported
macOS Tahoe 26 βœ…
macOS Sequoia 15 βœ…
macOS Sonoma 14 βœ…
macOS Ventura 13 βœ…
macOS Monterey 12 βœ…
macOS Big Sur 11 βœ…
macOS Catalina 10.15 βœ…
macOS Mojave 10.14 βœ…
macOS High Sierra 10.13 βœ…
macOS Sierra1 10.12 βœ…
OS X El Capitan 10.11 βœ…
OS X Yosemite 10.10 βœ…
OS X Mavericks2 10.9 βœ…
OS X Mountain Lion 10.8 βœ…
OS X Lion 10.7 βœ…
Mac OS X Snow Leopard 10.6 βœ…
Mac OS X Leopard 10.5 βœ…
Mac OS X Tiger3 10.4 βœ…

🌍 Available Languages

The application interface automatically adapts to the system language:

  • πŸ‡΅πŸ‡± Polish (PL)
  • πŸ‡ΊπŸ‡Έ English (EN)
  • πŸ‡©πŸ‡ͺ German (DE)
  • πŸ‡―πŸ‡΅ Japanese (JA)
  • πŸ‡«πŸ‡· French (FR)
  • πŸ‡ͺπŸ‡Έ Spanish (ES)
  • πŸ‡§πŸ‡· Portuguese (PT-BR)
  • πŸ‡¨πŸ‡³ Simplified Chinese (ZH-Hans)
  • πŸ‡·πŸ‡Ί Russian (RU)

πŸ› οΈ Support & Bug Reports

Any technical issues or suggestions for new features should be reported via GitHub Issues. To simplify the diagnostic process and expedite issue handling, it is highly recommended to use the available reporting templates whenever possible:

  • Bug Report: Recommended for reporting technical errors. If possible, details such as Host OS Version, Target OS Version, file format (e.g., .dmg, .app), and the installer source and link should be provided.
  • Feature Request: Recommended for suggesting new ideas or improvements for the application.

Including screenshots of the error or the application window is highly helpful and allows for a faster analysis of the reported issue.


βš–οΈ License

This project is licensed under the MIT License.

This means you are free to use, copy, modify, and distribute this code, provided you keep the author information. The software is provided "as is", without warranty of any kind.

Copyright Β© 2025-2026 Krystian Pierz


Note: The application interface and this README file were translated using Gemini 3 Pro. Please excuse any potential translation errors.

Footnotes

  1. Only version 10.12.6 is supported. ↩

  2. Fully works with the image downloaded from Mavericks Forever. Images from other sources have not been verified and may cause errors. ↩

  3. The Single DVD edition is recognized automatically. Instructions for the Multi-DVD edition are available on the application's website: Tiger Multi-DVD Guide. ↩

About

Creating bootable macOS and OS X USB drives has never been easier!

Resources

License

Stars

Watchers

Forks

Sponsor this project

Languages