Skip to main content

Screen Manager with fractional scaling support for X11

Project description

logo

Display Manager with fractional scaling support for X11

MIT License Badge Github Action Badge Codacy Badge


Introduction

ReScreen is an open-source tool that tries to simplify the per-display fractional scaling problem many users have on Linux inside an X11-Session. You can use the graphical display configurator to configure your display setup to your liking. When you are satisfied with the setup, the configuration is saved and applied to your system. Everytime the connected display configuration changes, ReScreen automatically tries to find a matching profile and if it found one, it gets applied. You can also manually force this behaviour using the command line interface.

Installation

Debian/Ubuntu

  1. Download the .deb-File from the Release Page.

  2. To install it on your system, use

    $ sudo apt-get install -f <path to the .deb-File>
    

A package repository for deb packages is in the making :construction:

Arch

  1. Download the .pkg.tar.zst-File from the Release Page.
  2. To install it on your System, use
    $ sudo pacman -U <path to the .pkg.tar.zst-File>
    

An easier method for installing this package on Arch is by using the AUR :arrow_down:

AUR

  1. With an AUR-Helper of your choice (I will use yay in this example), install the package using
    $ yay -S rescreen
    

PIP

  1. This will not embed rescreen into your system, only the command line tool gets installed. The GUI is not available as a shortcut in the menu and the screen change watcher does not automatically run in the background.

    You also need to install the required system dependencies on your own, including xrandr, xev, loginctl, whoami and edid-decode

    To install only the command line tools on your system, you can use

    $ pip install rescreen
    

Command Line Usage

Detect and save the current display configuration

$ rescreen save

Detect the current display configuration, try to find a matching profile and apply it if found

$ rescreen load

Start the Graphical Display Configurator

$ rescreen gui

Start the display change watcher that automatically tries to apply the matching profile

Note: This command needs to be run with superuser-permissions. The preferred way of using the watcher is to have it installed as a systemd-service

(This is done in the bundled packages for the distributions)

$ rescreen watcher

Contributing

If you are missing a feature or have new idea, go for it! That is what open-source is for! 😃

Author

Tim-Luca Lagmöller (@lagmoellertim)

Donations / Sponsors

I'm part of the official GitHub Sponsors program where you can support me on a monthly basis.

GitHub Sponsors

You can also contribute by buying me a coffee (this is a one-time donation).

Ko-Fi Sponsors

Thank you for your support!

License

The Code is licensed under the

MIT License

Copyright © 2022-present, Tim-Luca Lagmöller

Have fun :tada:

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

rescreen-1.0.4.tar.gz (27.5 kB view details)

Uploaded Source

Built Distribution

rescreen-1.0.4-py3-none-any.whl (35.9 kB view details)

Uploaded Python 3

File details

Details for the file rescreen-1.0.4.tar.gz.

File metadata

  • Download URL: rescreen-1.0.4.tar.gz
  • Upload date:
  • Size: 27.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.0 CPython/3.9.12

File hashes

Hashes for rescreen-1.0.4.tar.gz
Algorithm Hash digest
SHA256 41e302237cb71cf70ae3ef54f6cdb4015e901168c2edaf2f419bdd1e632a0edf
MD5 ca460b9a4c774ab5c1665e1157cba7fd
BLAKE2b-256 36b6731e2ff0fd3609eec9ed18215534bf7e40a556059d184464bacd8d253607

See more details on using hashes here.

File details

Details for the file rescreen-1.0.4-py3-none-any.whl.

File metadata

  • Download URL: rescreen-1.0.4-py3-none-any.whl
  • Upload date:
  • Size: 35.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.0 CPython/3.9.12

File hashes

Hashes for rescreen-1.0.4-py3-none-any.whl
Algorithm Hash digest
SHA256 e39d59a067c725591b1b0dce693c483200f1285502f44d860654eba4fb402fc0
MD5 277a3fb8f5011c6dc4e60c399c2f2198
BLAKE2b-256 319b4b61a02541ba4957c231f7b07ee791f116c8908ac2563fd591c2244896a6

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