Skip to content

Download the Configuration Tool

Get the smartap-cfg tool for your computer.

Choose Your Operating System

Windows

Windows

After downloading:

  1. Find the downloaded file (usually in your Downloads folder)
  2. Double-click smartap-cfg-windows-amd64.exe to run it

Windows Security Warning

Windows may show a blue "Windows protected your PC" warning. This is normal for new software.

To continue:

  1. Click "More info"
  2. Click "Run anyway"

This only happens the first time you run the tool.

macOS

Which Mac do you have?

Not sure which Mac you have?

Click the Apple menu → "About This Mac". If it says "Apple M1" or similar, you have Apple Silicon. If it says "Intel", you have an Intel Mac.

After downloading:

  1. Open Finder and go to your Downloads folder
  2. Find the downloaded file (smartap-cfg-darwin-arm64 or smartap-cfg-darwin-amd64)
  3. Right-click (or Control-click) on the file
  4. Select "Open" from the menu
  5. Click "Open" in the security dialog

macOS Security Warning

macOS blocks apps downloaded from the internet by default. Right-clicking and selecting "Open" tells macOS you trust this file.

If you see "cannot be opened because it is from an unidentified developer":

  1. Go to System Settings → Privacy & Security
  2. Scroll down to see a message about the blocked app
  3. Click "Open Anyway"

Opening Terminal (first time only):

If you've never used Terminal before:

  1. Press Command + Space to open Spotlight
  2. Type Terminal and press Enter
  3. A window with a command prompt appears

Running the tool:

In Terminal, type these commands (pressing Enter after each):

cd ~/Downloads
chmod +x smartap-cfg-darwin-arm64
./smartap-cfg-darwin-arm64

(Replace arm64 with amd64 if you have an Intel Mac)

Linux

Download the version for your system:

After downloading:

cd ~/Downloads
chmod +x smartap-cfg-linux-amd64
./smartap-cfg-linux-amd64

Verify It Works

When you run the tool successfully, you'll see the wizard interface start up:

┌──────────────────────────────────────────────────────────────────────────────┐
│ SMARTAP CONFIGURATION WIZARD v1.0.0                    github.com/muurk/smartap│
├──────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│                        ⣾ SEARCHING FOR DEVICES                               │
│                                                                              │

If you see this, the tool is working. It's looking for your Smartap device on the network.

Device Not Found?

If the wizard can't find your device, that's expected at this stage. Continue to the next page to learn how to connect to your device.

What's Next?

Continue to Connection Guide

The next page explains how to connect your computer to your Smartap device so the wizard can find it.

Previous: Overview Next: Connection Guide