Feature/relative multimonitor position

Makefile

@@ -1,7 +1,7 @@
 PROGRAM = xob
 MANPAGE = doc/xob.1
 SYSCONF = styles.cfg
-LIBS    = x11 libconfig
+LIBS    = x11 libconfig xrandr
 SOURCES = src/conf.c src/display.c src/main.c
 
 # Feature: alpha channel (transparency)

README.md

@@ -155,6 +155,7 @@ When starting, xob looks for the configuration file in the following order:
 Consult the man page for detailed information about the configuration file and the available options. The following `styles.cfg` defines a single style called "default" that showcases all the possible options set to the default values. The configuration file may contain additional styles to choose among using the **-s** argument.
 
     default = {
+        monitor   = "combined";
         x         = {relative = 1; offset = -48;};
         y         = {relative = 0.5; offset = 0;};
         length    = {relative = 0.3; offset = 0;};
@@ -315,9 +316,10 @@ There is no support for panel integration. You can however use absolute position
 
 > "How about multiple monitors?"
 
-xob works well under multihead setups. The `x`, `y`, and `length` style options refer to the combined screen surface. By default the bar is vertical near the right edge of the rightmost monitor. In vertical layouts, you may prefer to switch the bar to horizontal mode as follows to avoid splits.
+xob works well under multihead setups. The default orientation of bar is `vertical` and is positioned at the right edge of the screen surface. By default, `x`, `y`, and `length` style options refer to the combined screen surface, but you can specify a monitor for the bar, for example you can set option `monitor = "HDMI-1"` to show the bar only on `HDMI-1` (use `xrandr` command to get monitors names). In vertical layouts, you may prefer to switch the bar to horizontal mode as follows to avoid splits.
 
     horizontal = {
+        monitor   = "combined";
         x         = {relative = 0.5; offset = 0;};
         y         = {relative = 1; offset = -48;};
         orientation = "horizontal";

doc/xob.1

@@ -169,6 +169,13 @@ In the following, a dot \[lq].\[rq] means \[lq]suboption\[rq].
 For instance \[lq]color.normal.fg\[rq] means \[lq]The suboption fg of
 the suboption normal of option color\[rq].
 .TP
+\f[B]monitor\f[R] \f[I]\[lq]output_name\[rq] | \[lq]relative_focus\[rq] | \[lq]relative_pointer\[rq] | \[lq]combined\[rq]\f[R] (default: combined)
+Output monitor for the bar, use \f[I]xrandr\f[R] command to get monitors names.
+Use \f[I]relative_focus\f[R] to show the bar on the monitor with a focused window.
+Use \f[I]relative_pointer\f[R] to show the bar on the monitor with a mouse
+pointer. Use \f[I]combined\f[R] to show the bar on the combined surface of all
+monitors. The option is case-sensitive.
+.TP
 \f[B]orientation\f[R] \f[I]\[lq]horizontal\[rq] | \[lq]vertical\[rq]\f[R] (default: vertical)
 Orientation of the bar which either fills up from left to right
 (\[lq]horizontal\[rq]) or bottom to top (\[lq]vertical\[rq]).
@@ -301,6 +308,7 @@ backlight = {
 .nf
 \f[C]
 default = {
+    monitor   = \[dq]combined\[dq];
     x         = {relative = 1; offset = -48;};
     y         = {relative = 0.5; offset = 0;};
     length    = {relative = 0.3; offset = 0;};
@@ -367,17 +375,17 @@ situations.
 \[lq]How to set up xob with multiple monitors?\[rq]
 .RE
 .PP
-xob works well under multihead setups but there is no easy way to
-configure the position of the bar for now.
-For example, in a dual monitor setup with the default configuration, the
-horizontal centering is not local to one of the two monitors.
-It is global.
-The bar might be split in two: one part on each screen.
-Stick to a corner or use absolute positioning.
-If you want an xob instance to be centered (horizontally) on the
-far-right monitor, set \f[I]x.relative\f[R] to 1.0 (anchored on the far
-right) and the \f[I]x.offset\f[R] to minus half the width of that
-screen.
+xob works well under multihead setups, use option \f[I]monitor\f[R] to
+specify one. By default xob use \f[I]combined\f[R] for the option. It means
+that in a dual monitor setup with the default configuration,
+the horizontal centering is not local to one of the two monitors.
+It is global. The bar might be split in two: one part on each screen.
+If you want an xob instance to be centered (horizontally) on the specific
+monitor, set \f[I]monitor\f[R] option to your monitor output,
+for example \f[I]monitor = \[lq]HDMI-1\[rq]\f[R] and set options
+\f[I]x.relative\f[R] and \f[I]y.relative\f[R] relative to the monitor.
+To get monitors output name you can use \f[I]xrandr --listmonitors\f[R]
+command in your terminal.
 .SH CONTRIBUTIONS
 .PP
 Feedback and contributions are welcome.

doc/xob.md

@@ -104,6 +104,9 @@ Options can be grouped together inside curly brackets. Some options expect a gro
 
 In the following, a dot "." means "suboption". For instance "color.normal.fg" means "The suboption fg of the suboption normal of option color".
 
+**monitor** *"output_name" | "relative_focus" | "relative_pointer" | "combined"* (default: combined)
+:   Output monitor for the bar, use `xrandr` command to get monitors names. Use "relative_focus" to show the bar on the monitor with a focused window. Use "relative_pointer" to show the bar on the monitor with a mouse pointer. Use "combined" to show the bar on the combined surface of all monitors. The option is case-sensitive.
+
 **orientation** *"horizontal" | "vertical"* (default: vertical)
 :   Orientation of the bar which either fills up from left to right ("horizontal") or bottom to top ("vertical").
 
@@ -156,7 +159,6 @@ Each of the following have three suboptions ".fg", ".bg", and ".border" correspo
 
 
 ## STYLES
-
 All the options described above must be encompassed inside a style specification. A style consists of a group of all or some of the options described above. The name of the style is the name of an option at the root level of the configuration file. When an option is missing from a style, the default values are used instead. A configuration file may specify several styles (at least 1) to choose using the **-s** argument.
 
 This example configuration file provides two styles "volume" and "backlight". Instances of xog launched with **-s volume** and **-s backlight** will look according to the corresponding style.
@@ -194,6 +196,7 @@ This example configuration file provides two styles "volume" and "backlight". In
 ## DEFAULT CONFIGURATION FILE
 
     default = {
+        monitor   = "combined";
         x         = {relative = 1; offset = -48;};
         y         = {relative = 0.5; offset = 0;};
         length    = {relative = 0.3; offset = 0;};
@@ -242,7 +245,7 @@ There is no support for panel integration. You can however use absolute position
 
 > "How to set up xob with multiple monitors?"
 
-xob works well under multihead setups but there is no easy way to configure the position of the bar for now. For example, in a dual monitor setup with the default configuration, the horizontal centering is not local to one of the two monitors. It is global. The bar might be split in two: one part on each screen. Stick to a corner or use absolute positioning. If you want an xob instance to be centered (horizontally) on the far-right monitor, set *x.relative* to 1.0 (anchored on the far right) and the *x.offset* to minus half the width of that screen.
+xob works well under multihead setups, use option `monitor` to specify one. By default xob use `combined` for the option. It means that in a dual monitor setup with the default configuration, the horizontal centering is not local to one of the two monitors. It is global. The bar might be split in two: one part on each screen. If you want an xob instance to be centered (horizontally) on the specific monitor, set `monitor` option to your monitor output, for example `monitor = "HDMI-1"` and set options `x.relative` and `y.relative` relative to the monitor. To get monitors output name you can use `xrandr --listmonitors` command in your terminal.
 
 # CONTRIBUTIONS
 

src/conf.c

@@ -229,6 +229,22 @@ static int config_setting_lookup_orientation(const config_setting_t *setting,
     return success_status;
 }
 
+static int config_setting_lookup_monitor(const config_setting_t *setting,
+                                         const char *name, char *monitorvalue)
+{
+    const char *stringvalue;
+
+    if (config_setting_lookup_string(setting, name, &stringvalue))
+    {
+        strncpy(monitorvalue, stringvalue, LNAME_MONITOR);
+    }
+    else
+    {
+        fprintf(stderr, "Error: No style %s.\n", name);
+    }
+    return CONFIG_TRUE;
+}
+
 Style parse_style_config(FILE *file, const char *stylename, Style default_style)
 {
     config_t config;
@@ -243,6 +259,7 @@ Style parse_style_config(FILE *file, const char *stylename, Style default_style)
         xob_config = config_lookup(&config, stylename);
         if (xob_config != NULL)
         {
+            config_setting_lookup_monitor(xob_config, "monitor", style.monitor);
             config_setting_lookup_int(xob_config, "thickness",
                                       &style.thickness);
             config_setting_lookup_int(xob_config, "border", &style.border);

src/conf.h

@@ -20,6 +20,12 @@
 
 #include <stdio.h>
 
+#define MONITOR_RELATIVE_FOCUS "relative_focus"
+#define MONITOR_RELATIVE_POINTER "relative_pointer"
+#define MONITOR_COMBINED "combined"
+
+#define LNAME_MONITOR 17
+
 typedef struct
 {
     unsigned char red;
@@ -63,6 +69,7 @@ typedef enum
 
 typedef struct
 {
+    char monitor[LNAME_MONITOR];
     Dim x;
     Dim y;
     Dim length;
@@ -77,6 +84,7 @@ typedef struct
 
 /* clang-format off */
 #define DEFAULT_CONFIGURATION (Style) {\
+        .monitor = MONITOR_COMBINED,\
         .x =\
         {\
             .rel = 1.0,\