# osx-guide

### MacOS From Source

Open Terminal (if you don't know how to, click on the magnifying glass on the top right corner of your screen and type **Terminal** on the window that pops up) and navigate to the location where you want to install the bot (for example `cd ~`)

**Installing Homebrew, wget and dotnet**

**Homebrew/wget**

*Skip this step if you already have homebrew installed*

* Copy and paste this command, then press Enter:\
  `/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"`
* Install wget
  * `brew install wget`

**Dotnet**

* Download [.net6 SDK](https://dotnet.microsoft.com/download/dotnet/6.0)
* Open the `.pkg` file you've downloaded and install it.
* Run this command in Terminal. There might be output. If there is, disregard it. (copy-paste the entire block)

```bash
sudo mkdir /usr/local/bin

sudo mkdir /usr/local/lib
```

* Run this command in Terminal. There won't be any output. (copy-paste the entire block):

```bash
sudo ln -s /usr/local/share/dotnet/dotnet /usr/local/bin

sudo ln -s /usr/local/opt/openssl/lib/libcrypto.1.0.0.dylib /usr/local/lib/

sudo ln -s /usr/local/opt/openssl/lib/libssl.1.0.0.dylib /usr/local/lib/
```

**Installation Instructions**

1. Download and run the **new** installer script `cd ~ && wget -N https://github.com/Wizkiller96/wizbot-bash-installer/raw/v4/linuxAIO.sh && bash linuxAIO.sh`
2. Install prerequisites (type `1` and press enter)
3. Download the bot (type `2` and press enter)
4. Exit the installer in order to set up your `creds.yml`
5. Copy the creds.yml template `cp wizbot/output/creds_example.yml wizbot/output/creds.yml`
6. Open `wizbot/output/creds.yml` with your favorite text editor. We will use nano here
   * `nano wizbot/output/creds.yml`
7. [Enter your bot's token](#creds-guide)
   * After you're done, you can close nano (and save the file) by inputting, in order
     * `CTRL`+`X`
     * `Y`
     * `Enter`
8. Run the bot (type `3` and press enter)

**Update Instructions**

1. ⚠ Stop the bot
2. Update and run the **new** installer script `cd ~ && wget -N https://github.com/Wizkiller96/wizbot-bash-installer/raw/v4/linuxAIO.sh && bash linuxAIO.sh`
3. Update the bot (type `2` and press enter)
4. Run the bot (type `3` and press enter)
5. 🎉

### MacOS Manual Release installation instructions

⚠ IF YOU ARE FOLLOWING THE GUIDE ABOVE, IGNORE THIS SECTION ⚠

**Installation Instructions**

1. Download the latest release from <https://gitlab.com/WizNet/WizBot/-/releases>
   * Look for the file called "X.XX.X-osx-x64-build.tar" (where X.XX.X is a series of numbers) and download it
2. Untar it ⚠ Make sure that you change X.XX.X to the same series of numbers as in step 1!
   * `tar xf X.XX.X-osx-x64-build.tar`
3. Rename the `wizbot-osx-x64` to `wizbot`
   * `mv wizbot-osx-x64 wizbot`
4. Move into wizbot directory and make WizBot executable
   * `cd wizbot && chmod +x WizBot`
5. Copy the creds.yml template
   * `cp creds_example.yml creds.yml`
6. Open `creds.yml` with your favorite text editor. We will use nano here
   * `nano wizbot/output/creds.yml`
7. [Enter your bot's token](#creds-guide)
   * After you're done, you can close nano (and save the file) by inputting, in order
     * `CTRL`+`X`
     * `Y`
     * `Enter`
8. Run the bot
   * `./WizBot`

**Update Instructions**

1. Stop the bot
2. Download the latest release from <https://gitlab.com/WizNet/WizBot/-/releases>
   * Look for the file called "X.XX.X-osx-x64-build.tar" (where X.XX.X is a series of numbers) and download it
3. Untar it ⚠ Make sure that you change X.XX.X to the same series of numbers as in step 2!
   * `tar xf 2.99.8-osx-x64-build.tar`
4. Rename the old wizbot directory to wizbot-old (remove your old backup first if you have one, or back it up under a different name)
   * `rm -rf wizbot-old 2>/dev/null`
   * `mv wizbot wizbot-old`
5. Rename the new wizbot directory to wizbot
   * `mv wizbot-osx-x64 wizbot`
6. Remove old strings and aliases to avoid overwriting the updated versions of those files\
   ⚠ If you've modified said files, back them up instead
   * `rm wizbot-old/data/aliases.yml`
   * `rm -r wizbot-old/data/strings`
7. Copy old data
   * `cp -RT wizbot-old/data/ wizbot/data/`
8. Copy creds.yml
   * `cp wizbot-old/creds.yml wizbot/`
9. Move into wizbot directory and make the WizBot executable
   * `cd wizbot && chmod +x WizBot`
10. Run the bot
    * `./WizBot`

🎉 Enjoy

**Steps 3 - 9 as a single command**

Don't forget to change X.XX.X to match step 2.

```sh
tar xf X.XX.X-osx-x64-build.tar && \
rm -rf wizbot-old 2>/dev/null && \
mv wizbot wizbot-old && \
mv wizbot-osx-x64 wizbot && \
rm wizbot-old/data/aliases.yml && \
rm -r wizbot-old/data/strings && \
cp -RT wizbot-old/data/ wizbot/data/ && \
cp wizbot-old/creds.yml wizbot/ && \
cd wizbot && chmod +x WizBot
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ndocs.wizbot.cc/docs/guides/osx-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.