nativeframe

Lightweight native window customization for Python GUI applications.

nativeframe provides a small, framework-independent interface for controlling native window appearance and behavior using platform APIs.

It does not depend on a specific GUI framework — it operates directly on the native window created by the application.

Windows

The Windows backend uses WinAPI and DWM.

Features

• Window opacity
• Taskbar visibility
• DWM rounded corners
• Automatic native window detection
• No GUI framework dependencies

Usage

from nativeframe.windows import WindowController

window = WindowController(
    opacity=220,
    taskbar=True,
    rounded=True
)

window.apply()

WindowController

WindowController(
    opacity=255,
    taskbar=True,
    rounded=False
)

• opacity — window opacity in the 0..255 range.
• taskbar — controls whether the window appears in the taskbar.
• rounded — enables system window corner rounding.

apply() automatically finds the visible top-level window owned by the current process and applies the requested settings.

Tested frameworks

The Windows backend has been tested with:

• Kivy / SDL2
• PySide6 / Qt
• Dear PyGui / GLFW
• Toga / WinForms

No framework-specific integration is required.

Requirements

• Python 3.10+
• Windows 10 or later

Some DWM features, such as system rounded corners, require Windows 11.

Roadmap

Planned features include:

• Always-on-top mode
• Click-through windows
• Additional DWM customization
• Backdrop and blur effects
• Linux support
• macOS support

License

MIT