Skip to content
Dynamic tagging library for awesome window manager
Branch: master
Clone or download
bioe007 Merge pull request #19 from freehaha/master
client-to-tag binding example doesn't work properly
Latest commit b12b66e Feb 20, 2013
Type Name Latest commit message Commit time
Failed to load latest commit information. Basic documentation for shifty. Aug 24, 2011
example.rc.lua make client-to-tag binding example work properly Feb 20, 2013
init.lua Merge pull request #17 from mmawdsley/master Feb 20, 2013


Shifty is an Awesome 3 extension that implements dynamic tagging.

It also implements fine client matching configuration allowing you to be the master of your desktop.

Here are a few ways of how shifty makes awesome awesomer:

  • on-the-fly tag creation and disposal
  • advanced client matching
  • easy moving of clients between tags
  • tag add/rename prompt in taglist (with completion)
  • reordering tags and configurable positioning
  • tag name guessing, automagic no-config client grouping
  • customizable keybindings per client and tag
  • simple yet powerful configuration


  1. Go to configuration directory, usually ~/.config/awesome

  2. Clone repository:

    git clone shifty

  3. Move the example rc.lua file into your configuration directory.

    cp shifty/example.rc.lua rc.lua

  4. Restart awesome and enjoy.

There are many configuration options for shifty, the example.rc.lua is provided merely as a starting point. The most important variables are the tables:

  • shifty.config.tags = {}
    • Sets predefined tags, which are not necessarily initialized.
  • shifty.config.apps = {}
    • How to handle certain applications.
  • shifty.config.defaults = {}
    • Fallback values used when a preset is not found in the first two configuration tables.

But for each of these there are tons of shifty variables and settings, its easiest to check out the wiki page or the module itself.

In the example.rc.lua searching for shifty in your editor can also help to make sense of these.


Help is best found in this order:

  1. Web search, e.g. Google is your friend...
  2. #awesome on is good for immediate aid, especially with configuration questions and such.
  3. The awesome users mailing list
  4. Messaging through github
  5. Directly e-mailing the author
    • Please use this as a last resort, not that I mind, but the other formats allow others to benefit as well.


Report bugs at the github repo. Please include at least the current versions of awesome and shifty, as well as distribution.



Current awesome wm license or if thats not defined, GPLv2.

You can’t perform that action at this time.