Skip to content

Quick Start

This page uses an "Office" network rule as an example to explain the basic NetScene workflow.

1. Open Rule Configuration

Click the NetScene icon in the menu bar and choose "Configure Rules".

If there are no rules yet, the app provides one default rule. Rename it to a real scene first, for example:

text
Office

2. Set Wi-Fi

Set the Wi-Fi state in the rule details:

  • Turn on Wi-Fi: enable Wi-Fi when switching to this rule.
  • Turn off Wi-Fi: disable Wi-Fi when switching to this rule.

If you want to connect to a specific Wi-Fi network automatically, enter its SSID.

Use backslashes to separate multiple SSIDs. NetScene tries them in the order you enter:

text
Office-5G\Office-Backup

3. Set Network Services

Network services usually include:

  • Wi-Fi
  • Ethernet
  • USB 10/100/1000 LAN
  • Thunderbolt Bridge

You can enable or disable each service and choose its IP and DNS strategy.

Common combinations:

SceneSettings
Normal officeWi-Fi on, IP via DHCP, DNS automatic
Client-site debuggingSpecific USB adapter on, manual IP, manual DNS
Wired onlyEthernet on, Wi-Fi off

4. Set App Actions

App actions can run before or after the network switch.

For an office rule:

  • Before switching: close the proxy client.
  • After switching: open Slack, browser, and meeting app.

Closing an app normally requests the app to quit. Enable "force kill process" only when you really need it, because it is more likely to cause unsaved data loss or abnormal app state.

5. Set Launch Guard

Launch Guard helps avoid opening important apps under the wrong network scene.

For example:

  • Ask for confirmation before opening a production database client under the "Home" rule.
  • Ask for confirmation before opening a personal proxy client under the "Client Site" rule.

When launch is canceled, NetScene normally requests the app to quit. If force kill is enabled for that guard, NetScene ends the process directly.

6. Switch Rules from the Menu Bar

After configuration, click the NetScene icon in the menu bar and choose the rule you need.

When switching, NetScene runs the rule in this order:

  1. App actions before network switching.
  2. Wi-Fi, network service, IP, and DNS settings.
  3. App actions after network switching.

If macOS asks for permission during execution, follow the system prompt.

NetScene is a macOS network scene automation tool.