Hardware FixRecommendedDevice not working? Your driver may be the problemCheck updates for common hardware issues.Fix DriversOctober DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsSlow PC?RecommendedPC slow today? Run a repair scan before it gets worseResolve common Windows issues and optimize system performance.Scan Now×
Skip to content
Cupertino desk5 min

Flash a Custom Android ROM from a Mac: A Safe Fastboot and ADB Sideload Workflow

A Mac can run the tools needed for custom ROM installation, but the safe recovery, unlock and sideload sequence comes from your phone’s device-specific guide.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

You can use a Mac to install the command-line tools for custom Android ROMs, but there is no safe, universal flashing sequence. The exact recovery, firmware, partition and package steps depend on your phone’s model and codename and the ROM you chose. Follow that device’s current installation guide before unlocking or flashing; the LineageOS steps below are an example, not a recipe for other phones.

What fastboot and ADB do

ADB and fastboot communicate with a phone in different states. ADB works while Android or a compatible recovery is running; it can also request a reboot into bootloader mode. Fastboot communicates with the bootloader and can unlock or flash a device when the manufacturer and device support those actions. Google describes fastboot as the tool used to unlock a device bootloader and flash a new system image: Android SDK Platform-Tools release notes.

As an Amazon Associate I earn from qualifying purchases.

ADB sideload is a way to send a package from the computer to a compatible recovery for installation. It does not make an image compatible with your phone, remove an unlock requirement, or satisfy firmware and partition prerequisites. Confirm the ROM file and package order in the installation guide for your exact device.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Install Platform-Tools on macOS

Google’s SDK Platform-Tools package includes ADB and fastboot and provides a Mac download. Its release notes list Platform-Tools 37.0.1, released in July 2026; the page was last updated October 1, 2026. Google says users should normally use the latest version. The direct archive is named platform-tools-latest-darwin.zip. See Google’s Platform-Tools page.

#1 Best Overall
Sale
Samsung Galaxy A17 5G Smart Phone 128GB US 1 Yr Manufacturer Warranty Black
  • YOUR CONTENT, SUPER SMOOTH: The ultra-clear 6.7" FHD+ Super AMOLED display of Galaxy A17 5G helps bring your content to life, whether you're scrolling through recipes or video chatting with loved ones.¹
  • LIVE FAST. CHARGE FASTER: Focus more on the moment and less on your battery percentage with Galaxy A17 5G. Super Fast Charging powers up your battery so you can get back to life sooner.²
  • MEMORIES MADE PICTURE PERFECT: Capture every angle in stunning clarity, from wide family photos to close-ups of friends, with the triple-lens camera on Galaxy A17 5G.
  • NEED MORE STORAGE? WE HAVE YOU COVERED: With an improved 2TB of expandable storage, Galaxy A17 5G makes it easy to keep cherished photos, videos and important files readily accessible whenever you need them.³
  • BUILT TO LAST: With an improved IP54 rating, Galaxy A17 5G is even more durable than before.⁴ It’s built to resist splashes and dust and comes with a stronger yet slimmer Gorilla Glass Victus front and Glass Fiber Reinforced Polymer back.

There are two documented ways to get the tools on a Mac. Choose one; there is no requirement to install both.

Route What to do Best fit
Google’s Mac archive Download and extract platform-tools-latest-darwin.zip from Google’s Platform-Tools page. You prefer a direct download and managing the extracted tools yourself.
Homebrew Install Homebrew using its official instructions, add /opt/homebrew/bin to your PATH as directed by the installer, then run brew install --cask android-platform-tools. You already use Homebrew to install and update command-line tools.

The Homebrew route is documented in the LineageOS ADB and fastboot guide. Once the tools are installed, open Terminal and check availability with adb --version and fastboot --version. Google’s flashing documentation also uses these version checks. A successful version response confirms that the command is available; it does not establish that the phone is connected or that a particular flash command is safe.

