mirror of
https://github.com/gryf/pyrandr.git
synced 2025-12-30 22:22:26 +01:00
56 lines
1.2 KiB
ReStructuredText
56 lines
1.2 KiB
ReStructuredText
pyrandr
|
|
=======
|
|
|
|
``pyrandr`` is a small wrapper on ``xrandr`` to provide most common usage as
|
|
simple as possible.
|
|
|
|
Requirements
|
|
------------
|
|
|
|
``pyrandr`` doesn't require any other thing than Python (any version starting
|
|
from Python 2.7) and ``xrandr`` command line tool.
|
|
|
|
Installation
|
|
------------
|
|
|
|
Just make ``pyrandr.py`` executable and drop somewhere in your ``$PATH``.
|
|
|
|
Usage
|
|
-----
|
|
|
|
Invocation is simple, executing the script:
|
|
|
|
.. code:: shell-session
|
|
|
|
user@localhost $ pyrandr.py
|
|
|
|
should list all mailable outputs for your display device(s).
|
|
|
|
There is a mode for turning all displays at once called panic mode:
|
|
|
|
.. code:: shell-session
|
|
|
|
user@localhost $ pyrandr.py -a
|
|
|
|
And most interesting part is ability to turn on selected outputs side by side
|
|
in horizontal layout, for example:
|
|
|
|
.. code:: shell-session
|
|
|
|
user@localhost $ pyrandr.py -p VGA1 VGA2 VGA1
|
|
|
|
Will switch off all other outputs, but ``VGA1`` and ``VGA2``, and place those
|
|
outputs in order ``VGA1`` on the right of ``VGA2``. The option ``-p`` will set
|
|
``VGA1`` as the primary output.
|
|
|
|
Use ``--help`` to see all the other options:
|
|
|
|
.. code:: shell-session
|
|
|
|
(myenv)user@localhost ~/mylogs $ pyrandr.py -h
|
|
|
|
License
|
|
-------
|
|
|
|
This work is licensed on 3-clause BSD license. See LICENSE file for details.
|