monitordisplay/README.md

Monitor display
===============

Configuration
-------------

Files loaded:

* `/etc/monitordisplay/config.ini`
* `$HOME/.config/monitordisplay/config.ini`
* `$HOME/.monitordisplay`

### Screens

```
[screen:HUMAIN_SCREEN_NAME1]
name=SYSTEM_SCREEN_NAME1
resolutionX=1920
resolutionY=1080

[screen:HUMAIN_SCREEN_NAME2]
name=SYSTEM_SCREEN_NAME2
resolutionX=1024
resolutionY=768

[screen:HUMAIN_SCREEN_NAME3]
name=SYSTEM_SCREEN_NAME2
resolutionX=1920
resolutionY=1080
```

### Modes

```
[mode:MODE_NAME]
config[foo]=HUMAIN_SCREEN_NAME1,HUMAIN_SCREEN_NAME2
config[bar]=HUMAIN_SCREEN_NAME2,HUMAIN_SCREEN_NAME1
primary=HUMAIN_SCREEN_NAME1

[mode:MODE_NAME2]
config[]=HUMAIN_SCREEN_NAME1,HUMAIN_SCREEN_NAME3
config[]=HUMAIN_SCREEN_NAME1,HUMAIN_SCREEN_NAME3
```

Usage
----

```
$ monitordisplay -m MODE_NAME
```

…which equals:

```
$ xrand \
	--output SYSTEM_SCREEN_NAME1 --primary --mode 1920x1080 --pos 0x0 \
	--output SYSTEM_SCREEN_NAME2 --mode 1024x768 --pos 1920x0 \
	--output SYSTEM_SCREEN_NAME3 --off
```

Then you can run:

```
$ monitordisplay -t 
# OR
$ monitordisplay -tbar
```

…which equals:

```
$ xrand \
	--output SYSTEM_SCREEN_NAME2 --mode 1024x768 --pos 0x0 \
	--output SYSTEM_SCREEN_NAME1 --mode 1920x1080 --primary --pos 1024x0 \
	--output SYSTEM_SCREEN_NAME3 --off
```

You can remove the parameter `--off` with `-s`:

```
$ monitordisplay -m MODE_NAME -s
```

It equals:

```
$ xrand \
	--output SYSTEM_SCREEN_NAME1 --primary --mode 1920x1080 --pos 0x0 \
	--output SYSTEM_SCREEN_NAME2 --mode 1024x768 --pos 1920x0
```