Skip to content

kivymd-extensions/akivymd

Repository files navigation

Awesome KivyMD

Awesome KivyMD is a package containing customized and non-material widgets for KivyMD.

Installation

pip install kivymd_extensions.akivymd

#or

pip install https://github.com/kivymd-extensions/akivymd/archive/main.zip

Usage with Buildozer

requirements = https://github.com/kivymd-extensions/akivymd/archive/main.zip

Dependencies:

NOTE: It's recommened to install the most recent version of KivyMD from master:

pip install https://github.com/kivymd/KivyMD/archive/refs/heads/master.zip

WARNING: akivymd is not fully tested with python 3.11+

Documentation

Usage

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

git clone https://github.com/kivymd-extensions/akivymd.git
cd akivymd
cd examples/full_example
python main.py

Build Docs

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:

License

MIT License