Git mirror of the WICD connection manager
Python Other
Latest commit d617058 Feb 1, 2013 @dpaleino Change behaviour when dealing with hostnames: don't send any if the u…
…ser didn't tick the box (previously, the current system name was sent).
Permalink
Failed to load latest commit information.
cli Fix some issues by pylint Nov 17, 2012
curses More pylint fixes Nov 17, 2012
data Usability issue: move "Refresh" button at first position, so to avoid… Nov 18, 2012
encryption/templates Add wpa-psk-hex template, merged from Gentoo Jan 23, 2013
gnome-shell Added gnome-shell extension Nov 28, 2012
gtk Change homepage to Launchpad Jan 23, 2013
icons Support icon themes in WICD -- we still miss most sizes for most icon… Nov 15, 2012
images Fix (probably? needs further testing) bug with themeability Nov 17, 2012
in Fix Gentoo initscript Jan 23, 2013
man Update manpages Nov 3, 2011
other Change behaviour when dealing with hostnames: don't send any if the u… Feb 1, 2013
po Launchpad automatic translations update. Jan 31, 2013
tests Fix typo Nov 16, 2012
wicd Change behaviour when dealing with hostnames: don't send any if the u… Feb 1, 2013
.bzrignore Ignore debian/, and in git too Nov 9, 2011
.gitignore Ignore debian/, and in git too Nov 9, 2011
AUTHORS Adding myself to authors Nov 9, 2011
CHANGES Prepare files for the release of 1.7.2.4 Apr 30, 2012
INSTALL Fix installation instructions Feb 5, 2012
LICENSE Experimental: Apply changes involving setup.py Aug 23, 2008
MANIFEST.in Fix MANIFEST.in to properly generate the tarball Nov 17, 2012
NEWS Prepare files for the release of 1.7.2.4 Apr 30, 2012
README Experimental: Apply changes involving setup.py Aug 23, 2008
pylintrc Disable more messages in pylint Nov 17, 2012
setup.cfg Updated wicd-curses.8.in, made the date in wicd-client.1 accurate, fi… Apr 14, 2009
setup.py Added gnome-shell extension Nov 28, 2012
uninstall.sh Experimental: Apply changes involving setup.py Aug 23, 2008

README

THEORY OF OPERATION:

Wicd is designed to give the user as much control over behavior of network 
connections as possible.  Every network, both wired and wireless, has its 
own profile with its own configuration options and connection behavior.  
Wicd will try to automatically connect only to networks the user specifies 
it should try, with a preference first to a wired network, then to wireless.

For wired connections, users have many options for determining what network 
settings to use.  Wicd allows creation of an unlimited number of wired 
profiles, each of which has its own unique settings.  The user can choose to 
automatically connect to a selected default profile, choose a profile from a 
pop-up window every time wicd connects, or have wicd automatically choose the
last profile used to manually connect.

For wireless connections, users can select any number of wireless networks
to automatically connect; wicd will choose the one with the highest signal 
strength to try to connect.

If the user chooses, wicd will try to automatically reconnect when it detects
that a connection is lost.  If the last known connection state is wired, wicd
will first try to reconnect to the wired network, and if it is not available, 
wicd will try any available wireless networks which have automatic connection 
enabled.  If the last known connection state is wireless, wicd will first try
to reconnect to the previously connected network (even if that network does 
not have automatic connection enabled), and should that fail, it will try both
a wired connection and any available wireless networks which have automatic
connection enabled.

Wicd uses built-in linux wireless-tools, such as ifconfig and iwconfig, to
get and configure network info.  There is some flexibility in its use of DHCP,
providing support for dhclient, dhcpcd, and pump.  Wicd uses wpa_supplicant
to handle all wireless encryption settings, and uses a template-based system
to create the configuration files used by wpa_supplicant.  These templates 
can be edited, and new templates can be created by the user and imported into
wicd, allowing connection to networks with uncommon encryption settings.


STRUCTURE:

Wicd has two major parts: the daemon, which runs with root privileges; and the
user interface, which runs with normal user privileges.  The two parts run as
separate processes and make use of D-Bus to communicate.

The daemon is responsible for making and configuring connections, reading and
writing configuration files and logs, and monitoring the connection status.  
The daemon's job is split between two processes: daemon.py and monitor.py.  
All the connection status monitoring, as well as the auto-reconnection logic,
takes place in monitor.py.  Everthing else is done by wicd-daemon.py.

The user interface (stored in wicd-client.py), which is made up of a tray 
icon, a main GUI window, and its child dialogs, gets configuration and network 
info from the daemon either by querying it using the methods in the daemon's 
dbus interface or by receiving signals emitted from the daemon over D-Bus.  
Any configuration changes made in the user interface are passed back to the
daemon, which actually applies the changes and writes them to configuration
files.

Since the user interface just queries for connection and configuration info 
from the daemon, it is possible to run wicd without the GUI at all.  Also, 
the daemon is started by wicd's init script during system startup (before any
user logs in), making it possible to use wicd with "headless" machines.