Skip to main content

Show part of your screen in 8-bit grayscale

Project description

monolens

Show part of your screen in 8-bit grayscale.

Watch the demo on YouTube.

Usage

Install with pip install monolens. Then run monolens in a terminal on the screen that you want to look at.

  • Drag the lens around by holding a Mouse button down inside the window
  • Resize the lens by pressing up, down, left, right
  • To quit, press Escape, Q, or double click on the lens

Known limitations

  • The app works smoothly on OSX, but may flicker on Linux when you move the lens.
  • Some people have found issues when using two screens. It is tested with two screens on OSX, but not yet on Linux. Please leave an issue if it does not work for you.
  • Pulling the lens to another screen is currently not supported. To switch screens, you need to run monolens from a terminal on that screen (this works on OSX at least). This limitation will hopefully be lifted in the near future.
  • The lens actually uses a static screenshot which is periodically updated. Because of this, pixels directly under the lens cannot be updated unless you move the lens away first from new content that you want to look at, and then back.
  • On OSX, you need to give monolens permission to make screenshots, since an ordinary app is not allowed to read pixels outside of its window for security reasons. Doing this is safe; monolens has no networking code implemented at all.

Future plans

  • Support gestures and move to rescale the lens (pinch etc)
  • Simulate color blindness

For developers

  • You can run monolens without installing it from the project folder via python -m monolens. You need to install pyside6 manually then.

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

monolens-0.5.0.tar.gz (2.4 MB view details)

Uploaded Source

Built Distribution

monolens-0.5.0-py3-none-any.whl (6.0 kB view details)

Uploaded Python 3

File details

Details for the file monolens-0.5.0.tar.gz.

File metadata

  • Download URL: monolens-0.5.0.tar.gz
  • Upload date:
  • Size: 2.4 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.3.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.0 CPython/3.9.5

File hashes

Hashes for monolens-0.5.0.tar.gz
Algorithm Hash digest
SHA256 8c24187ba4bd4e071d7c61df9c5451794b5757171e325b989d8213ee86d89bce
MD5 c8f713d7076ad8c9cbbc41dc91302c26
BLAKE2b-256 ffdca3e204f48a3256857d187824aa9a884a16c6b4f74628715cb8da6483ec67

See more details on using hashes here.

File details

Details for the file monolens-0.5.0-py3-none-any.whl.

File metadata

  • Download URL: monolens-0.5.0-py3-none-any.whl
  • Upload date:
  • Size: 6.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.3.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.0 CPython/3.9.5

File hashes

Hashes for monolens-0.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 6cd5379b48b108e95841034b01ee02549e35a8e08eeed9856e6cb347cf139bfd
MD5 11caf90fc4150ae77ad448d5c697d88b
BLAKE2b-256 6dc627f97435cee470fed1c00afda54457a14253113e886a2fc6512fbd45fc46

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