![](\"https://github.com/HeaTTheatR/KivyMD-data/raw/master/gallery/prevideo-run-in-desktop.png\" "\\"Click")
\n \n![](\"https://github.com/HeaTTheatR/KivyMD/raw/master/kivymd/images/kivy-logo-white-512.png\"/){kind=logo}
\n\nKivyMD is a collection of Material Design compliant widgets for use with [Kivy](http://kivy.org), a framework for cross-platform, touch-enabled graphical applications.\n\nThe project's goal is to approximate Google's [Material Design spec](https://material.io/design/introduction/) as close as possible without sacrificing ease of use or application performance.\n\nThis library is a fork of the [KivyMD project](https://gitlab.com/kivymd/KivyMD) the author of which stopped supporting this project three years ago. We found the strength and brought this project to a new level.\n\nCurrently we're in **alpha** status, so things are changing all the time and we cannot promise any kind of API stability. However it is safe to vendor now and make use of what's currently available.\n\nJoin the project! Just fork the project, branch out and submit a pull request when your patch is ready. If any changes are necessary, we'll guide you through the steps that need to be done via PR comments or access to your for may be requested to outright submit them.\n\nIf you wish to become a project developer (permission to create branches on the project without forking for easier collaboration), have at least one PR approved and ask for it. If you contribute regularly to the project the role may be offered to you without asking too.\n\n[](https://pypi.org/project/kivymd)\n[](#Installation)\n[](https://pepy.tech/project/kivymd)\n[](https://github.com/psf/black)\n[](https://travis-ci.org/HeaTTheatR/KivyMD)\n[](https://discord.gg/wu3qBST)\n\nDocumentation\n=============\n\n#### Wiki\n\nNo complete documentation yet. Our [Wiki](https://github.com/HeaTTheatR/KivyMD/wiki) contents some examples of using KivyMD widgets.\n\n#### Demos\n\n\n \n \n \n
\n \n ![](\"https://github.com/HeaTTheatR/KivyMD-data/raw/master/gallery/tutorial.png\" "\\"Click")
\n \n
![](\"https://github.com/HeaTTheatR/KivyMD-data/raw/master/gallery/XUBUNTU.png\" "\\"Click")
\n\n\nPackages for Android are built according to the following instructions:\n* Download [XUbuntu 18.04](https://xubuntu.org/release/18-04/)\n* Create a new virtual machine based on the downloaded image of XUbuntu\n* Start the XUbuntu virtual machine, download [this bash script](https://github.com/HeaTTheatR/KivyMD-data/blob/master/install-kivy-buildozer-dependencies.sh), add execution permissions and run script:\n```bash\nwget https://github.com/HeaTTheatR/KivyMD-data/raw/master/install-kivy-buildozer-dependencies.sh\nchmod +x install-kivy-buildozer-dependencies.sh\n\n./install-kivy-buildozer-dependencies.sh\n```\n* Script will install all the necessary libraries and tools for creating packages for Android\n* Done! Now you have a virtual machine for building Kivy application packages!\n\n> Or see the instructions [here](https://github.com/zaemiel/kivy-buildozer-installer).\n\n\nAPI Breaking changes\n====================\n\n* All classes with the Behavior prefix moved to `kivymd.uix.behaviors` module.\n* All uix modules moved to `kivymd.uix` module.\n* All widgets that usually used in kv-lang are automatically added to Factory.\nYou don't need to `#:import` them. Remove all your imports from kv files.\n* Changed font styles:\n\n| Old | New |\n|----------|-----------|\n| Icon | Icon |\n| - | Overline |\n| Caption | Caption |\n| Button | Button |\n| Body2 | Body2 |\n| Body1 | Body1 |\n| - | Subtitle2 |\n| Subhead | Subtitle1 |\n| Title | H6 |\n| Headline | H5 |\n| Display1 | H4 |\n| Display2 | H3 |\n| Display3 | H2 |\n| Display4 | H1 |\n\n* Colors `BlueGrey` and `Grey` renamed to `BlueGray` and `Gray`\n\nVideo preview\n=============\n\n\n \n ![](\"https://github.com/HeaTTheatR/KivyMD-data/raw/master/gallery/prevideo.png\" "Click to watch video on YouTube")
\n \n
\n ![](\"https://github.com/HeaTTheatR/KivyMD-data/raw/master/gallery/previous.png\")
\n