Skip to main content

A dead simple, cross-platform Python library to connect to wireless networks.

Project description

Build Status Documentation Status


A dead simple, cross-platform Python library to connect to wireless networks.


This library can control a computer’s wireless adapter to connect to a network. Environments currently supported include:

Operating System Network Managers Tested Adapters
Ubuntu 12.04, 14.04 nmcli Linksys AE3000, Intel Centrino 6250
Mac OS 10.10 networksetup Macbook Pro


sudo pip install wireless

To use the nmcli on Ubuntu 14.04, the right permissions must be in place. A few options are listed here.


A typical usage looks like this:

from wireless import Wireless
wireless = Wireless()
wireless.connect(ssid='ssid', password='password')


  • Wireless([interface]) - initialize the wireless driver
  • connect(ssid, password) - attempts to connect to a network and returns True on success
  • current() - returns the name of the current network or None otherwise
  • interfaces() - list the available interfaces
  • interface(interface) - get or set the current interface
  • power(power=True||False) - get or set the power status of the adapter


First, install pandoc to auto-convert Markdown syntax into reStructuredText:

sudo apt-get install pandoc
sudo pip install pypandoc

Then, following this guide, push the project to PyPI:

sudo python sdist upload -r pypi

Change History

This project uses semantic versioning.

v0.2.1 - 2014/12/01

  • remove dependency on pandoc

v0.2.0 - 2014/11/25

  • Added support for multiple network adapters with interface() and interfaces() methods
  • The current() method actually asks the wireless driver for the current SSID instead of returning the name of the most recently connected network
  • Added the power() method

v0.1.1 - 2014/11/24

  • Better documentation formatting for PyPI

v0.1.0 - 2014/11/22

  • Initial release


Pull requests to the develop branch are welcomed!

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for wireless, version 0.2.1
Filename, size File type Python version Upload date Hashes
Filename, size wireless-0.2.1.tar.gz (12.9 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page