uui-cuil 0.2.1

A lightweight frameless UI framework for Python via ctypes and Win32 API

uui/cuil is a custom lightweight UI library written in Python using only ctypes. It provides direct interaction with the Windows API without heavy dependencies.

PULL REQUESTS ARE WELCOME!

installation

pip install uui-cuil

zero dependencies

Windows backend

Autors:

• zcveo5 (i am)

Features

• Lightweight & Fast: Zero external dependencies, pure Python + ctypes.
• Frameless Window Support: Modern borderless windows while keeping native Windows 11 animations, resizing, and shadows.
• Per-pixel Scroll: Built-in smooth, pixel-perfect scrolling system.
• Customizable Render System: Uses native gdi32 out of the box, with full support for plugging in your own rendering backend (GDI+, Direct2D, etc.).
• Low-level Control: Direct access to WND_PROCs and low-level Win32 messages like WM_MOUSEWHEEL or WM_LBUTTONDOWN.
• Flexible Event Binding: Powerful binding system with parsed or raw wParam / lParam event data exposed directly to your code.

Limitations:

• now only Windows backend ready, you can write your own and send pull request!

Rules for your own backend

• use only built-in libraries
• python 3.13 and newer
• use uui.backend.abstract and Windows backend as base
• form messages to uui.backend.events messages

Examples:

Hello world window

import uui

root = uui.Window('Hello World') # Create a window with the title "Hello World"

uui.Label(root,              # Parent (window or another widget)
          'Hello World!',    # Text
          '#000000',         # Color 
          ).pack()

root.start()