Gentoo Wiki


Please improve it in any way that you see fit, and remove this notice {{Cleanup}} from the article. For tips on cleaning and formatting see Cleanup process



There are many configuration and monitoring tools for wireless networks under Gentoo. The following are known to be available in portage.


Note for Xfce users who require panel support, the package xfce-extra/xfce4-xfapplet should provide tools that allow a Gnome applet to work.


emerge alien gnome-python-extras

mkdir -p local/src/gtkwifi
cd local/src/gtkwifi
export VER="1.10"

sudo alien --to-tgz gtkwifi-${VER}.deb

sudo tar xzf gtkwifi-${VER}.tgz -C /

alt-click panel » Add to Panel... » Wireless Connection Manager


mkdir -p local/src/gwifiapplet
cd local/src/gwifiapplet
export VER="0.8"
tar xzf gwireless_applet-${VER}.tar.gz
cd gwireless_applet-${VER}
./configure && make
sudo make install

Novell's Gnome wireless switcher

(no further information provided yet)



WLAssistant An Kde Frontend to connect to Wifi Access Points

emerge wlassistant

Independent (suited for xfce4 and such)


WICD is a small python based GUI network manager without any GNOME or KDE dependencies. Only GTK+ is required (besides the network stuff). So it is perfect for users of Xfce4 or any other small WMs. It may not be the prettiest, but I think it's one of the best working and lightest one out there.

To install it run:

emerge -av wicd

You can now add the wicd daemon to the default runlevel (if you want):

rc-update add wicd default

Or just start it right now. But remember that you first have to restart DBUS so DBUS gets the config file for wicd.

/etc/init.d/dbus restart
/etc/init.d/wicd start
Note: WICD-1.5 rolled both the GUI and the tray icon into a single client app called 'wicd-client'. To start it, simply run

More info can be found in the wicd documentation or website.

You you can start WICD by either /opt/wicd/ or /opt/wicd/

I didnt like the managment of my wired ethernet port so i just deleted it in the config section. Be sure to choose the right driver for your WPA supplicant and you are ready to roam the WIFIs :)

Network Manager

See the wiki page for NetworkManager.

WiFi Radar

This one is in portage:

emerge wifi-radar

It's a python/gtk script for managing WiFi connections and seems to work reasonably well.

This program has to be run as root in order to configure the network card. You can also use "sudo" but you may be getting this error :

 RuntimeError: could not open display

The best workaround is to use gksu:

emerge gksu
gksu wifi-radar

You will then be asked for the root password.

The other cool thing about wifi-radar is that you can run it as a daemon using

wifi-radar -d

If you run this command at boot time, wifi-radar will configure your wireless card using the network information you already provided in the graphical application.


netapplet is a hack created for Suse linux. It is obsoleted by NetworkManager:

mkdir -p local/src/netapplet
cd local/src/netapplet
export VER=1.0.8
tar xzf netapplet-${VER}.tar.gz
cd netapplet-${VER}
./configure && make
sudo make install

sudo /usr/local/bin/netdaemon
sudo /usr/local/bin/netapplet


RutilT is a Gtk+2 utility for Linux that helps you configure your wireless devices. Although primely written for the rt2x00 project (Ralink chipsets), it is designed to work with any device. RutilT is a GTK+ based wireless device configuration tool, with extra support for Ralink devices. There are currently ebuilds for RutilT at [1], or you can download the tarballs from the maintainer's website:

Note: For the Edimax EW-7128G card on an Intel Core 2 Duo, I used RutilTv0.15.

Change to the directory where you downloaded the file and extract it using the command:

Code: Extract RutilT
tar -xzvf RutilTv0.15.tar.gz
substituting RutilTv0.15.tar.gz with the file you downloaded.

Change all instances of dhcpd to dhcpcd in the file. The file should look now look like this:

#    Copyright (c) 2005-2007 Romain BONDUE
#    This file is part of RutilT.
#    RutilT is free software; you can redistribute it and/or modify
#    it under the terms of the GNU General Public License as published by
#    the Free Software Foundation; either version 2 of the License, or
#    (at your option) any later version.
#    RutilT is distributed in the hope that it will be useful,
#    but WITHOUT ANY WARRANTY; without even the implied warranty of
#    GNU General Public License for more details.
#    You should have received a copy of the GNU General Public License
#    along with RutilT; if not, write to the Free Software
#    Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
# This script is called by RutilT with 2 arguments : the device name, and
# the network ESSID.
# WARNING : This script is executed with root privileges, so beware.
case $2 in
# RutilT doesn't support static IPs currently, until it does, if ever, you can
# customize this script to do the job, don't forget to set the IP setting to
# "Automatic" in the matching profile.
# Here is an example on how you could set a static IP for networks "foo" and/or
# "bar".  The two ";;" at the end of the line are required.
# The "#" at the beginning of the line means comment, so you definetely don't
# want to put one on yours.
#    'foo') /sbin/ifconfig $1;;
#    'bar') /sbin/ifconfig $1;;
# Note that setting the address is usually not enough, the gateway, netmask
# and dns server address should typically be set too. Have a look at "ifconfig"
# man page and your distribution documentation.
# WARNING : Always put your static settings above this line.
# No known essid, fallback on DHCP  but first kill any previously running
# dhcp client :
    *) if [ -e /sbin/dhclient ]; then
           kill `ps -o pid= -C"dhclient $1"`
           exec /sbin/dhclient $1
           kill `ps -o pid= -C"dhcpcd $1"`
           exec /sbin/dhcpcd $1

Follow the instructions in the INSTALL file in the extracted RutilT directory.

Now when you run RutilT, you should be able to configure your wireless connection and set up WPA.

See also

Wireless diagnostic tools are available in portage to help diagnose problems, sniff traffic or scan for access points:

There aren't too many programs available for wireless profile management. But here is a small list to try

Retrieved from ""

Last modified: Wed, 17 Sep 2008 06:05:00 +0000 Hits: 45,910