Add support for custom commandsHEADmaster

Add the cmd option in the config that runs a shell command.

1 files changed, 16 insertions, 0 deletions

diff --git a/man/i3status.man b/man/i3status.man
index a36c853..da54d37 100644
--- a/man/i3status.man
+++ b/man/i3status.man
@@ -652,6 +652,22 @@ If the file is not found "no file" will be printed, if the file can't be read
 
 *Example Max_characters*: 255
 
+=== Custom command
+
+Outputs the first line of the stdout of the given shell command passed to *sh
+-c*. Note that the last newline is automatically removed.
+
+*Example order*: +cmd quodlibet+
+
+*Example cmd*: +pkill -0 quodlibet && quodlibet --print-playing+
+
+*Example configuration*:
+-------------------------------------------------------------
+cmd quodlibet {
+	cmd = "pkill -0 quodlibet && quodlibet --print-playing"
+}
+-------------------------------------------------------------
+
 == Universal module options
 
 When using the i3bar output format, there are a few additional options that