=pod

=head1 NAME

 icewm-menu-xrandr - IceWM menu provider for multi-monitor setup shortcuts

=head1 SYNOPSIS

B<icewm-menu-xrandr>

=head1 DESCRIPTION

B<icewm-menu-xrandr> is a helper to manage multi-screen configurations
in a semi-automated way. It is a regular icewm menu generator which dynamically
detects the available xrandr screens (i.e. connected monitors) and
creates menu entries that call the xrandr command to setup this
configuration.

Optionally, the contents of the generated configurations can be accessed
on-the-fly through a "quick-switch" style menu which pops up upon
pressing Super-P key binding (or a manually configured key, see
L<icewm-keys(5)> for the configuration of B<switchkey> directive).

=head1 OPTIONS

=over

=item B<--max>

Instead of using the preferred mode and refresh rate of each monitor
(xrandr's C<--auto> option), identify and use the modes with the highest
bandwidth usage (i.e. usually the ones with the highest resolution and
refresh rate). This behaviour is also enabled by creating the file
C<$HOME/.cache/xrandrmenu.max> which would also effect the monitor
quick-switch menu.

=back

=head1 SEE ALSO

L<icewm(1)>,
L<xrandr(1)>.

=head1 BUGS

Please report bugs at L<https://github.com/bbidulock/icewm/issues>.

=head1 AUTHOR

Eduard Bloch L<mailto:edi@gmx.de>.

=head1 LICENSE

B<icewm-menu-xrandr> is licensed under the Simplified BSD License.
B<IceWM> is licensed under the GNU Library General Public License.
See the F<COPYING> file in the distribution.

=cut

# vim: set sw=4 tw=72 nocin spell spelllang=en_ca:
