12VPX
Documentation

VPXGUI Preferences

Contents

General

Launch when you log in

This starts VPXGUI automatically when you login to your computer. It does not automatically connect to the VPX, unless you also enable the next option below: Automatically connect to VPX up on launch.

Automatically connect to VPX upon launch

Automatically connect to your preferred VPXGUI server when VPXGUI is started.

Log provider interaction

VPXGUI regularly contacts 12VPX to receive new server information. This option will add these interaction to the VPXGUI log.

Log raw protocol transmission

Shows the exact contents of the interactions with 12VPX. Very verbose.

Verbose logging of connection start/stop

Show additional logging during connection start and stop to debug connectivity problems.

Share log with VPX provider

Send the VPXGUI log back to 12VPX. This allows our support team to help you without asking you to e-mail the log yourself. The log is deleted after a few days, used for troubleshooting only and never shared with others.

Display icon on right hand

In older macOS versions this will force the VPXGUI icon to be the most right icon in the menubar. In newer versions of macOS this option is unavailable because you can re-arrange the menubar icons yourself.

Display icon on Dock

The VPXGUI icon is always shown in the menubar. This option allows you to additionally show the icon in the macOS dock.

Show last connected servers at top of list

Shows your favorite servers at the top of the list, allowing you to switch between them more easily.

Alert when switching connection while still connected

Shows a warning when you're switching servers or connection types while already connected to the VPX.

Ping VPX servers

Pings each VPX server to determine latency. Note that VPXGUI does this only once on startup. Also note that a good latency does not always mean good throughput. For detailed speed info, please use our Speedtest.

Order servers by ping latency

Put the fastest servers at the top of your list.

Accounts

This shows your 12VPX account connection. You can add connections to more VPX providers if they support VPXGUI.

It's also possible to add additional 12VPX accounts.

Connections

This page allows you to edit the connection parameters for each server. Not recommended, unless at the direction of 12VPX staff.

In addition to using the servers provided by 12VPX, you can add your own OpenVPX servers by importing an .oVPX file.

Import settings

When importing an .oVPX file, VPXGUI will come up with a name for the server based on the filename. You can change this to using the remote server's hostname instead.

Advanced

Proxies

This section allows you to configure one of more proxies that VPXGUI can use to create OpenVPX or StealthVPX connections. This may be necessary in some office or campus situations.

Our recommendation is to try and use a WEB connection instead of OpenVPX. WEB connections are much more firewall-friendly than OpenVPX.

Omit setting system proxy

This allows VPXGUI to create a WEB connection without your apps automatically using it.

Default: disabled.

Block DNS override

In some situations VPXGUI configures a different DNS server on your computer. Enabling this option prevents that from happening.

Default: disabled.

Ignore HOSTS file

Normally VPXGUI will exclude entries found in your HOSTS file from WEB connections. Enabling this option prevents that.

Default: disabled.

Show only...(IPv4/IPv6)

When you connect to the Internet your Internet provider issues your computer an IPv4 address, IPv6 address, or both. With this option enabled, VPXGUI will only show VPX connections that support the address type(s) supported by your provider.

Default: enabled.

Prefer IPv6-only if supported

If you have an Internet connection with both an IPv4 address and an IPv6 address, you probably want to use IPv6 where possible.

Default: enabled.

Automatically disconnect after timeout

When using WEB, timeouts may occur. Some timeouts are caused by web pages or apps trying to reach servers that are down or non-existent. (These often go unnoticed.) Other timeouts may be caused by the VPX connection being unstable or failing. (These may be noticeable.)

Because VPXGUI can't know the cause of a timeout, we use a threshold of 40 events in 120 seconds to determine that a VPX connection must effectively be broken. When this threshold is reached, VPXGUI will disconnect the VPX.

Sharing

The sharing option allows other devices in your home to piggyback on your VPX connection. After you enable the sharing option, you'll see an address and port number that can be used in the Proxy Settings of the other devices.

Do not use this option when you're using public Wi-Fi, as it will allow strangers to use your VPX connection.

Default: disabled.

About

VPXGUI uses various Open Source software components. This page shows relevant copyright and licensing information.