Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/xiaokang2022/maliang
A lightweight UI framework based on tkinter with all UI drawn in Canvas!
https://github.com/xiaokang2022/maliang
canvas cross-platform custom gui lightweight modern-ui python themed tk tkinter typed ui ui-design widget
Last synced: about 4 hours ago
JSON representation
A lightweight UI framework based on tkinter with all UI drawn in Canvas!
- Host: GitHub
- URL: https://github.com/xiaokang2022/maliang
- Owner: Xiaokang2022
- License: mit
- Created: 2023-05-27T20:54:24.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-01-30T07:43:07.000Z (8 days ago)
- Last Synced: 2025-01-30T08:27:25.383Z (8 days ago)
- Topics: canvas, cross-platform, custom, gui, lightweight, modern-ui, python, themed, tk, tkinter, typed, ui, ui-design, widget
- Language: Python
- Homepage: https://xiaokang2022.github.io/maliang/
- Size: 111 MB
- Stars: 660
- Watchers: 11
- Forks: 32
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE.txt
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
> [!IMPORTANT]
> This project was originally named `tkintertools` and has been renamed to `maliang` after a community [vote](https://github.com/Xiaokang2022/maliang/discussions/41)! ๐maliang
English ยท ็ฎไฝไธญๆ ยท ็น้ซไธญๆ
https://xiaokang2022.github.io/maliang/
A lightweight UI framework based ontkinter
with all UI drawn inCanvas
## ๐ฆ Installation
Install it with the following command:
```shell
pip install maliang
```### ๐ ๏ธ Dependencies
Here are the only dependencies that the project must need:
* [`typing-extensions`](https://github.com/python/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`](https://github.com/albertosottile/darkdetect): provide operating system theme detection
* [`pillow`](https://github.com/python-pillow/Pillow): provide more types of images and optimize image scaling speed
* [`pywinstyles`](https://github.com/Akascape/py-window-styles): provide some window effects for Windows systems
* [`hPyT`](https://github.com/Zingzy/hPyT): provide more configuration options for Windows system windows
* [`win32material`](https://github.com/littlewhitecloud/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:
```shell
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`](https://github.com/Xiaokang2022/maliang-mpl): support for `matplotlib`
* [`maliang-media`](https://github.com/Xiaokang2022/maliang-media): support for media files
* [`maliang-three`](https://github.com/Xiaokang2022/maliang-three): support for simple 3D drawingsYou can install all the official extensions with the following command:
```shell
pip install maliang[ext]
```In addition, you can find all the third-party extensions that we've collected [here](https://xiaokang2022.github.io/maliang/t%26d/third-party/).
## ๐ More
### ๐ผ๏ธ 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](https://github.com/Xiaokang2022/maliang-demos)!
> [!TIP]
> Please click **"Expand"** to view the galleryExpand
![preview_1](https://github.com/Xiaokang2022/maliang-demos/blob/main/preview/demo9-1.png?raw=true)
![preview_2](https://github.com/Xiaokang2022/maliang-demos/blob/main/preview/demo9-2.png?raw=true)
![preview_3](https://github.com/Xiaokang2022/maliang-demos/blob/main/preview/demo9-3.png?raw=true)
![preview_4](https://github.com/Xiaokang2022/maliang-demos/blob/main/preview/demo9-4.png?raw=true)
![preview_5](https://github.com/Xiaokang2022/maliang-demos/blob/main/preview/demo0-1.png?raw=true)
![preview_6](https://github.com/Xiaokang2022/maliang-demos/blob/main/preview/demo0-2.png?raw=true)
![preview_7](https://github.com/Xiaokang2022/maliang-demos/blob/main/preview/demo1-1.png?raw=true)
![preview_8](https://github.com/Xiaokang2022/maliang-demos/blob/main/preview/demo1-2.png?raw=true)
![preview_9](https://github.com/Xiaokang2022/maliang-demos/blob/main/preview/demo2.png?raw=true)
![preview_10](https://github.com/Xiaokang2022/maliang-demos/blob/main/preview/demo3.png?raw=true)
![preview_11](https://github.com/Xiaokang2022/maliang-demos/blob/main/preview/demo4-1.png?raw=true)
![preview_12](https://github.com/Xiaokang2022/maliang-demos/blob/main/preview/demo4-2.png?raw=true)
![preview_13](https://github.com/Xiaokang2022/maliang-demos/blob/main/preview/demo5-1.png?raw=true)
![preview_14](https://github.com/Xiaokang2022/maliang-demos/blob/main/preview/demo5-2.png?raw=true)
![preview_15](https://github.com/Xiaokang2022/maliang-demos/blob/main/preview/demo6-1.png?raw=true)
![preview_16](https://github.com/Xiaokang2022/maliang-demos/blob/main/preview/demo7-1.png?raw=true)
![preview_17](https://github.com/Xiaokang2022/maliang-demos/blob/main/preview/demo7-2.png?raw=true)
![preview_18](https://github.com/Xiaokang2022/maliang-demos/blob/main/preview/demo8-1.png?raw=true)
![preview_19](https://github.com/Xiaokang2022/maliang-demos/blob/main/preview/demo10-1.png?raw=true)
![project_1](https://github.com/Xiaokang2022/Intelligent-Magic-Cube/blob/main/preview.png?raw=true)
![project_2](https://github.com/Xiaokang2022/Chess/blob/master/preview.png?raw=true)
![project_3](https://github.com/Xiaokang2022/Super-Gobang/blob/main/preview.png?raw=true)
![project_4](https://github.com/Xiaokang2022/TodoList/blob/master/preview.png?raw=true)
### ๐ Links
Here are some links that may be helpful to you:
* ๐ License: [*MIT License*](LICENSE.txt)
* ๐ Changelog: [*CHANGELOG.md*](CHANGELOG.md)
* ๐ Security Policy: [*SECURITY.md*](SECURITY.md)
* ๐ Contribution Guideline: [*CONTRIBUTING.md*](CONTRIBUTING.md)
* ๐ Code of Conduct: [*CODE_OF_CONDUCT.md*](CODE_OF_CONDUCT.md)
* ๐ Tutorials and Documents: [Tutorials & Documents](https://xiaokang2022.github.io/maliang-docs/)
* โค๏ธ Sponsor this Project: [Sponsor](https://xiaokang2022.github.io/maliang/Sponsor/)
* ๐ Repository Mirrors:
[GitCode](https://gitcode.com/Xiaokang2022/maliang),
[Gitee](https://gitee.com/Xiaokang2022/maliang)### ๐ Contributors
Many thanks to the contributions of:
[![Contributors](https://contrib.rocks/image?repo=Xiaokang2022/maliang)](https://github.com/Xiaokang2022/maliang/graphs/contributors)