Rank #2
Tracfone Motorola Moto G 2025, 64GB, Saphire Blue (Locked to
  • Carrier: This phone is locked to Tracfone, which means this device can only be used on the Tracfone wireless network. Tracfone plan required, activating is easy, just 3 steps.
  • DISPLAY: Immersive viewing on a 6.7-inch super-bright 120Hz display with powerful stereo speakers and Bass Boost for cinematic entertainment.
  • CAMERA SYSTEM: Advanced 50MP Quad Pixel camera captures sharp, detailed photos and videos in any lighting condition
  • PERFORMANCE: Lightning-fast 5G connectivity paired with a powerful processor and RAM Boost for smooth multitasking.
  • BATTERY LIFE: Long-lasting 5000mAh battery with TurboPower charging technology delivers hours of power in minutes.

Check ADB detection before proceeding

  1. On the phone, enable Developer options and USB debugging if the device guide requires them. The menu location can vary by Android version and manufacturer, so use the phone’s instructions if these options are not where expected.
  2. Connect the phone to the Mac and run adb devices in Terminal.
  3. When Android displays a USB debugging authorization prompt, review and approve it. Confirm the device appears in ADB’s output before relying on ADB commands.

LineageOS documents this connection and authorization check in its ADB and fastboot guide. ADB detection applies only when the phone is in a state that supports ADB; a phone in bootloader mode should instead be checked with the device guide’s fastboot instructions.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Understand the bootloader unlock and data-loss risk

Many phones ship with a locked bootloader. Unlocking is a device-specific prerequisite, not a universal first command. The Android Open Source Project’s general guidance describes enabling OEM unlocking in Developer options when available, entering bootloader mode and using the supported unlock process, with confirmation on the phone. If OEM unlocking is unavailable, the device may not permit unlocking; manufacturer or carrier rules can also affect availability. Do not try a generic command or attempt to bypass a restriction. Follow the manufacturer’s and ROM’s instructions for your model: AOSP: Locking and unlocking the bootloader.

Rank #3
Sale
Samsung Galaxy A17 5G Smart Phone 128GB, US 1 Yr Manufacturer Warranty Blue
  • YOUR CONTENT, SUPER SMOOTH: The ultra-clear 6.7" FHD+ Super AMOLED display of Galaxy A17 5G helps bring your content to life, whether you're scrolling through recipes or video chatting with loved ones.¹
  • LIVE FAST. CHARGE FASTER: Focus more on the moment and less on your battery percentage with Galaxy A17 5G. Super Fast Charging powers up your battery so you can get back to life sooner.²
  • MEMORIES MADE PICTURE PERFECT: Capture every angle in stunning clarity, from wide family photos to close-ups of friends, with the triple-lens camera on Galaxy A17 5G.
  • NEED MORE STORAGE? WE HAVE YOU COVERED: With an improved 2TB of expandable storage, Galaxy A17 5G makes it easy to keep cherished photos, videos and important files readily accessible whenever you need them.³
  • BUILT TO LAST: With an improved IP54 rating, Galaxy A17 5G is even more durable than before.⁴ It’s built to resist splashes and dust and comes with a stronger yet slimmer Gorilla Glass Victus front and Glass Fiber Reinforced Polymer back.

Back up before unlocking. AOSP says unlocking erases user data, including private app data and shared files accessible over USB, and requires an on-device confirmation. The supported command varies across devices and generations, so use the exact instructions for your phone rather than copying a command from a different model.

An unlocked bootloader allows modified software to boot, but software integrity cannot be guaranteed with a custom operating system. Data left on a device while it is unlocked may be at risk. Do not relock the bootloader unless the instructions for both your device and ROM explicitly support doing so. See AOSP’s boot-flow documentation.

Rank #4
Sale
Samsung Galaxy S26 Ultra, Unlocked Android Smartphone, 512GB, Black
  • PRIVACY DISPLAY: Automatically hide your screen from those beside you. The built-in privacy display can be preset¹ to turn on when receiving notifications, typing passwords, or using specific apps
  • TYPE IT IN. TRANSFORM IT FAST: Enhance any shot in seconds on your smartphone by using Photo Assist² with Galaxy AI.³ Add objects, restore details, or apply new styles by simply typing or tapping
  • NIGHTS, CAPTURED CLEARLY: From gigs to city lights, record and capture moments after dark with clarity using Nightography so your photos and videos stay crisp and clear on your Samsung Galaxy
  • MAKE IT. EDIT IT. SHARE IT: Turn everyday moments into something personal with creative tools built right into your mobile phone, whether it’s a special contact photo, custom wallpaper, an invitation or more⁴
  • HELP THAT KEEPS UP: Stay in the moment while Now Nudge with Galaxy AI helps you respond faster and stay organized with smart suggestions⁵ that appear exactly when you need them on your phone
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Follow the device-specific recovery and sideload sequence

Before flashing, find the current installation page for the phone’s exact model or codename and the ROM release you intend to install. Check its requirements for bootloader unlocking, firmware, partitions, recovery image and add-on packages. Those details can differ between devices, so the general pattern below cannot replace the device guide.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Example only: LineageOS for cas

The LineageOS guide for the device codename cas illustrates one possible sequence: download the recommended Lineage Recovery, enter fastboot mode, check detection with fastboot devices, flash the recovery image using the guide’s specified command, then boot into recovery. The guide next calls for a factory reset and data format; from recovery, select Apply update > Apply from ADB and run adb -d sideload /path/to/zip with the actual package path. It warns not to reboot into Android before completing the remaining instructions. The guide also says a signature-verification failure can indicate a corrupted or unofficial package, and that its optional Google Apps add-on must be installed before the first boot.

Best Value
Tracfone Moto g Play 2024 Prepaid Phone with a 1-Yr Plan Included
  • Carrier: This phone is locked to Tracfone, which means this device can only be used on the Tracfone wireless network. Activating is easy, just 3 steps.
  • ACTIVATION Promotion: Includes 1500 min, 1500 texts & 1500 MB Data + add more as you need it
  • CAMERA SYSTEM: 50MP Quad Pixel camera. Capture sharper, more vibrant photos day or night with 4x the light sensitivity.
  • PERFORMANCE: Blazing-fast Qualcomm performance. Get the speed you need for great entertainment with a Snapdragon 680 processor and 4GB of RAM.
  • 64GB built-in storage. Get plenty of room for photos, movies, songs, and apps. Made for US

These are details from the LineageOS installation guide for cas, not commands or steps to reuse on another phone. Use the guide’s current commands and package order for your own device. In particular, do not infer a recovery image name, partition target, reset step or add-on sequence from this example.

Quick Recap

Troubleshoot connection and transfer failures

  • adb devices shows no phone: Check that the phone is running Android or a compatible recovery, USB debugging is enabled when required, and you accepted the on-device authorization prompt.
  • fastboot devices shows no phone: Confirm the phone is actually in bootloader/fastboot mode, then try another data-capable cable and USB port. A charging-only cable will not provide the required data connection.
  • A fastboot command stalls or a transfer fails: Some bootloaders have USB-support problems. Try a different cable or port before retrying, and verify the phone’s state and the device guide before issuing any flash command again. Do not repeatedly run destructive commands without checking what happened.
  • Considering a browser-based alternative: LineageOS Flash Tools can perform supported sideload or fastboot actions in a WebUSB-compatible browser. It is an alternate interface, not a universal compatibility fix; the device-specific installation instructions still apply. Its guidance also notes that USB adapters or hubs can contribute to transfer errors, so test a direct connection or another cable and port if needed. See Using LineageOS Flash Tools.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
Crashes, No Sound, or Screen Glitches?Free driver scan
Windows Errors? Fix Them Before They SpreadFree repair scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.