Unix & Linux Stack Exchange is a question and answer site for users of Linux, FreeBSD and other Un*x-like operating systems. Join them; it only takes a minute:

Sign up
Here's how it works:
  1. Anybody can ask a question
  2. Anybody can answer
  3. The best answers are voted up and rise to the top

I've been digging around in the API documentation, and I'm having limited sucess switching tags from within awesome-client. Basically, I can switch tags with:


But that is relative not absolute. From looking in my rc.lua, looks like what I need is:

local screen = mouse.screen

But I get the following error instead:

attempt to index field '?' (a nil value)

What is the most concise way of changing tags (preferably one command) to an absolute tag number. Alternatively, how can I find the current tag?

share|improve this question

After a lot of trial and error this is what I came up with:


This will switch to the third tag.

share|improve this answer
Only on the first screen, even if the focus is on the second screen. – l0b0 Jun 25 '13 at 8:38
The first argument to tags is the screen number. – Kristoffer Ryhl Jul 19 '15 at 21:53

Your Answer


By posting your answer, you agree to the privacy policy and terms of service.

Not the answer you're looking for? Browse other questions tagged or ask your own question.