monitordisplay/README.md
2017-08-15 21:30:12 +02:00

91 lines
1.5 KiB
Markdown

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
```