From 625518acd7c62acde2d6d150272fa17a45eb3ce9 Mon Sep 17 00:00:00 2001
From: Mart Lubbers
Date: Sun, 17 Jan 2016 18:05:11 +0100
Subject: Add support for custom commands

Add the cmd option in the config that runs a shell command.
---
 man/i3status.man | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

(limited to 'man')

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
-- 
cgit v1.2.3