Extend a HIDPI screen to a normal DPI external display
Project description
xrandr-extend
Extend a HIDPI screen to a normal DPI external display. This command line tool implements various solutions described in the HIDPI Arch Linux wiki page.
-
Free software: GNU General Public License v3
-
Documentation: https://xrandr-extend.readthedocs.io.
Installation
pip install xrandr-extend --user
or alternatively
pip install -e "git+https://github.com/ashwinvis/xrandr-extend.git#egg=xrandr_extend" --user
Configuration
python -m xrandr_extend.config
This creates a file ~/.config/xrandr-extend.cfg
which looks like this:
[provider:modesetting]
primary = eDP-1
hdmi = HDMI-1
vga = DP-1
[provider:intel]
primary = eDP1
hdmi = HDMI1
vga = DP1
[resolutions]
primary = (3200, 1800)
hdmi = (1920, 1080)
vga = (1920, 1200)
The first few sections have the name in the format [provider:display_driver]
.
Run xrandr --listproviders
to find what your system has. The values in this
section should be given as alias = monitor_name
, as in the output of
xrandr --listmonitors
command. You may even remove existing sections and
add more sections for your display driver.
Each line in the [resolutions]
section signifies a resolution profile in
the format alias = [width_in_pixels, height_in_pixels]
. The profile
primary
should contain the resolution of your built-in display. You may edit
or remove the remaining values hdmi
and vga
.
Quick reference
usage: xrandr-extend [-h] [-p PRI_RES PRI_RES] [-e EXT_RES EXT_RES] [-m] [-n]
[-o] [-s] [-d]
profile
Extend a HIDPI screen to a normal DPI external display
positional arguments:
profile Use preset external resolution profiles (available:
['hdmi', 'vga']).
optional arguments:
-h, --help show this help message and exit
-p PRI_RES PRI_RES, --pri-res PRI_RES PRI_RES
Modify preset resolution of primary display (default
[3200, 1800])
-e EXT_RES EXT_RES, --ext-res EXT_RES EXT_RES
Modify preset resolution of ext. display (default
based on profile)
-m, --mirror Mirror the ext. display
-n, --pan pan the position of ext. display
-o, --only extend and use only ext. display
-s, --pos set the position of ext. display explicitly
-d, --dry-run Preview command without executing it
Examples
--------
# Default option requires only the scaling factors and display name
$ xrandr-extend --dry-run vga
$ xrandr-extend vga
$ xrandr-extend hdmi
# Other options to extend the display
$ xrandr-extend --pan hdmi
$ xrandr-extend --only hdmi
$ xrandr-extend -e 1024 768 -n vga # Pan with custom external resolution
Credits
This package was created with Cookiecutter and the ashwinvis/cookiecutter-pypackage project template.
History
0.0.4 (2019-05-16)
- Flicker correction
- Use cookiecutter to generate src layout
0.0.3
- Deploy to PyPI
- Reorganize as a package and allow for configuration
- Use
pkg_resources
to finddefault.cfg
0.0.2
- Simpler defaults which uses only scaling factors
- Parse args only inside
__main__
and do not run any commands during dry run - Less bugs
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for xrandr_extend-0.1.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3847a02c2d85a3b6d3203ae2642df27469d775e82509f7829923593cd6903abe |
|
MD5 | 6a3bcf69a721cc8b807c58460659f570 |
|
BLAKE2b-256 | c962a48d91bc5dde6659cca453f6acd515c6ccbed4ee4062daf73d844b6ae6eb |