Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

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``

Project details

Release history Release notifications

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
text-based-switcher-0.0.2.dev0.tar.gz (5.2 kB) Copy SHA256 hash SHA256 Source None Jul 23, 2015

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page