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
  • To move the lens to another screen, press S

Known limitations

  • The app is tested on OSX and Linux. It may flicker when you move the lens, if you know how to fix this, please help. :)
  • Some people have found issues when using two screens, which are hopefully fixed now. Leave an issue if this problem appears.
  • Pulling the lens to another screen is currently not supported. To switch screens, press S.
  • 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
  • Add a splash screen with a "do not show again" to explain usage.

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.1.tar.gz (2.4 MB view details)

Uploaded Source

Built Distribution

monolens-0.5.1-py3-none-any.whl (6.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: monolens-0.5.1.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.1 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.1.tar.gz
Algorithm Hash digest
SHA256 2f51e865896f80e76d9b8285b3f8fdfdb5f25a693f3c89e92ec48880b21bc52d
MD5 ec96ba30b25937b4321ebd89721e3c0f
BLAKE2b-256 34f3d692b668af6c8f966c9a39e61662e7bb0c8bb2c1eb78d632d8d402f2a7ff

See more details on using hashes here.

File details

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

File metadata

  • Download URL: monolens-0.5.1-py3-none-any.whl
  • Upload date:
  • Size: 6.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.3.1 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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 b1f90523e1421f6fcf4375aab1249f6b25e47e1340a216611a139b8b4c71d532
MD5 82a9b0f47f9d3ea536182b0a67039064
BLAKE2b-256 bdd60d815e49f4bb6982f373e4774b74de23ab7003b9ee7d11982e212b47adca

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