Skip to main content

Python wrapper for Windows Magnification API

Project description


Windows PyPI version Documentation Status GitHub license

Python wrapper for Windows Magnification API

pip install WinMagnification

Covered functions:

  • MagInitialize
  • MagUninitialize
  • MagGetFullscreenColorEffect
  • MagSetFullscreenColorEffect
  • MagSetFullscreenTransform
  • MagGetFullscreenTransform
  • MagSetColorEffect
  • MagGetColorEffect
  • MagSetWindowTransform
  • MagGetWindowTransform
  • MagSetWindowSource
  • MagGetWindowSource
  • MagSetWindowFilterList
  • MagGetWindowFilterList
  • MagGetInputTransform
  • MagSetInputTransform
  • MagShowSystemCursor

You may use old-style function names:

import win_magnification as mag
import win_magnification.old as old_mag


Or you may use more pythonic function names:

import win_magnification as mag


Or... you can even use Object-Oriented wrapper:

import win_magnification as mag

api = mag.WinMagnificationAPI()
api.fullscreen.color_effect.raw = mag.const.COLOR_INVERSION_EFFECT


There are 3.5 groups of functions:

  • Fullscreen (nothing required, call and chill) have limited functional, but simple:
    • get/set_fullscreen_color_effect
    • get/set_fullscreen_transform
    • get_input_transform
  • Window (requires window creation as shown in example), more powerful, but requires such things like custom window creation (hello from pywin32), UiAccess (Hard to obtain) if you need your magnifier above everything, but you can simulate all fullscreen functions too:
    • get/set_color_effect
    • get/set_transform
    • get/set_source
    • get/set_filters (supports exclusion only, looks like excluded windows never exist for magnifier)
  • UiAccess required:
    • set_input_transform
  • Other:
    • initialize
    • finalize
    • set_cursor_visibility (cursor stay hidden until active)

Known alternatives


I can't actually use this lib, I don't know why, it just does nothing and imports nothing. Also, it doesn't support fullscreen* functions

Known issues

Working from different threads is pain, and I'm trying to solve/restrict this somehow

PyWin32 Integration?

This package uses ctypes only, so no pywin32 required. But, well, you can use pywin32 for creating magnifier windows and so on (see example)

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

WinMagnification-0.1.0.tar.gz (21.7 kB view hashes)

Uploaded Source

Built Distribution

WinMagnification-0.1.0-py3-none-any.whl (26.6 kB view hashes)

Uploaded Python 3

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