Package: kivymd
KivyMD1.2.0KivyMD is a collection of Material Design compliant widgets for use withKivy, a framework for cross-platform, touch-enabled
graphical applications.The project's goal is to approximate Google'sMaterial Design specas close as
possible without sacrificing ease of use. This library is a fork of theKivyMD project. We found the strength and
brought this project to a new level.Join 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.If 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.Installationpipinstallkivymd==1.2.0Dependencies:Kivy>= 2.2.0 (Installation)Python 3.7+PillowMaterialColorHow to installCommandabovewill install latest release version of KivyMD fromPyPI.If you want to install development version frommasterbranch, you should specify link to zip archive:pipinstallhttps://github.com/kivymd/KivyMD/archive/master.zipTip: Replacemaster.zipwith<commit hash>.zip(eg51b8ef0.zip) to
download KivyMD from specific commit.Also you can install manually from sources. Just clone the project and run pip:gitclonehttps://github.com/kivymd/KivyMD.git--depth1cdKivyMD
pipinstall.Speed Tip: If you don't need full commit history (about 1.14 GiB), you can
use a shallow clone (git clone https://github.com/kivymd/KivyMD.git --depth 1)
to save time. If you need full commit history, then remove--depth 1.How to fix a shader bug on an android deviceUseKivyfrom master branch orKivy>=2.2.0andKivyMD(from master branch):pipinstallhttps://github.com/kivy/kivy/archive/master.zip
pipinstallhttps://github.com/kivymd/KivyMD/archive/master.zipAnd use withBuildozer:requirements=kivy==master, https://github.com/kivymd/KivyMD/archive/master.zipHow to use withBuildozerrequirements=kivy==2.2.0, kivymd==1.2.0This will download latest release version of KivyMD fromPyPI.If you want to use development version frommasterbranch, you should specify link to zip archive:requirements=kivy==2.1.0, https://github.com/kivymd/KivyMD/archive/master.zipDo not forget to runbuildozer android cleanor remove.buildozerdirectory
before building if version was updated (Buildozer doesn't update already
downloaded packages).On LinuxUse Buildozerdirectlyor viaDocker.On Windows 10InstallUbuntu WSLand followLinux steps.Build automatically via GitHub ActionsUseArtemSBulgakov/buildozer-action@v1to build your packages automatically on push or pull request.Seefull workflow example.How to use withkivy-iostoolchainbuildpython3kivypillow
toolchainpipinstall--no-depskivymdDocumentationSee documentation athttps://kivymd.readthedocs.ioWiki with examples of using KivyMD widgets:https://github.com/kivymd/KivyMD/wikiDemosKitchen sinkapp demonstrates every KivyMD widget.
You can see how to use widget in code of app.Comparison of Flutter & KivyMDSky View ConceptHealthy Food DeliveryAsics Shoes ConceptFacebook Desktop RedesignUse MVC and Hot ReloadSupportIf you need assistance or you have a question, you can ask for help on our mailing list:Discord server:https://discord.gg/wu3qBST(English #support, Russian #ru-support)StackOverflow tag:kivymdEmail:KivyMD-library@yandex.comSettingsSyntax highlighting and auto-completion for Kivy/KivyMD .kv files in PyCharm/Intellij IDEAPromo VideoContributingWe always welcome yourBug reports,Feature requestsandPull requests!
Check outCONTRIBUTING.mdand feel free to improve KivyMD.Setup environmentWe recommend you to use PyCharm to work with KivyMD code. InstallKivyand
development dependencies to your virtual environment:pipinstall-e.[dev,docs]pre-commitinstallFormat all files and run tests:pre-commitrun--all-files
pytestkivymd/tests--timeout=600--cov=kivymd--cov-report=termpre-commit will format modified files with Black and sort imports with isort.Sister projectsKivyMD ExtensionsAdditional extensions for the KivyMD library.https://github.com/kivymd-extensionsKivyMDBuilderBuild apps visually.https://github.com/kivymd/KivyMDBuilderLicenseKivyMD is released under the terms of theMIT License,
same asKivy.Roboto fontis licensed and distributed under the terms of theApache License, Version 2.0.Iconic fontby theMaterial Design Iconscommunity covered bySIL Open Font License 1.1ContributorsKivyMD TeamThey spent a lot of time to improve KivyMD.Yuri Ivanov@HeaTTheatR- Core developerArtem Bulgakov@ArtemSBulgakov- Technical administrator, contributorAndrés Rodríguez@mixedCase- First author of KivyMD project, contributorCode ContributorsThis project exists thanks to all the people who contribute.How to contributeFinancial ContributorsBecome a financial contributoron OpenCollective and help us sustain our community.Gold SponsorsBecome a Gold Sponsorand get your logo on our Readme with a link to your website.BackersBecome a Backerif you want to help develop this project.