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

Uploaded Source

Built Distribution

monolens-0.4.6-py3-none-any.whl (5.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: monolens-0.4.6.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.4.6.tar.gz
Algorithm Hash digest
SHA256 641a71ad18e98d481828da42a368591d30657a4e6a09a244ae8296fc622c7815
MD5 6563772831b2601cb11269737c3b5830
BLAKE2b-256 d0945a04ea70ad9a0097fcbb9ebc5b533632770f8ca0df6919fbe351adc9d173

See more details on using hashes here.

File details

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

File metadata

  • Download URL: monolens-0.4.6-py3-none-any.whl
  • Upload date:
  • Size: 5.5 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.4.6-py3-none-any.whl
Algorithm Hash digest
SHA256 2e1a30b3176e5e3c4e74db3a9ab2986d6eb966928a1d5e59d24aa7605959f037
MD5 5af07687dc2808f8359169dca01975a8
BLAKE2b-256 865ba9816208869746af2e4ec311e62d7dc3bfa5bea6e0a058a74ee6b2388c05

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