Metadata-Version: 2.4
Name: nativeframe
Version: 0.1.0
Summary: Lightweight native window customization for Python GUI applications.
Author: xximde
License: MIT
Project-URL: Homepage, https://github.com/xx1mde/nativeframe
Project-URL: Repository, https://github.com/xx1mde/nativeframe
Project-URL: Issues, https://github.com/xx1mde/nativeframe/issues
Keywords: window,winapi,dwm,gui,windows,native
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Microsoft :: Windows :: Windows 10
Classifier: Operating System :: Microsoft :: Windows :: Windows 11
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# 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

```python
from nativeframe.windows import WindowController

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

window.apply()
```

### WindowController

```python
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
