X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=README.md;h=b4740afd23cedb4b5d0c45ca8e3454148cedae20;hb=c78ca22a22eef1f77fc47a8dc3ed5dc2929d1ccc;hp=0f2012e2ffb1f7ff345f748857c01c2c9bf95eb2;hpb=76a229a5e7b71c1c1eb7151556621987dc231dc6;p=deb_pkgs%2Fautorandr.git diff --git a/README.md b/README.md index 0f2012e..b4740af 100644 --- a/README.md +++ b/README.md @@ -77,6 +77,7 @@ you can * Use the [nix package](https://github.com/NixOS/nixpkgs/blob/master/nixos/modules/services/misc/autorandr.nix) on NixOS. +* Use the [SlackBuild](https://slackbuilds.org/repository/14.2/desktop/autorandr/) on Slackware. * Use the automated nightlies generated by the [openSUSE build service](https://build.opensuse.org/package/show/home:phillipberndt/autorandr) for various distributions (RPM and DEB based). @@ -146,9 +147,20 @@ names in your configuration directory to have autorandr use any of them as the default configuration without you having to change the system-wide configuration. -You can store default values for any option in an INI-file in -`~/.config/autorandr/settings.ini` in a section `config`. The most useful -candidate for doing that is `skip-options`, if you need it. +You can store default values for any option in an INI-file located at +`~/.config/autorandr/settings.ini`. In a `config` section, you may place any +default values in the form `option-name=option-argument`. + +A common and effective use of this is to specify default `skip-options`, for +instance skipping the `gamma` setting if using +[`redshift`](https://github.com/jonls/redshift) as a daemon. To implement +the equivalent of `--skip-options gamma`, your `settings.ini` file should look +like this: + +``` +[config] +skip-options=gamma +``` ## Advanced usage @@ -193,17 +205,30 @@ it has a unique name. If you switch back from `docked` to `mobile`, `~/.config/autorandr/postswitch` is executed instead of the `docked` specific `postswitch`. -In these scripts, some of autorandr's state is exposed as environment variables +If you experience issues with xrandr being executed too early after connecting +a new monitor, then you can use a `predetect` script to delay the execution. +Write e.g. `sleep 1` into that file to make autorandr wait a second before +running `xrandr`. + +#### Variables + +Some of autorandr's state is exposed as environment variables prefixed with `AUTORANDR_`, such as: - `AUTORANDR_CURRENT_PROFILE` - `AUTORANDR_CURRENT_PROFILES` - `AUTORANDR_PROFILE_FOLDER` - `AUTORANDR_MONITORS` -If you experience issues with xrandr being executed too early after connecting -a new monitor, then you can use a `predetect` script to delay the execution. -Write e.g. `sleep 1` into that file to make autorandr wait a second before -running `xrandr`. +with the intention that they can be used within the hook scripts. + +For instance, you might display which profile has just been activated by +including the following in a `postswitch` script: +```sh +notify-send -i display "Display profile" "$AUTORANDR_CURRENT_PROFILE" +``` + +The one kink is that during `preswitch`, `AUTORANDR_CURRENT_PROFILE` is +reporting the *upcoming* profile rather than the *current* one. ### Wildcard EDID matching @@ -212,8 +237,29 @@ asterisk to enable wildcard matching: Such EDIDs are matched against connected monitors using the usual file name globbing rules. This can be used to create profiles matching multiple (or any) monitors. +### udev triggers with NVidia cards + +In order for `udev` to detect `drm` events from the native NVidia driver, the +kernel parameter `nvidia-drm.modeset` must be set to 1. For example, add a file +`/etc/modprobe.d/nvidia-drm-modeset.conf`: + +``` +options nvidia_drm modeset=1 +``` + ## Changelog +**autorandr 1.12** +* *2021-12-16* Switch default interpreter to Python 3 + +**autorandr 1.11** +* *2020-05-23* Handle empty sys.executable +* *2020-06-08* Fix Python 2 compatibility +* *2020-10-06* Set group membership of users in batch mode + +**autorandr 1.10.1** +* *2020-05-04* Revert making the launcher the default (fixes #195) + **autorandr 1.10** * *2020-04-23* Fix hook script execution order to match description from readme * *2020-04-11* Handle negative gamma values (fixes #188)