Short manual how to use Wi-Free in terminal (Linux and Mac OS X versions)

At the moment Wi-Free for Linux and Mac OS X works in console only (Terminal User Interface). This page gives instructions on how to run Wi-Free in terminal.

Attention: Wi-Free must be run with root privileges (root is a special user account used for system administration). These privileges are necessary to configure network. The easiest way to get root privileges is to use sudo utility.

1. Change directory to that one where you have saved Wi-Free. For example:

cd ~/Downloads

and set executable attribute for the file:

For Linux:
chmod +x wi-free-linux

For Mac OS X
chmod +x wi-free-macosx

Note: Filename may differ, eg. some browsers may add .txt or .asc extensions to filename after download.

2. Run Wi-Free by the following command:

For Linux:
./wi-free-linux

For Mac OS X:
./wi-free-macosx

3. Accept our terms and license and read this help:

Wi-Free 1.09 (build 1305072724 from 2011-05-11 03:12:04)
Copyright (C) 2009 MMC Networks Limited. All rights reserved.
http://www.wi-free.com/
Usage:	wi-free [options] [-g | <username> <password>]
	wi-free -n
	wi-free -v
	wi-free -U
Options:
	-n		Register new user
	-v		Provide voucher code to credit your account
	-U		Update servers list
	-g		Login as guest
	-S		Select the server to connect to
	-E		Select external IP
	-T		Test speed of all servers
	-e		Encrypt transmitted data
	-u		Try to use only UDP tunnel
	-t		Try to use only TCP tunnel
	-i		Try to use only ICMP tunnel
	-d		Try to use only DNS tunnel
	-N <nameserver>	Use this DNS server for DNS tunnel
	-s <subnet>	Selected subnet to use (default 10.0.0.0):
				10.0.0.0
				172.16.0.0
				192.168.0.0
				169.254.0.0
	-r		Do not set default route
	-D		Do not use Wi-Free DNS server for normal lookups
	-p <proxy>	Use parent proxy:
				type://ip:port
				type://user:password@ip:port
			Supported proxy types: HTTPS, SOCKS4, SOCKS5
	-H <header>	Add extra header to CONNECT request for HTTPS proxy
	-l		Display list of third-parties

4. If you don't have Wi-Free account you should get an account by this command:

For Linux:
./wi-free-linux -n

For Mac OS X:
./wi-free-macosx -n

Then fill a few forms.

5. There are command line examples to make connection with username "user" and password "123123" (replace username and password to yours):

For Linux:
./wi-free-linux user 123123 (try all connection protocols)
./wi-free-linux -i user 123123 (try ICMP protocol only)
./wi-free-linux -u user 123123 (try UDP protocol only)
./wi-free-linux -S -i user 123123 (try ICMP protocol with server selection)
./wi-free-linux -e -i user 123123 (try ICMP protocol with encryption)

For Mac OS X:
./wi-free-macosx user 123123 (try all connection protocols)
./wi-free-macosx -i user 123123 (try ICMP protocol only)
./wi-free-macosx -u user 123123 (try UDP protocol only)
./wi-free-macosx -S -i user 123123 (try ICMP protocol with server selection)
./wi-free-macosx -e -i user 123123 (try ICMP protocol with encryption)