1=pod
2
3=head1 NAME
4
5 icewm-menu-xrandr - IceWM menu provider for multi-monitor setup shortcuts
6
7=head1 SYNOPSIS
8
9B<icewm-menu-xrandr>
10
11=head1 DESCRIPTION
12
13B<icewm-menu-xrandr> is a helper to manage multi-screen configurations
14in a semi-automated way. It is a regular icewm menu generator which dynamically
15detects the available xrandr screens (i.e. connected monitors) and
16creates menu entries that call the xrandr command to setup this
17configuration.
18
19Optionally, the contents of the generated configurations can be accessed
20on-the-fly through a "quick-switch" style menu which pops up upon
21pressing Super-P key binding (or a manually configured key, see
22L<icewm-keys(5)> for the configuration of B<switchkey> directive).
23
24=head1 OPTIONS
25
26=over
27
28=item B<--max>
29
30Instead of using the preferred mode and refresh rate of each monitor
31(xrandr's C<--auto> option), identify and use the modes with the highest
32bandwidth usage (i.e. usually the ones with the highest resolution and
33refresh rate). This behaviour is also enabled by creating the file
34C<$HOME/.cache/xrandrmenu.max> which would also effect the monitor
35quick-switch menu.
36
37=back
38
39=head1 SEE ALSO
40
41L<icewm(1)>,
42L<xrandr(1)>.
43
44=head1 BUGS
45
46Please report bugs at L<https://github.com/bbidulock/icewm/issues>.
47
48=head1 AUTHOR
49
50Eduard Bloch L<mailto:edi@gmx.de>.
51
52=head1 LICENSE
53
54B<icewm-menu-xrandr> is licensed under the Simplified BSD License.
55B<IceWM> is licensed under the GNU Library General Public License.
56See the F<COPYING> file in the distribution.
57
58=cut
59
60# vim: set sw=4 tw=72 nocin spell spelllang=en_ca:
61