Qtile

Getting Started

  • Installation
  • Wayland
  • Troubleshooting
  • Entry points

Configuration

  • Default Config File
  • The config file
  • Built-in Layouts
  • Built-in Widgets
  • Built-in Hooks
  • Built-in Extensions
  • Keybindings in images
  • Window stacking

Scripting

  • Architecture
    • The Command Graph
    • Navigating the command graph
    • Command graph development
  • Interfaces
  • Commands API

Hacking

  • Hacking on Qtile
  • Contributing

Miscellaneous

  • Frequently Asked Questions
  • How to create a widget
  • How to create a layout
  • Using git
  • License
  • Changelog
Qtile
  • Architecture
  • Navigating the command graph
  • View page source

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"
(Note: 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.)

No

c.screen.bar["bottom"]

group

Name string

Yes

c.group["one"]
c.group

layout

Integer index

Yes

c.layout[2]
c.layout

screen

Integer index

Yes

c.screen[1]
c.screen

widget

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

No

c.widget["textbox"]

window

Integer window ID

Yes

c.window[123456]
c.window

core

No

n/a

c.core
Previous Next

© Copyright 2008-2021, Aldo Cortesi and contributers.

Built with Sphinx using a theme provided by Read the Docs.