https://github.com/hdembinski/monolens

View part of your screen in grayscale or simulated color vision deficiency.
https://github.com/hdembinski/monolens

Last synced: 20 days ago
JSON representation

View part of your screen in grayscale or simulated color vision deficiency.

• Host: GitHub
• URL: https://github.com/hdembinski/monolens
• Owner: HDembinski
• License: mit
• Created: 2021-05-26T20:31:12.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2024-08-05T22:41:11.000Z (3 months ago)
• Last Synced: 2024-09-28T09:18:16.943Z (about 2 months ago)
• Language: Python
• Homepage:
• Size: 2.26 MB
• Stars: 30
• Watchers: 4
• Forks: 3
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# monolens

View part of your screen in grayscale or filtered to simulate color vision deficiency.

[](https://pypi.org/project/monolens)

Watch the demo on YouTube.

[](https://youtu.be/f8FRBlSoqWQ)

Install with `pip install monolens` and then run `monolens` in a terminal or do it in one

command with `pipx run monolens`.

Monolens was featured on Twitter by [Matthew Feickert](https://twitter.com/HEPfeickert/status/1399835341486493699) and [Matplotlib](https://twitter.com/matplotlib/status/1399842592674680836), and picked up in this episode of [Python Bytes](https://pythonbytes.fm/episodes/show/236/fuzzy-wuzzy-wazzy-fuzzy-was-faster). Thanks, guys!

Monolens uses the [Numba Just-In-Time compiler](https://numba.pydata.org/) to apply image filters in real-time using just ordinary Python.

# Usage

- Drag the lens around by holding a Mouse button down inside the window

- Press Escape, Q, or double click on the lens to quit

- Press up, down, left, right to resize the lens

- Press Tab to switch between greyscale and different forms of simulated colorblindness

- Press I to switch view label on/off

- Press M to move the lens to another screen

On OSX, you need to give Monolens permission to make screenshots, which is safe.

# Known limitations

- The app is tested on OSX and Linux. It may flicker when you move the lens (less so on

  OSX). If you know how to fix this, please help. :)

- Pulling the lens to another screen is currently not supported. See usage on how to

  switch screens instead.

- The lens only works for static images. The lens actually uses a static screenshot which

  is updated as you move the lens around. This trick is necessary, because an app cannot

  read the pixels under its own window. Because of this, the pixels under the app are only

  updated when you move the lens away first and then back.

- On OSX, an ordinary app is not allowed to read pixels outside of its window for security

  reasons, which is why this app needs special permissions. Giving permissions is safe;

  Monolens contains no networking code and will neither store nor send your pixels anywhere.

# Future plans

- Support gestures to rescale the lens (pinch etc)