aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: 4daf8edd51067234042f825f97b9fa6b097e23a5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
# README for arandr-trayicon
A system tray icon for easily changing monitor settings.

## Upstream
This project's upstream is at <https://bgstack15.ddns.net/cgit/arandr-trayicon/>

## Alternatives
Xfce4-settings includes a program, **xfce4-display-settings**, which is really nice but needs more components of xfce4 than I was willing to research and install. A full Xfce4 suite will handle it.

## Reason for existence
I wanted a lightweight tray icon that lets a user easily change which displays are active. Arandr would obviously be very useful but some users don't even want to use that.

## Using
Run `arandr-trayicon` in your graphical session, probably at startup. For fluxbox, that would be in `~/.fluxbox/startup`.

## Configuring
The application examines all the arandr-generated `~/.screenlayout/*.sh` scripts and also admin-set ones at `/etc/screenlayouts/*.sh`. The filenames are displayed as menu entries on the system tray. A good plan is for an admin to install the package/script, and then define for the system some basic scripts in `/etc/screenlayouts/`, including:

	laptop-only.sh
	extend-desktop.sh
	hdmi-only.sh
	mirror-displays.sh

## Dependencies

* xrandr
* arandr for setup of initial display-settings scripts

## Building
If applicable, or more complicated than `make && make install`.


## Improvements

* Still need packaging recipes

## References
bgstack15