From 01b46eb742d2eed844c7242eabe0cb0faa1a5b6a Mon Sep 17 00:00:00 2001
From: jmartinn <juamp_m@hotmail.com>
Date: Mon, 11 Mar 2024 15:53:38 +0100
Subject: [PATCH] Add Rosetta installation instructions for macOS Apple Silicon
 users

---
 README.md            | 6 ++++++
 help_docs/uc_mode.md | 9 +++++++++
 2 files changed, 15 insertions(+)

diff --git a/README.md b/README.md
index af32ff24b90..7516eefbe61 100755
--- a/README.md
+++ b/README.md
@@ -279,6 +279,12 @@ Feature: SeleniumBase scenarios for the Simple App
 <h2><img src="https://seleniumbase.github.io/img/logo7.png" title="SeleniumBase" width="32" /> Install SeleniumBase:</h2>
 
 **You can install ``seleniumbase`` from [PyPI](https://pypi.org/project/seleniumbase/) or [GitHub](https://github.com/seleniumbase/SeleniumBase):**
+<h3>Special Instructions for macOS Users with Apple Silicon (M1/M2) CPUs</h3>
+If you're using a macOS machine with an Apple Silicon CPU (such as M1 or M2 chips) and you plan to use SeleniumBase's UC Mode, you might encounter an issue where the browser driver downloaded for UC Mode does not match your CPU architecture. This is because the driver meant for Intel CPUs is downloaded by default, which will not work directly on Apple Silicon CPUs.
+
+To resolve this issue, you need to install Rosetta, which allows applications compiled for Intel processors to run on Apple Silicon.
+
+Run the following command in your terminal to install Rosetta:
 
 🔵 **How to install ``seleniumbase`` from PyPI:**
 
diff --git a/help_docs/uc_mode.md b/help_docs/uc_mode.md
index 54a90c30d8c..e439250ab53 100644
--- a/help_docs/uc_mode.md
+++ b/help_docs/uc_mode.md
@@ -1,6 +1,15 @@
 <!-- SeleniumBase Docs -->
 
 ## [<img src="https://seleniumbase.github.io/img/logo6.png" title="SeleniumBase" width="32">](https://github.com/seleniumbase/SeleniumBase/) UC Mode 👤
+### Important Note for macOS Users with Apple Silicon (M1/M2) CPUs
+
+If you're using a macOS machine with an Apple Silicon CPU (such as M1 or M2 chips) and encountering issues with UC Mode saying "bad CPU type", it's because the downloaded chromedriver that SeleniumBase patches is intended for Intel processors. To solve this, you need to install Rosetta, which allows you to run applications compiled for Intel processors on Apple Silicon.
+
+Run the following command in your terminal to install Rosetta:
+
+```bash
+softwareupdate --install-rosetta
+```
 
 👤 SeleniumBase <b>UC Mode</b> (Undetected-Chromedriver Mode) allows bots to appear human, which lets them evade detection from anti-bot services that try to block them or trigger CAPTCHAs on various websites.