Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Text-based window switcher for Unity

Project Description


Text-based window switcher for Unity

The visual switcher is very poor at providing context. E.g. the browser window
thumbnails are too small to tell apart.

This switcher shows a list of window titles and allows you to choose one
by typing first character(s) of the sought window. Press return to bring the
window to the front.

All credit goes to the original author, Jacob Vlijm. Thanks!


The script needs ``wmctrl`` and ``xprop``. On Ubuntu:

.. code:: console

$ sudo apt-get install wmctrl x11-utils

Install from PyPI:

.. code:: console

$ sudo pip install text_based_switcher

Test-run it:

.. code:: console

$ list_windows --workspace
$ list_windows --application
$ list_windows --window

If it works, add one or more of the preferred commands to one or more shortcut
keys: choose:
_System Settings_ > _Keyboard_ > _Shortcuts_ > _Custom Shortcuts_.

Click the "+" and add the command.

If you do a local install (``--user`` option), Compiz won't get the right
Python path.
You can fix this by hacking ``sys.path`` in the installed script.


- Add wmctrl or ruamel.emwh as dependency
- Add xprop as dependency
- Don't call commands, use Python libraries
- Write some tests

Developer notes

Please use a virtualenv to maintain this package, but I should not need to say that.

Grab the source from the SCM repository:

.. code:: console

$ python develop
$ pip install text-based-switcher[dev]

If you install

Run the tests (there are no tests yet!):

.. code:: console

$ python test
$ python


Project home page

Source code

Issue tracker

Changes log


- First version by Jacob Vlijm as an answer on AskUbuntu:


- Package creation with ``bobtemplates.gillux``

Release History

This version
History Node


Download Files

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

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(5.2 kB) Copy SHA256 Hash SHA256
Source None Jul 23, 2015

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers