Navigating the command graph

As noted previously, some objects require a selector to ensure that the correct object is selected, while other nodes provide a default object without a selector.

The table below shows what selectors are required for the diferent nodes and whether the selector is optional (i.e. if it can be omitted to select the default object).

Object	Key	Optional?	Example
bar	"top", "bottom"1	No	c.screen.bar["bottom"]
group	Name string	Yes	c.group["one"] c.group
[layout][libqtile.layout]	Integer index	Yes	c.layout[2] c.layout
[screen][libqtile.screen]	Integer index	Yes	c.screen[1] c.screen
widget	Widget name2	No	c.widget["textbox"]
[window][libqtile.window]	Integer window ID	Yes	c.window[123456] c.window
[core][libqtile.backend]	No	n/a	c.core

---

1. If accessing this node from the root, users on multi-monitor setups may wish to navigate via a screen node to ensure that they select the correct object. ↩

2. This is usually the name of the widget class in lower case but can be set by passing the name parameter to the widget. ↩