Skip to main content

Extend a HIDPI screen to a normal DPI external display

Project description


image python versions image

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



pip install xrandr-extend --user

or alternatively use pipx:

pipx install xrandr-extend


python -m xrandr_extend.config

This creates a file ~/.config/xrandr-extend.cfg which looks like this:

primary = eDP-1
hdmi = HDMI-1
vga = DP-1

primary = eDP1
hdmi = HDMI1
vga = DP1

primary = 3200, 1800
hdmi = 1920, 1080
vga = 1920, 1200

# [scaling]
# primary = 1.0
# hdmi = 2.0
# vga = 2.0

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 profile = 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 profile = [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.

The [scaling] section contains the scale factors, which if uncommented, overrides the scale factor computed from the resolutions.

Quick reference

usage: xrandr-extend [-h] [-p PRI_RES PRI_RES] [-e EXT_RES EXT_RES]
                     [-x EXT_SCALE] [-m] [-n] [-o] [-s] [-d]

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
                        Modify preset resolution of primary display (default:
                        3200, 1800)
                        Modify preset resolution of external display (default
                        based on profile)
  -x EXT_SCALE, --ext-scale EXT_SCALE
                        Sets the scale factor of external display (DPI of
                        primary display / DPI of external display), overriding
                        scale factor estimation from resolutions
  -m, --mirror          Mirror the external display
  -n, --pan             Pan the position of external display
  -o, --only            Extend and use only external display
  -s, --pos             Set the position of external display explicitly
  -d, --dry-run         Preview command without executing it

# Built-in options or user-configured options are used when only the display
# profile is mentioned

$ 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
$ xrandr-extend -x 2.0 hdmi         # Custom scale factor


This package was created with Cookiecutter and the ashwinvis/cookiecutter-pypackage project template.


0.2.0 (2019-07-15)

  • New optional option -x or --ext-scale for the scaling factor (PR #4, #5)

0.1.1 (2019-05-16)

  • Correct command xrandr_extend -> xrandr-extend

0.1.0 (2019-05-16)

  • Flicker correction
  • Use cookiecutter to generate src layout


  • Deploy to PyPI
  • Reorganize as a package and allow for configuration
  • Use pkg_resources to find default.cfg


  • 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.

Files for xrandr-extend, version 0.2.0
Filename, size File type Python version Upload date Hashes
Filename, size xrandr_extend-0.2.0-py2.py3-none-any.whl (8.5 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size xrandr_extend-0.2.0.tar.gz (17.9 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page