# Awesome KivyMD
Awesome KivyMD is a package containing customized and non-material widgets for KivyMD.
<p align="center">
<img align="center" width="512" src="https://raw.githubusercontent.com/quitegreensky/akivymd/master/images/preview.gif"/>
</p>
## Installation
```bash
pip install kivymd_extensions.akivymd
#or
pip install https://github.com/kivymd-extensions/akivymd/archive/main.zip
```
## Usage with Buildozer
```bash
requirements = https://github.com/kivymd-extensions/akivymd/archive/main.zip
```
### Dependencies:
- [KivyMD](https://github.com/kivymd/KivyMD) >= 0.104.2 (from master branch)
- [Kivy](https://github.com/kivy/kivy) >= 1.11.1 ([Installation](https://kivy.org/doc/stable/gettingstarted/installation.html))
- [Python 3.6+](https://www.python.org/)
## Documentation
### Usage
```python
from kivy.lang import Builder
from kivymd.app import MDApp
import kivymd_extensions.akivymd
KV = """
<NavigationButton@Button_Item>
icon_color: app.theme_cls.text_color
text_color: app.theme_cls.text_color
button_bg_color: app.theme_cls.primary_color
mode: 'color_on_active'
badge_disabled: True
MDScreen:
AKBottomNavigation2:
bg_color: app.theme_cls.bg_darkest
NavigationButton:
text: 'Alert'
icon: 'bell-outline'
NavigationButton:
text: 'Bank'
icon: 'bank-outline'
NavigationButton:
text: 'Download'
icon: 'arrow-down-bold-outline'
"""
class Test(MDApp):
def build(self):
return Builder.load_string(KV)
Test().run()
```
## Examples
```bash
git clone https://github.com/kivymd-extensions/akivymd.git
cd akivymd
cd examples/full_example
python main.py
```
## Build Docs
```bash
git clone https://github.com/kivymd-extensions/akivymd.git
cd docs
sphinx-build -b html sources ./_build
```
## Support
If you need assistance or you have a question, you can ask for help on our mailing list:
- **Discord server:** https://discord.gg/wu3qBST
- _Email:_ kivydevelopment@gmail.com
## License
[MIT License](LICENSE)
Raw data
{
"_id": null,
"home_page": "https://github.com/kivymd-extensions/akivymd",
"name": "kivymd-extensions.akivymd",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "kivymd_extensions,kivymd,kivy,material,ui",
"author": "quitegreensky, KivyMD Team and other contributors",
"author_email": "quitegreensky@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/53/af/d0c4eda39c5e9336ab9aacc9627cde88d8f72f84658d9b5671c152893832/kivymd_extensions.akivymd-1.2.7.tar.gz",
"platform": "any",
"description": "# Awesome KivyMD\n\nAwesome KivyMD is a package containing customized and non-material widgets for KivyMD.\n\n<p align=\"center\">\n <img align=\"center\" width=\"512\" src=\"https://raw.githubusercontent.com/quitegreensky/akivymd/master/images/preview.gif\"/>\n</p>\n\n## Installation\n\n```bash\npip install kivymd_extensions.akivymd\n\n#or\n\npip install https://github.com/kivymd-extensions/akivymd/archive/main.zip\n```\n\n## Usage with Buildozer\n\n```bash\nrequirements = https://github.com/kivymd-extensions/akivymd/archive/main.zip\n```\n\n### Dependencies:\n\n- [KivyMD](https://github.com/kivymd/KivyMD) >= 0.104.2 (from master branch)\n- [Kivy](https://github.com/kivy/kivy) >= 1.11.1 ([Installation](https://kivy.org/doc/stable/gettingstarted/installation.html))\n- [Python 3.6+](https://www.python.org/)\n\n## Documentation\n\n### Usage\n\n```python\nfrom kivy.lang import Builder\n\nfrom kivymd.app import MDApp\nimport kivymd_extensions.akivymd\n\nKV = \"\"\"\n<NavigationButton@Button_Item>\n icon_color: app.theme_cls.text_color\n text_color: app.theme_cls.text_color\n button_bg_color: app.theme_cls.primary_color\n mode: 'color_on_active'\n badge_disabled: True\n\n\nMDScreen:\n\n AKBottomNavigation2:\n bg_color: app.theme_cls.bg_darkest\n\n NavigationButton:\n text: 'Alert'\n icon: 'bell-outline'\n\n NavigationButton:\n text: 'Bank'\n icon: 'bank-outline'\n\n NavigationButton:\n text: 'Download'\n icon: 'arrow-down-bold-outline'\n\"\"\"\n\n\nclass Test(MDApp):\n def build(self):\n return Builder.load_string(KV)\n\n\nTest().run()\n```\n\n## Examples\n\n```bash\ngit clone https://github.com/kivymd-extensions/akivymd.git\ncd akivymd\ncd examples/full_example\npython main.py\n```\n\n## Build Docs\n\n```bash\ngit clone https://github.com/kivymd-extensions/akivymd.git\ncd docs\nsphinx-build -b html sources ./_build\n```\n\n## Support\n\nIf you need assistance or you have a question, you can ask for help on our mailing list:\n\n- **Discord server:** https://discord.gg/wu3qBST\n- _Email:_ kivydevelopment@gmail.com\n\n## License\n\n[MIT License](LICENSE)\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A set of fancy widgets for KivyMD",
"version": "1.2.7",
"project_urls": {
"Homepage": "https://github.com/kivymd-extensions/akivymd",
"Tracker": "https://github.com/kivymd-extensions/akivymd/issues"
},
"split_keywords": [
"kivymd_extensions",
"kivymd",
"kivy",
"material",
"ui"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "8edba364664d5a7c88fd68966b8affc75a8657b7742678c49c91f9699f263b77",
"md5": "23cb024c33375d3d88ce23a24c115f7d",
"sha256": "b29c91e955983811b4bccbb0e3b582f221c0d44261c62ce154dcbd124b70070d"
},
"downloads": -1,
"filename": "kivymd_extensions.akivymd-1.2.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "23cb024c33375d3d88ce23a24c115f7d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 56175,
"upload_time": "2023-06-26T22:42:38",
"upload_time_iso_8601": "2023-06-26T22:42:38.685413Z",
"url": "https://files.pythonhosted.org/packages/8e/db/a364664d5a7c88fd68966b8affc75a8657b7742678c49c91f9699f263b77/kivymd_extensions.akivymd-1.2.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "53afd0c4eda39c5e9336ab9aacc9627cde88d8f72f84658d9b5671c152893832",
"md5": "fbc701a33f99ca091e7f657177157caa",
"sha256": "417d9dca6872fdcea006d387b2f7434c682c53f16c35ed8418b38b6cf1c95d38"
},
"downloads": -1,
"filename": "kivymd_extensions.akivymd-1.2.7.tar.gz",
"has_sig": false,
"md5_digest": "fbc701a33f99ca091e7f657177157caa",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 38763,
"upload_time": "2023-06-26T22:42:40",
"upload_time_iso_8601": "2023-06-26T22:42:40.171728Z",
"url": "https://files.pythonhosted.org/packages/53/af/d0c4eda39c5e9336ab9aacc9627cde88d8f72f84658d9b5671c152893832/kivymd_extensions.akivymd-1.2.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-06-26 22:42:40",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "kivymd-extensions",
"github_project": "akivymd",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "kivymd-extensions.akivymd"
}
JSON
