herbstclient - sends commands to a running herbstluftwm instance via X
herbstclient [OPTIONS] COMMAND [ARGS ...]
herbstclient [OPTIONS] [--wait|--idle]
Sends a COMMAND with its (optional) arguments ARGS to a running
herbstluftwm(1) instance via Xlib. If COMMAND has an output, it
is printed by herbstclient. If output does not end with a newline, then
a newline is added to improve readability.
See herbstluftwm(1) for a list of available COMMANDs
and their ARGS.
If --wait or --idle is passed, then it waits for
hooks from herbstluftwm. The hook is printed, if it matches the
optional FILTER. FILTERs are regular expressions. For a list
of available hooks see herbstluftwm(1).
Do not print a newline if output does not end with a
Use the null character as delimiter between the output of
When using -i or -w, only print the last
argument of the hook.
Wait for hooks instead of executing commands.
Same as --idle but exit after first --count
-c, --count COUNT
Let --wait exit after COUNT hooks were
received and printed. The default of COUNT is 1.
Do not print error messages if herbstclient cannot
connect to the running herbstluftwm instance.
Print the herbstclient version. To get the herbstluftwm
version, use herbstclient version.
Print the herbstclient usage with its command line
Returns the exit status of the COMMAND execution in
It waits endlessly for a response from herbstluftwm (there is no timeout
See the herbstluftwm distribution BUGS file.
Feel free to join the IRC channel #herbstluftwm on
herbstclient was written by Thorsten Wißmann. All contributors are
listed in the herbstluftwm distribution AUTHORS file.
Github page: http://github.com/herbstluftwm/herbstluftwm
Patch submission and bug reporting:
Copyright 2011-2014 Thorsten Wißmann. All rights reserved.
This software is licensed under the "Simplified BSD
License". See LICENSE for details.