# maliang **Repository Path**: Xiaokang2022/maliang ## Basic Information - **Project Name**: maliang - **Description**: 一个基于 tkinter 且控件都由画布绘制的轻量级 UI 框架！ - **Primary Language**: Python - **License**: MIT - **Default Branch**: main - **Homepage**: https://github.com/Xiaokang2022/maliang - **GVP Project**: No ## Statistics - **Stars**: 64 - **Forks**: 8 - **Created**: 2022-12-08 - **Last Updated**: 2025-11-03 ## Categories & Tags **Categories**: desktop-ui **Tags**: tkinter, GUI, themed, Python, maliang ## README

maliang

Logo

English · 简体中文 · 繁體中文

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

一个基于 tkinter 且控件都由画布绘制的轻量级 UI 框架

版本 下载 检查和测试 代码覆盖率
关注 复刻 星标 议题 拉取请求 讨论

## 📦 安装 要安装该包，你的 Python 版本必须 **`>=3.10`**。用以下命令进行安装： ```shell pip install maliang ``` ### 🛠️ 依赖包 下面是该项目唯一必须需要的依赖包： * [`typing-extensions`](https://github.com/python/typing_extensions): 提供额外的类型提示 ### 🎨 可选包 下面的包都是可选的，不安装也能让该项目正常运行，但安装它们可以为你提供更多的功能： * [`darkdetect`](https://github.com/albertosottile/darkdetect): 提供操作系统主题检测 * [`pillow`](https://github.com/python-pillow/Pillow): 提供更多类型图片的使用及优化图片缩放速度 * [`pywinstyles`](https://github.com/Akascape/py-window-styles): 提供一些 Windows 系统的窗口效果 * [`hPyT`](https://github.com/Zingzy/hPyT): 提供更多 Windows 系统窗口的配置选项 * [`win32material`](https://github.com/littlewhitecloud/win32material): 提供更多 Windows 系统窗口的配置选项 **推荐**，这些包都应该安装，用以下命令可以安装全部的可选包： ```shell pip install maliang[opt] ``` ### 🧩 扩展包 除了基础功能之外，我们还提供一些扩展包来实现某些特定的功能。目前已有的官方扩展包如下： * [`maliang-mpl`](https://github.com/Xiaokang2022/maliang-mpl): 提供 `matplotlib` 包的相关支持 * [`maliang-media`](https://github.com/Xiaokang2022/maliang-media): 提供媒体文件的相关支持 * [`maliang-three`](https://github.com/Xiaokang2022/maliang-three): 提供简单 3D 绘图的相关支持 * [`maliang-table`](https://github.com/Xiaokang2022/maliang-table): 提供表格控件的相关支持 用以下命令可以安装全部的官方扩展包： ```shell pip install maliang[ext] ``` 此外，你还可以在 [这里](https://xiaokang2022.github.io/maliang/t%26d/third-party/) 找到所有已被我们收集到的第三方扩展包。 > [!WARNING] > 上述包并不包含在本项目的源代码中，如果你使用了它们并想要再分发，请遵循它们的开源协议！ ## 👀 更多 ### ℹ️ 关于 本项目的徽标取自开源项目：[`fluentui-emoji`](https://github.com/microsoft/fluentui-emoji)，名称取自中国童话故事：[*《神笔马良》*](https://baike.baidu.com/item/%E7%A5%9E%E7%AC%94%E9%A9%AC%E8%89%AF/14821387) ### 🖼️ 画廊 下面是一些可以用该项目实现的演示，它们可能是用该项目的最新版本构建的，也可能是用旧版构建的，但无论怎样，它们的代码都可以在演示存储库 [`maliang-demos`](https://github.com/Xiaokang2022/maliang-demos) 中找到！ > [!TIP] > 请点击 **“展开”** 来查看画廊
展开 ![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)
### 🔗 链接 这里是一些可能对您有帮助的链接： * 📑 项目许可: [*MIT License*](LICENSE.txt) * 📘 更新日志: [*CHANGELOG.md*](CHANGELOG.md) * 📕 安全策略: [*SECURITY.md*](SECURITY.md) * 📗 贡献指南: [*CONTRIBUTING.md*](CONTRIBUTING.md) * 📙 行为准则: [*CODE_OF_CONDUCT.md*](CODE_OF_CONDUCT.md) * 📚 教程和文档: [Tutorials & Documents](https://xiaokang2022.github.io/maliang-docs/) ([Mirror](https://maliang-docs.netlify.app/)) * ❤️ 赞助我们: [Sponsor](https://xiaokang2022.github.io/maliang/Sponsor/) * 🚀 存储库镜像源: [Gitee](https://gitee.com/Xiaokang2022/maliang), [GitCode](https://gitcode.com/Xiaokang2022/maliang) ### 😉 贡献者 非常感谢下面这些人的贡献： [![贡献者](https://contrib.rocks/image?repo=Xiaokang2022/maliang)](https://github.com/Xiaokang2022/maliang/graphs/contributors)