# MacOS

## Anyone Browser

Anonymous Onion Routing\
The v1 Anyone Browser is out with completely free, super-fast onion routing.

### Download from the App Store..

{% embed url="<https://apps.apple.com/gb/app/anyone-browser/id6741429520>" %}

Anyone Browser is supported on both MacOS and iOS.\
Read more about it in the [iOS section](https://docs.anyone.io/ios#ios) of the docs.

<div><figure><img src="https://3545050655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAA9P3lN6X0LnMGWCOpyt%2Fuploads%2F8qWBSuVMNHOFDHouMATh%2Fipad-1.png?alt=media&#x26;token=37b47aeb-df75-4b01-8aa0-2667c4f673d8" alt=""><figcaption></figcaption></figure> <figure><img src="https://3545050655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAA9P3lN6X0LnMGWCOpyt%2Fuploads%2FwVVwMF57LZbLX35YBtpQ%2Fipad-2.png?alt=media&#x26;token=494281b2-77ed-4bc7-b2d0-8b79021ee35f" alt=""><figcaption></figcaption></figure> <figure><img src="https://3545050655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAA9P3lN6X0LnMGWCOpyt%2Fuploads%2F2XUIl5bi4Myyw6gEgdww%2Fipad-3.png?alt=media&#x26;token=20142c24-c7e6-4f2b-9b84-0783925fe2fe" alt=""><figcaption></figcaption></figure> <figure><img src="https://3545050655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAA9P3lN6X0LnMGWCOpyt%2Fuploads%2FPRb6DDeKDhcmZ7nm6gVJ%2Fipad-4.png?alt=media&#x26;token=f0a05492-da09-404e-9c3b-ba48662ec047" alt=""><figcaption></figcaption></figure> <figure><img src="https://3545050655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAA9P3lN6X0LnMGWCOpyt%2Fuploads%2F3j4RpZmiFLFosgiAhFAd%2Fipad-5.png?alt=media&#x26;token=42c18a9f-f54a-490f-a75a-16ad81b95ab6" alt=""><figcaption></figcaption></figure> <figure><img src="https://3545050655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAA9P3lN6X0LnMGWCOpyt%2Fuploads%2Fh3yXcK91KYd8bbETZ9YE%2Fipad-6.png?alt=media&#x26;token=cc967205-a041-47b2-ac78-1d802caec4bf" alt=""><figcaption></figcaption></figure></div>

***

## macOS with NPM

This guide will explain how to use the start the anyone-client and setup macOS to automatically route all compatible apps through the network, including browsers, streaming and more. We can do this using the Anyone SDK, which is built for creating private applications, but also works for individual use!

{% hint style="info" %}
**Primer: Test if you are on Anyone**

You can visit the URL <https://check.en.anyone.tech> to check that you aren't already connected to the Anyone network a different way
{% endhint %}

#### Install the Anyone Client

The simplest way to install anyone is through *npm.* If you already have npm, you can skip the collapsible window below

<details>

<summary>Installing npm</summary>

You can install easily by following the macOS guide on the [Node.js ](https://nodejs.org/en/download/package-manager)website. The steps are replicated here, to be pasted and run on the **Terminal** app on your Mac.&#x20;

1. Install nvm&#x20;

```
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
```

2. Use nvm to install Node.js 20

```
nvm install 20
```

3. Verify that you have installed Node.js and npm by ensuring you get a version code for each of these commands

```
node -v
npm -v
```

</details>

Once you have npm, simply install like below from the Terminal app

```
npm install @anyone-protocol/anyone-client 
```

#### Running the Client

&#x20;Once installed, you can start the anyone-client with the default configuration from the Terminal:

```
npx anyone-client
```

This will show a few setup messages, ending with&#x20;

<details>

<summary>Optional: Changing from the default configuration</summary>

If you have a specific use-case, or have issues with connecting in the subsequent steps, you can set&#x20;

`-s` Set the SocksPort (default: 9050)

`-c` Set the ControlPort (default: 9051, use 0 to disable)

`-o` Set the OrPort (default: 9001)

`-v` Enable verbose mode for full client logs

`-f` Set the path to custom anonrc config file

`-b` Set the path to custom anon binary (To use preinstalled one)

</details>

#### Routing System-Wide

To route system-wide, go to **System Preferences** and navigate to the **Proxies** window - the simplest way is to search for it from the searchbar. This will open a pop-up like below:

<div align="left"><figure><img src="https://content.gitbook.com/content/AA9P3lN6X0LnMGWCOpyt/blobs/zBkJPXtKoBChuKPNPt90/Screenshot%202024-09-11%20at%2014.49.39.png" alt="" width="323"><figcaption></figcaption></figure> <figure><img src="https://content.gitbook.com/content/AA9P3lN6X0LnMGWCOpyt/blobs/h8AjlI99AS4gblAg5VMm/Screenshot%202024-09-11%20at%2014.51.06.png" alt="" width="563"><figcaption></figcaption></figure></div>

From there, enable the **Socks proxy** option and put in the following options:

```
Server: 127.0.0.1
Port: 9050
```

<div data-full-width="false"><figure><img src="https://content.gitbook.com/content/AA9P3lN6X0LnMGWCOpyt/blobs/UIumgUIpE2OGRIz67Agz/Screenshot%202024-09-11%20at%2014.51.35.png" alt=""><figcaption></figcaption></figure></div>

If you are not running anyone-client on your macOS machine (for example, running it on the hardware or another local server), the server IP will be different. Head to [Connect Through Hardware](https://docs.anyone.io/connect/hardware) to see more cases.

#### Completing the Check

Once the proxy server is enabled, you can return to <https://check.en.anyone.tech> from Chrome, Brave or Safari and see if your perceived IP has changed!

#### Connecting Individual Apps

If you'd instead like to connect individual apps, instead of configuring all applicable programs, see the link below!

{% content-ref url="apps" %}
[apps](https://docs.anyone.io/connect/apps)
{% endcontent-ref %}