maliang

English · 简体中文 · 繁體中文

https://xiaokang2022.github.io/maliang/

A lightweight UI framework based on tkinter with all UI drawn in Canvas

📦 Installation

To install this package, your Python version must be >=3.10. Install it with the following command:

pip install maliang

🛠️ Dependencies

Here are the only dependencies that the project must need:

• typing-extensions: provide additional type hints

🎨 Optional

The following packages are optional and will make the project work without installation, but installing them can give you more functionality:

• darkdetect: provide operating system theme detection
• pillow: provide more types of images and optimize image scaling speed
• pywinstyles: provide some window effects for Windows systems
• hPyT: provide more configuration options for Windows system windows
• win32material: provide more configuration options for Windows system windows

Recommended, these packages should be installed. You can install all the optional packages with the following command:

pip install maliang[opt]

🧩 Extensions

In addition to the basic functionality, we also offer a number of extension packs to implement specific functionality. The following official extensions are available:

• maliang-mpl: support for matplotlib
• maliang-media: support for media files
• maliang-three: support for simple 3D drawings
• maliang-table: support for table widget

You can install all the official extensions with the following command:

pip install maliang[ext]

In addition, you can find all the third-party extensions that we've collected here.

[!WARNING]
These packages mentioned above are not included in the source code of this project, if you use them and want to redistribute them, please follow their open source license!

👀 More

ℹ️ About

The logo of this project is taken from the open source project: fluentui-emoji, and the name is taken from a Chinese fairy tale: 《神笔马良》

🖼️ Gallery

The demos below are some of the things that can be achieved with the project, they may be built with the latest version of the project, or they may be built with an older version, but either way, the code for the demo below can be found in the demo repository maliang-demos!

[!TIP]
Please click "Expand" to view the gallery

Expand

🔗 Links

Here are some links that may be helpful to you:

• 📑 License: MIT License
• 📘 Changelog: CHANGELOG.md
• 📕 Security Policy: SECURITY.md
• 📗 Contribution Guideline: CONTRIBUTING.md
• 📙 Code of Conduct: CODE_OF_CONDUCT.md
• 📚 Tutorials and Documents: Tutorials & Documents (Mirror)
• ❤️ Sponsor this Project: Sponsor
• 🚀 Repository Mirrors: Gitee, GitCode

😉 Contributors

Many thanks to the contributions of: