Home / ubuntu / Questions / 1060170
Accepted
Tim
Asked: 2018-07-28 14:44:47 +0800 CST

xdotool: what are "class" and "classname" for a window?

  • 772

In light of https://unix.stackexchange.com/a/254854/674 and https://unix.stackexchange.com/questions/458895/how-can-i-bring-a-background-gui-job-to-the-front-of-my-desktop, there is an example from manpage of xdotool

# Activate google-chrome when you move the mouse to the bottom-left corner: 
xdotool behave_screen_edge bottom-left search --class google-chrome windowactivate

The manpage says

--class Match against the window class.

--classname Match against the window classname.

What are "class" and "classname"?

What possible values do they have?

How can I find out the class and classname of a window?

Thanks.

xorg xdotool

1 Answers

  1. Best Answer

    Under X11 windows have XWindowdAttributes structure and XClassHint structures properties from which applications get information about windows. Specifically the last one is responsible for the WM_CLASS property, two comma-separated strings, which can be seen easily via xprop command. For instance, Chrome has

    WM_CLASS(STRING) = "google-chrome", "Google-chrome"

    These two are documented as:

    • A string that names the particular instance of the application to which the client that owns this window belongs. ...
    • A string that names the general class of applications to which the client that owns this window belongs. Resources that are specified by class apply to all applications that have the same class name....

    Thus, for example Hangouts extension for Chrome, has same class name, but different instance name:

    $ xprop | grep 'CLASS'
WM_CLASS(STRING) = "crx_nckgahadagoaajjgafhacjanaoiihapd", "Google-chrome"

    This allows tools such as xdotool search all windows of particular application type, or specific window instance. For instance, this also can be useful property for something like docks that group windows under the same icon of an application.

    In particular for xdotool, classname corresponds with the first string, and class corresponds the second string. In my example with Chrome and Hangouts apps:

    $ xdotool search -classname crx_nckgahadagoaajjgafhacjanaoiihapd
96469129

$ xdotool search -class Google-chrome
96469069
109051905
109051907
96468993
96469129
109051912
109051924

    This also can be apparent from looking at the source code. Let's focus on classname for example. In the cmd_search.c we have a search struct built up, which has a search mask property(lines 171 to 173).

    This gets passed to xdo_search_windows function defined in xdo_search.c , which in turn calls check_window_match, that in turn goes to _xdo_match_window_classname, which finally ends up retrieving both structures mentioned in the beginning of this answer with the standard Xlib functions XGetWindowAttributes and XGetClassHint.

    Side note: Gtk apps apparently always create a small parent window with a child window, which means you may get confusing results when searching for a specific window.

    • 33