]> git.donarmstrong.com Git - deb_pkgs/autorandr.git/blob - debian/autorandr.1
add initial work on autorandr packaging
[deb_pkgs/autorandr.git] / debian / autorandr.1
1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.4.
2 .TH AUTORANDR.PY "1" "October 2017" "autorandr.py 1.2" "Automatically change screen layout"
3 .SH NAME
4 autorandr.py \- autorandr
5 .SH SYNOPSIS
6 .B autorandr
7 [\fI\,options\/\fR]
8 .SH DESCRIPTION
9 \fB\-h\fR, \fB\-\-help\fR              get this small help
10 \fB\-c\fR, \fB\-\-change\fR            reload current setup
11 \fB\-s\fR, \fB\-\-save\fR <profile>    save your current setup to profile <profile>
12 \fB\-r\fR, \fB\-\-remove\fR <profile>  remove profile <profile>
13 \fB\-l\fR, \fB\-\-load\fR <profile>    load profile <profile>
14 \fB\-d\fR, \fB\-\-default\fR <profile> make profile <profile> the default profile
15 \fB\-\-skip\-options\fR <option> comma separated list of xrandr arguments (e.g. "gamma")
16 .IP
17 to skip both in detecting changes and applying a profile
18 .PP
19 \fB\-\-force\fR                 force (re)loading of a profile
20 \fB\-\-fingerprint\fR           fingerprint your current hardware setup
21 \fB\-\-config\fR                dump your current xrandr setup
22 \fB\-\-dry\-run\fR               don't change anything, only print the xrandr commands
23 \fB\-\-debug\fR                 enable verbose output
24 \fB\-\-batch\fR                 run autorandr for all users with active X11 sessions
25 .IP
26 To prevent a profile from being loaded, place a script called "block" in its
27 directory. The script is evaluated before the screen setup is inspected, and
28 in case of it returning a value of 0 the profile is skipped. This can be used
29 to query the status of a docking station you are about to leave.
30 .IP
31 If no suitable profile can be identified, the current configuration is kept.
32 To change this behaviour and switch to a fallback configuration, specify
33 \fB\-\-default\fR <profile>.
34 .IP
35 Another script called "postswitch" can be placed in the directory
36 ~/.config/autorandr (or ~/.autorandr if you have an old installation) as well
37 as in any profile directories: The scripts are executed after a mode switch
38 has taken place and can notify window managers.
39 .IP
40 The following virtual configurations are available:
41 .TP
42 common
43 Clone all connected outputs at the largest common resolution
44 .TP
45 clone\-largest
46 Clone all connected outputs with the largest resolution (scaled down if necessary)
47 .TP
48 horizontal
49 Stack all connected outputs horizontally at their largest resolution
50 .TP
51 vertical
52 Stack all connected outputs vertically at their largest resolution
53 .SH "SEE ALSO"
54 The full documentation for
55 .B autorandr.py
56 is maintained as a Texinfo manual.  If the
57 .B info
58 and
59 .B autorandr.py
60 programs are properly installed at your site, the command
61 .IP
62 .B info autorandr.py
63 .PP
64 should give you access to the complete manual.