From 2cc6fcc5dc7265fb8c4de9d9951557a89c81be7d Mon Sep 17 00:00:00 2001
From: Tobias Witek <tobi@tobi-wan-kenobi.at>
Date: Sun, 16 Feb 2020 13:40:51 +0100
Subject: [PATCH] [doc] Add bumblebee-ctl

fixes #547
---
 README.md | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/README.md b/README.md
index 91a5077..dd95423 100644
--- a/README.md
+++ b/README.md
@@ -188,6 +188,25 @@ For example:
 
 `$ bumblebee-status -p disk.left-click="nautilus {instance}"`
 
+Advanced usage:
+
+You can also "programmatically" trigger click events like this:
+```
+$ bumblebee-ctl --button <button> --id <ID of the widget> --module <name of the module>
+```
+
+For that to work, you need to know the ID of the widget - this can be configured by adding the `<name>.id` parameter - it's a comma-separated list with one entry per widget (for multi-widget modules).
+
+Example:
+
+```
+$ bumblebee-status -m cmus -p cmus.id="prev,main,next,shuffle,repeat"
+# to "simulate" a left-click on "next":
+$ bumblebee-ctl --button left-mouse --module cmus --id next
+```
+
+For a full synopsis, please see `bumblebee-ctl --help`.
+
 ## Errors
 If errors occur, you should see them in the i3bar itself. If that does not work, or you need more information for troubleshooting, you can activate a debug log using the `-d` or `--debug` switch: