Skip to main content

This is a unifying wrapper around xrandr and swaymsg to control your monitors/outputs,

Project description

This is a unifying wrapper around xrandr and swaymsg to control your monitors/outputs, mainly intended for setups where only one or two monitors are enabled at the same time.

xrandr's syntax is too verbose for direct usage and too explicit to use it in an i3/sway config file. This script tries to make things easier.

Examples

  • crandr cycles through all connected monitors.
  • crandr toggle toggles between the internal monitor and an external monitor.
  • crandr extend left turns on another monitor and positions it left of the currently enabled monitor.
  • crandr mirror turns on another monitor and mirrors the displayed content. If the monitors have different resolutions the internal monitor is scaled to match the resolution of the external monitor. If you want another monitor to be scaled you can specify the monitor which should not be scaled with --original. (Sway does not support mirroring yet, see this issue.)
  • crandr scale .8 if everything is displayed too small and you want to make things bigger.
  • crandr rotate left rotates the content of the currently enabled monitor so that the top of the content is at the left edge of the monitor.
  • crandr reset external enables the external monitor with default rotation and scaling and turns off all other monitors (the internal monitor).
  • crandr list to list all connected monitors.

Help

For more information see

  • crandr --help
  • crandr cycle --help
  • crandr toggle --help
  • crandr extend --help
  • crandr mirror --help
  • crandr scale --help
  • crandr rotate --help
  • crandr reset --help
  • crandr list --help

Files

crandr creates two files:

  • a config file ~/.config/crandr/config, when running crandr config
  • a bash completion script ~/.local/share/crandr/complete.bash, if it does not exit or is outdated. You need to source this file in your bashrc in order to activate the bash completion.

If you are unhappy with the default location of these scripts you can inject appdirs, xdgappdirs or platformdirs into the virtual environment (pipx inject crandr appdirs).

Installation

$ pipx install crandr

Dependencies

  • Python >= 3.8
  • xrandr and RandR >= version 1.3 or swaymsg

Dependencies for running the tests:

Alternatives

  • arandr (for X) and wdisplays (for wayland) are graphical user interfaces to control monitors.
  • autorandr (for X) and kanshi (for wayland) are programs which automatically enable output profiles when connecting and disconnecting monitors.

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

crandr-1.6.1.tar.gz (32.8 kB view details)

Uploaded Source

Built Distribution

crandr-1.6.1-py3-none-any.whl (20.3 kB view details)

Uploaded Python 3

File details

Details for the file crandr-1.6.1.tar.gz.

File metadata

  • Download URL: crandr-1.6.1.tar.gz
  • Upload date:
  • Size: 32.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-requests/2.32.3

File hashes

Hashes for crandr-1.6.1.tar.gz
Algorithm Hash digest
SHA256 dd7f03020681f990219126875953f5a860036203cada079167e946ce57826221
MD5 7e32d06b32833f59ad94ed0231ebb3a0
BLAKE2b-256 363dbc9260f75c71035e1ef99660cc991b11c8615a357a615d2356318c137188

See more details on using hashes here.

File details

Details for the file crandr-1.6.1-py3-none-any.whl.

File metadata

  • Download URL: crandr-1.6.1-py3-none-any.whl
  • Upload date:
  • Size: 20.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-requests/2.32.3

File hashes

Hashes for crandr-1.6.1-py3-none-any.whl
Algorithm Hash digest
SHA256 d4362c279f1f871d08901bf3ae4b6200362f5951a9308500e8e65086dffa4c55
MD5 c6fc92ad993a8ec2a1016b82e2837f1c
BLAKE2b-256 f4ae937e3db148c11419ac6172bd71a95466af84fde652a70d661bf0e016c73b

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page