Refactored Tor on Mac page

source/misc-guides/tor-os/linux.rst

@@ -4,6 +4,8 @@
 Running Tor on Linux
 ********************
 
+For Debian and Debian-based systems, such as Ubuntu, Mint, etc.
+
 #. Install the Tor proxy service to your system. To do so, open your terminal and run the following command:
 
    .. code-block::

source/misc-guides/tor-os/mac.rst

@@ -4,36 +4,102 @@
 Running Tor on MacOS
 ********************
 
-#. First, you need to install the Tor proxy service to your system. This will require opening your Terminal. 
+Install Homebrew
+================
 
-#. To open your terminal, hold the command key ⌘ + spacebar. `Spotlight Search` will appear. Start typing "terminal" and select the program called `Terminal`.
+For macOS running on ARM chips (ie. newer macs):
+------------------------------------------------
 
-#. Paste in the following commands and hit <Enter>.
+.. warning:: macOS Homebrew running natively on M1/Apple Silicon/ARM has partial functionality. Therefore, some additional steps are needed to setup Homebrew.
+
+#. Open a command line editor (Terminal), and run the following commands:
+
+    .. code-block::
+
+        softwareupdate --install-rosetta
+        arch -x86_64 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
+
+#. Use this command to install packages:
+
+    .. code-block::
+
+        arch -x86_64 brew install <package>
+
+For macOS Big Sur/Catalina:
+---------------------------
+
+1. If you do not have Homebrew installed, follow the installation instructions `here <https://brew.sh/>`_.
+
+    TLDR: Open the command line editor (Terminal) and paste the following line:
+
+    .. code-block::
+
+        /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
+
+2. You will be prompted for your system password before installation; proceed with entering your password:
+
+.. figure:: /_static/images/tor/install_homebrew.png
+    :width: 80%
+    :alt: Homebrew installation
+
+    Enter your password
+
+3. You will be notified which directories Homebrew is going to create, hit :code:`RETURN`:
+
+.. figure:: /_static/images/tor/install_homebrew1.png
+    :width: 80%
+    :alt: Homebrew installation
+
+Homebrew creates the directories and downloads any other files it needs e.g. “Command Line Tool for Xcode” and “Homebrew”.
+
+Wait a few minutes while it downloads and installs what it needs.
+
+.. warning:: Surprisingly, Homebrew uses Google Analytics to collect anonymous usage data. You can deselect the option to share usage data by `opting out <https://docs.brew.sh/Analytics#opting-out>`_.
+
+Install Tor
+===========
+
+.. warning:: If you have the Tor Browser open, close it and quit the application.
+
+For macOS with ARM chips
+------------------------
+
+In the command line type:
+
+    .. code-block::
+
+        arch -x86_64 brew install tor
+
+For macOS Big Sur/Catalina:
+---------------------------
+
+In the command line type:
 
     .. code-block::
 
-    which brew || /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
         brew install tor
+
+
+See the `Tor Project <https://2019.www.torproject.org/docs/tor-doc-osx.html.en>`_ for more details.
+
+Once it is finished you have the following options:
+
+.. figure:: /_static/images/tor/install_tor.png
+    :width: 80%
+    :alt: Tor installation
+
+    Install Tor
+
+In the command line type
+
+.. code-block::
+
     brew services start tor
 
-#. When this completes, you should see something like:
+or
 
-   .. code-block::
+.. code-block::
 
-    ==> Successfully started `tor` (label: homebrew.mxcl.tor)
+    arch -x86_64 services start tor
 
-#. If you notice issues connecting to Tor websites, try restarting the Tor service. Open the terminal and run:
-
-   .. code-block::
-
-    brew services restart tor
-
-#. After running this command, you should see something like:
-
-   .. code-block::
-
-    Stopping `tor`... (might take a while)
-    ==> Successfully stopped `tor` (label: homebrew.mxcl.tor)
-    ==> Successfully started `tor` (label: homebrew.mxcl.tor)
-
-#. That's it! Your Mac is now setup to natively use Tor.
+depending on your device (as explained above). This will start Tor and ensure that it is always running, even after a restart.