Merge pull request #1 from Bitmessage/v0.6

qq

.travis.yml

@@ -8,4 +8,6 @@ addons:
       - libcap-dev
 install:
   - python setup.py install
-script: pybitmessage -t
+script:
+  - python checkdeps.py
+  - pybitmessage -t

README.md

@@ -19,7 +19,7 @@ pseudo-mailing list:
 BM-2D9QKN4teYRvoq2fyzpiftPh9WP9qggtzh
 
 Feel welcome to join chan "bitmessage", BM-2cWy7cvHoq3f1rYMerRJp8PT653jjSuEdY 
-which is on preview here: http://beamstat.com/chan/bitmessage
+which is on preview here: https://beamstat.com/chan/bitmessage
 
 References
 ----------

android_instruction.rst

@@ -0,0 +1,43 @@
+PyBitmessage(Android)
+
+This sample aims to be as close to a real world example of a mobile. It has a more refined design and also provides a practical example of how a mobile app would interact and communicate with its adresses.
+
+Steps for trying out this sample:
+
+Compile and install the mobile app onto your mobile device or emulator.
+
+
+Getting Started
+
+This sample uses the kivy as Kivy is an open source, cross-platform Python framework for the development of applications that make use of innovative, multi-touch user interfaces. The aim is to allow for quick and easy interaction design and rapid prototyping whilst making your code reusable and deployable.
+
+Kivy is written in Python and Cython, supports various input devices and has an extensive widget library. With the same codebase, you can target Windows, OS X, Linux, Android and iOS. All Kivy widgets are built with multitouch support. 
+
+Kivy in support take Buildozer which is a tool that automates the entire build process. It downloads and sets up all the prequisites for python-for-android, including the android SDK and NDK, then builds an apk that can be automatically pushed to the device.
+
+Buildozer currently works only in Linux, and is an alpha release, but it already works well and can significantly simplify the apk build.
+
+To build this project, use the "Buildozer android release deploy run" command or use.
+Buildozer ue=sed for creating application packages easily.The goal is to have one "buildozer.spec" file in your app directory, describing your application requirements and settings such as title, icon, included modules etc. Buildozer will use that spec to create a package for Android, iOS, Windows, OSX and/or Linux.
+
+Installing Requirements
+
+You can create a package for android using the python-for-android project as with using the Buildozer tool to automate the entire process. You can also see Packaging your application for the Kivy Launcher to run kivy programs without compiling them.
+
+You can get buildozer at https://github.com/kivy/buildozer or you can directly install using pip install buildozer
+
+This will install buildozer in your system. Afterwards, navigate to your project directory and run:
+
+buildozer init
+
+This creates a buildozer.spec file controlling your build configuration. You should edit it appropriately with your app name etc. You can set variables to control most or all of the parameters passed to python-for-android.
+
+Install buildozer’s dependencies.
+
+Finally, plug in your android device and run:
+
+buildozer android debug deploy run >> To build, push and automatically run the apk on your device. Here we used debug as tested in debug mode for now.
+
+Packaging your application for the Kivy Launcher
+
+

checkdeps.py

@@ -11,6 +11,7 @@ Limitations:
 """
 
 import os
+import sys
 from distutils.errors import CompileError
 try:
     from setuptools.dist import Distribution
@@ -136,6 +137,8 @@ if prereqs:
 OPSYS = detectOS()
 CMD = PACKAGE_MANAGER[OPSYS] if OPSYS in PACKAGE_MANAGER else 'UNKNOWN_INSTALLER'
 for lhs, rhs in EXTRAS_REQUIRE.items():
+    if OPSYS is None:
+        break
     if rhs and any([
         EXTRAS_REQUIRE_DEPS[x][OPSYS]
         for x in rhs
@@ -161,5 +164,7 @@ if (not compiler or prereqs) and OPSYS in PACKAGE_MANAGER:
     if not compiler:
         compilerToPackages()
     prereqToPackages()
+    if mandatory:
+        sys.exit(1)
 else:
     print("All the dependencies satisfied, you can install PyBitmessage")

setup.cfg

@@ -11,7 +11,11 @@ ignore = E722,F841
 # F841: pylint is preferred for unused-variable
 
 # pylint honours the [MESSAGES CONTROL] section
+# as well as [MASTER] section
 [MESSAGES CONTROL]
 disable=invalid-name,bare-except,broad-except
 # invalid-name: needs fixing during a large, project-wide refactor
 # bare-except,broad-except: Need fixing once thorough testing is easier
+
+[MASTER]
+init-hook = import sys;sys.path.append('src')

src/bitmessagekivy/kivy_helper_search.py

@@ -0,0 +1,45 @@
+from helper_sql import *
+
+
+def search_sql(xAddress="toaddress", account=None, folder="inbox", where=None, what=None, unreadOnly=False):
+    if what is not None and what != "":
+        what = "%" + what + "%"
+    else:
+        what = None
+
+    if folder == "sent":
+        sqlStatementBase = '''
+            SELECT toaddress, fromaddress, subject, status, ackdata, lastactiontime 
+            FROM sent '''
+    else:
+        sqlStatementBase = '''SELECT folder, msgid, toaddress, fromaddress, subject, received, read
+            FROM inbox '''
+    sqlStatementParts = []
+    sqlArguments = []
+    if account is not None:
+        if xAddress == 'both':
+            sqlStatementParts.append("(fromaddress = ? OR toaddress = ?)")
+            sqlArguments.append(account)
+            sqlArguments.append(account)
+        else:
+            sqlStatementParts.append(xAddress + " = ? ")
+            sqlArguments.append(account)
+    if folder is not None:
+        if folder == "new":
+            folder = "inbox"
+            unreadOnly = True
+        sqlStatementParts.append("folder = ? ")
+        sqlArguments.append(folder)
+    else:
+        sqlStatementParts.append("folder != ?")
+        sqlArguments.append("trash")
+    if what is not None:
+        sqlStatementParts.append("%s LIKE ?" % (where))
+        sqlArguments.append(what)
+    if unreadOnly:
+        sqlStatementParts.append("read = 0")
+    if len(sqlStatementParts) > 0:
+        sqlStatementBase += "WHERE " + " AND ".join(sqlStatementParts)
+    if folder == "sent":
+        sqlStatementBase += " ORDER BY lastactiontime"
+    return sqlQuery(sqlStatementBase, sqlArguments)

src/bitmessagekivy/main.kv

@@ -1,167 +1,354 @@
-#:import FadeTransition kivy.uix.screenmanager.FadeTransition
+#:import la kivy.adapters.listadapter
+#:import factory kivy.factory
+#:import mpybit bitmessagekivy.mpybit
+#:import C kivy.utils.get_color_from_hex
 
-<Display>:
-    BoxLayout:
-        orientation: "vertical"
-        BoxLayout: 
-            size_hint: 1, None
-            height: '48dp'
-            Button:
-                text: 'messages'
-                on_release: sm.current = 'screen_one'
-                background_color: (0,0,0,0)
-                color: 0,0,0,1
-            Button:
-                text: 'send'
-                on_release: sm.current = 'screen_two'
-                background_color: (0,0,0,0)
-                color: 0,0,0,1
-            Button:
-                text: 'subscription'
-                on_release: sm.current = 'screen_three'
-                background_color: (0,0,0,0)
-                color: 0,0,0,1
-            Button:
-                text: 'four'
-                on_release: sm.current = 'screen_four'
-                background_color: (0,0,0,0) 
-                color: 0,0,0,1
+<Navigator>:
+    id: nav_drawer
+    NavigationDrawerIconButton:
+        Spinner:
+            pos_hint:{"x":0,"y":.3}
+            id: btn
+            background_color: app.theme_cls.primary_dark
+            text: app.showmeaddresses(name='text')
+            values: app.showmeaddresses(name='values')
+            on_text:app.getCurrentAccountData(self.text)
 
-            Button:
-                text: 'chans'
-                on_release: sm.current = 'screen_five'
-                background_color: (0,0,0,0) 
-                color: 0,0,0,1
-            Button:
-                text: 'blacklist'
-                on_release: sm.current = 'screen_six'
-                background_color: (0,0,0,0) 
-                color: 0,0,0,1
-
-        ScreenManager:
-            id: sm
-            transition: FadeTransition()
-            Screen_One:
-            Screen_Two:
-            Screen_three:
-            Screen_four:
-            Screen_five:
-            Screen_six:
-            EmailScreen:
-
-<Screen_One>:
-    name: 'screen_one'      
-    BoxLayout:
-        padding: 10,10,10,300
-        orientation: "vertical"
+    NavigationDrawerIconButton:
+        icon: 'email-open'
+        text: "inbox"
+        on_release: app.root.ids.scr_mngr.current = 'inbox'
+    NavigationDrawerIconButton:
+        icon: 'mail-send'
+        text: "sent"
+        on_release: app.root.ids.scr_mngr.current = 'sent'
+    NavigationDrawerIconButton:
+        icon: 'dropbox'
+        text: "trash"
+        on_release: app.root.ids.scr_mngr.current = 'trash'
+    NavigationDrawerIconButton:
+        icon: 'email'
+        text: "drafts"
+        on_release: app.root.ids.scr_mngr.current = 'dialog'
+    NavigationDrawerIconButton:
+        icon: 'markunread-mailbox'
+        text: "test"
+        on_release: app.root.ids.scr_mngr.current = 'test'
+    NavigationDrawerIconButton: 
+        text: "new identity"
+        icon:'accounts-add'
+        on_release: app.root.ids.scr_mngr.current = 'newidentity'
+    
+BoxLayout:
+    orientation: 'vertical'
+    Toolbar:
+        id: toolbar
+        title: app.getCurrentAccount()
+        background_color: app.theme_cls.primary_dark
+        left_action_items: [['menu', lambda x: app.nav_drawer.toggle()]]
         Button:
-            text: "create"
-            size_hint_y: 0.3
-            size_hint_x: 0.1
+            text:"EXIT"
             color: 0,0,0,1
             background_color: (0,0,0,0)
-        Button:
-            text: "inbox"
-            background_color: (0,0,0,0)
-            size_hint_y: 0.3
+            size_hint_y: 0.4
             size_hint_x: 0.1
-            color: 0,0,0,1
-        Button:
-            text: "new"
-            background_color: (0,0,0,0)
-            size_hint_y: 0.3
-            size_hint_x: 0.1
-            color: 0,0,0,1
-            on_press:
-                root.manager.current = 'email'
-        Button:
-            text: "sents"
-            background_color: (0,0,0,0)
-            size_hint_y: 0.3
-            size_hint_x: 0.1
-            color: 0,0,0,1
+            pos_hint: {'x': 0.8, 'y':0.4}
+            on_press: app.say_exit()
 
-<Screen_Two>:
-    name: 'screen_two'      
-    Label:
-        text: "Two"
 
-<Screen_three>:
-    name: 'screen_three'      
-    Label:
-        text: "Three"
+    ScreenManager:
+        id: scr_mngr
+        Inbox:
+            id:sc1
+        Sent:
+            id:sc2
+        Trash:
+            id:sc3
+        Dialog:
+            id:sc4
+        Test:
+            id:sc5
+        Create:
+            id:sc6
+        NewIdentity:
+            id:sc7
+        Page:
+            id:sc8
+        AddressSuccessful:
+            id:sc9
 
-<Screen_four>:
-    name: 'screen_four'      
-    Label:
-        text: "four"
+    Button:
+        id:create
+        height:100
+        size_hint_y: 0.13
+        size_hint_x: 0.1
+        pos_hint: {'x': 0.85, 'y': 0.5}
+        background_color: (0,0,0,0)
+        on_press: scr_mngr.current = 'create'
+        Image:
+            source: 'images/plus.png'
+            y: self.parent.y - 7.5
+            x: self.parent.x + self.parent.width - 50
+            size: 70, 70
 
-<Screen_five>:
-    name: 'screen_five'      
-    Label:
-        text: "Two"
+<SwipeButton@Carousel>:
+    text: ''
+    size_hint_y: None
+    height: 48
+    ignore_perpendicular_swipes: True
+    data_index: 0
+    min_move: 20 / self.width
 
-<Screen_six>:
-    name: 'screen_six'      
-    Label:
-        text: "Two"
+    on__offset: app.update_index(root.data_index, self.index)
 
-<EmailScreen>:
-    name: 'email'
-    BoxLayout:
-        padding: 100,10,100,100
-        id: login_layout
-        orientation: "vertical"
-        GridLayout:
-            rows: 2
+    canvas.before:
+        Color:
+            rgba: C('FFFFFF33')
+
+        Rectangle:
+            pos: self.pos
+            size: self.size
+
+        Line:
+            rectangle: self.pos + self.size
+
+    Button:
+        text: 'delete ({}:{})'.format(root.text, root.data_index)
+        on_press: app.delete(root.data_index)
+
+    Button:
+        text: root.text
+        on_press: app.getInboxMessageDetail(self.text)
+
+    Button:
+        text: 'archive'
+        on_press: app.archive(root.data_index)
+
+<Inbox>:
+    name: 'inbox'
+    RecycleView:
+        data: root.data
+        viewclass: 'SwipeButton'
+        do_scroll_x: False
+        scroll_timeout: 100
+
+        RecycleBoxLayout:
+            id:rc
             orientation: 'vertical'
-            spacing: 10
-            Label:
-                text: 'From: '
-                background_color: (0,0,0,0)
-                color: 0,0,0,1
-                font_size: 18
-                pos_hint: {"x":.15,"y":1}
-                text_size: root.width-20, 20
+            size_hint_y: None
+            height: self.minimum_height
+            default_size_hint: 1, None
+            canvas.before:
+                Color:
+                    rgba: 0,0,0, 1
+                Rectangle:
+                    pos: self.pos
+                    size: self.size
 
-            TextInput:
-                multiline:False
-                size_hint: 1,.4
+<Sent>:
+    name: 'sent'
+    RecycleView:
+        data: root.data
+        viewclass: 'SwipeButton'
+        do_scroll_x: False
+        scroll_timeout: 100
 
-        GridLayout:
-            rows: 2
+        RecycleBoxLayout:
+            id:rc
             orientation: 'vertical'
-            Label:
-                text: 'To: '
-                background_color: (0,0,0,0)
-                color: 0,0,0,1
-                font_size: 18
-                pos_hint: {"x":.15,"y":.5}
-                text_size: root.width-20, 20
+            size_hint_y: None
+            height: self.minimum_height
+            default_size_hint: 1, None
+            canvas.before:
+                Color:
+                    rgba: 0,0,0, 1
+                Rectangle:
+                    pos: self.pos
+                    size: self.size
 
-            TextInput:
-                multiline:False
-                size_hint: 1,.4
-                pos_hint: {"x":.2,"y":.5}
+<Trash>:
+    name: 'trash'
+    RecycleView:
+        data: root.data
+        viewclass: 'SwipeButton'
+        do_scroll_x: False
+        scroll_timeout: 100
 
-        GridLayout:
-            rows: 2
+        RecycleBoxLayout:
+            id:rc
             orientation: 'vertical'
-            Label:
-                text: 'Message'
-                background_color: (0,0,0,0)
-                color: 0,0,0,1
-                pos_hint: {"x":.15,"y":.5}
-                font_size: 18
-                text_size: root.width-20, 20
+            size_hint_y: None
+            height: self.minimum_height
+            default_size_hint: 1, None
+            canvas.before:
+                Color:
+                    rgba: 0,0,0, 1
+                Rectangle:
+                    pos: self.pos
+                    size: self.size
 
+<Dialog>:
+    name: 'dialog'
+    Label:
+        text:"I have a good dialox box"
+        color: 0,0,0,1
+<Test>:
+    name: 'test'
+    Label:
+        text:"I am in test"
+        color: 0,0,0,1
+
+<Create>:
+    name: 'create'
+    GridLayout:
+        rows: 5
+        cols: 1
+        padding: 60,60,60,60
+        spacing: 50
+        BoxLayout:
+            size_hint_y: None
+            height: '32dp'
+            Label:
+                text: 'FROM'
+                color: 0,0,0,1
+            Spinner:
+                size_hint: 1,1
+                pos_hint: {"x":0,"top":1.}
+                pos: 10,10
+                id: spinner_id
+                text: app.showmeaddresses(name='text')
+                values: app.showmeaddresses(name='values')
+
+        BoxLayout:
+            size_hint_y: None
+            height: '32dp'
+            Label:
+                text: 'TO'
+                color: 0,0,0,1
             TextInput:
-                id: msg
+                id: recipent
+                hint_text: 'To'
+
+        BoxLayout:
+            size_hint_y: None
+            height: '32dp'
+            Label:
+                text: 'SUBJECT'
+                color: 0,0,0,1
+            TextInput:
+                id: subject
+                hint_text: 'SUBJECT'
+
+        BoxLayout:
+            size_hint_y: None
+            height: '32dp'
+            Label:
+                text: 'BODY'
+                color: 0,0,0,1
+            TextInput:
+                id: message
                 multiline:True
                 size_hint: 1,2
 
-        Button:
-            text: "SEND"
-            size_hint_y: 0.1
-            size_hint_x: 0.2
-            pos_hint: {"x":.15,"y":1}
+    Button:
+        text: 'send'
+        size_hint_y: 0.1
+        size_hint_x: 0.2
+        height: '32dp'
+        pos_hint: {'x': .5, 'y': 0.1}
+        on_press: root.send()
+    Button:
+        text: 'cancel'
+        size_hint_y: 0.1
+        size_hint_x: 0.2
+        height: '32dp'
+        pos_hint: {'x': .72, 'y': 0.1}
+        on_press: root.cancel()
+
+<NewIdentity>:
+    name: 'newidentity'
+    GridLayout:
+        padding: '120dp'
+        cols: 1
+        Label:
+            text:"""Here you may generate as many addresses as you like. Indeed, creating and abandoning addresses is encouraged."""
+            line_height:1.5  
+            text_size:(700,None)  
+            color: 0,0,0,1
+        BoxLayout:
+            CheckBox:
+                canvas.before:
+                    Color:
+                        rgb: 1,0,0
+                    Ellipse:
+                        pos:self.center_x-8, self.center_y-8
+                        size:[16,16]                 
+                group: "money"
+                id:chk
+                text:"use a random number generator to make an address"
+                on_active:
+                    root.checked = self.text
+                active:root.is_active
+
+            Label:
+                text: "use a random number generator to make an address"
+                color: 0,0,0,1
+        BoxLayout:
+            CheckBox:
+                canvas.before:
+                    Color:
+                        rgb: 1,0,0
+                    Ellipse:
+                        pos:self.center_x-8, self.center_y-8
+                        size:[16,16] 
+                group: "money"
+                id:chk
+                text:"use a pseudo number generator to make an address"
+                on_active:
+                    root.checked = self.text
+                active:not root.is_active
+            Label:
+                text: "use a pseudo number generator to make an address"
+                color: 0,0,0,1
+        Label:
+            color: 0,0,0,1
+            size_hint_x: .35
+            markup: True
+            text: "[b]{}[/b]".format("Randomly generated addresses")
+        BoxLayout:
+            size_hint_y: None
+            height: '32dp'
+            Label:
+                text: "Label (not shown to anyone except you)"
+                color: 0,0,0,1
+        BoxLayout:
+            size_hint_y: None
+            height: '32dp'
+            TextInput:
+                id: label
+
+    Button:
+        text: 'Cancel'
+        size_hint_y: 0.1
+        size_hint_x: 0.3
+        height: '32dp'
+        pos_hint: {'x': .1, 'y': 0.1}
+    Button:
+        text: 'Ok'
+        size_hint_y: 0.1
+        size_hint_x: 0.3
+        height: '32dp'
+        pos_hint: {'x': .5, 'y': 0.1}
+        on_press: root.generateaddress()
+
+<Page>:
+    name: 'page'
+    Label:
+        text: 'I am on description of my email yooooo'
+        color: 0,0,0,1
+
+<AddressSuccessful>:
+    name: 'add_sucess'
+    Label:
+        text: 'Successfully created a new bit address'
+        color: 0,0,0,1

src/bitmessagekivy/mpybit.py

@@ -1,48 +1,314 @@
+import kivy_helper_search
+import os
+import queues
+import shutdown
+import state
 import time
 
 from kivy.app import App
-from kivy.core.window import Window
-from kivy.uix.boxlayout import BoxLayout
-# from kivy.uix.gridlayout import GridLayout
-
-from debug import logger
-
-from addresses import addBMIfNotPresent, decodeAddress
-
+from kivy.lang import Builder
+from kivy.properties import BooleanProperty
+from kivy.clock import Clock
+from navigationdrawer import NavigationDrawer
+from kivy.properties import ObjectProperty, StringProperty, ListProperty
+from kivy.uix.screenmanager import Screen
+from kivy.uix.textinput import TextInput
+from kivymd.theming import ThemeManager
+from kivymd.toolbar import Toolbar
 from bmconfigparser import BMConfigParser
-
 from helper_ackPayload import genAckPayload
-
+from addresses import decodeAddress, addBMIfNotPresent
 from helper_sql import sqlExecute
 
-import queues
-
-import shutdown
 statusIconColor = 'red'
 
 
-class LoginScreen(BoxLayout):
-    """This will use for sending message to recipents from mobile client."""
+class NavigateApp(App, TextInput):
+    """Application uses kivy in which base Class of Navigate App inherits from the App class."""
+
+    theme_cls = ThemeManager()
+    nav_drawer = ObjectProperty()
+
+    def build(self):
+        """Return a main_widget as a root widget.
+
+        An application can be built if you return a widget on build(), or if you set
+        self.root.
+        """
+        main_widget = Builder.load_file(
+            os.path.join(os.path.dirname(__file__), 'main.kv'))
+        self.nav_drawer = Navigator()
+        return main_widget
+
+    def getCurrentAccountData(self, text):
+        """Get Current Address Account Data."""
+        state.association = text
+        self.root.ids.sc1.clear_widgets()
+        self.root.ids.sc2.clear_widgets()
+        self.root.ids.sc3.clear_widgets()
+        self.root.ids.sc1.add_widget(Inbox())
+        self.root.ids.sc2.add_widget(Sent())
+        self.root.ids.sc3.add_widget(Trash())
+        self.root.ids.toolbar.title = BMConfigParser().get(
+            state.association, 'label') + '({})'.format(state.association)
+        Inbox()
+        Sent()
+        Trash()
+
+    def say_exit(self):
+        """Exit the application as uses shutdown PyBitmessage."""
+        print("**************************EXITING FROM APPLICATION*****************************")
+        App.get_running_app().stop()
+        shutdown.doCleanShutdown()
+
+    @staticmethod
+    def showmeaddresses(name="text"):
+        """Show the addresses in spinner to make as dropdown."""
+        if name == "text":
+            return BMConfigParser().addresses()[0]
+        elif name == "values":
+            return BMConfigParser().addresses()
+
+    def update_index(self, data_index, index):
+        """Update index after archieve message to trash."""
+        if self.root.ids.scr_mngr.current == 'inbox':
+            self.root.ids.sc1.data[data_index]['index'] = index
+        elif self.root.ids.scr_mngr.current == 'sent':
+            self.root.ids.sc2.data[data_index]['index'] = index
+        elif self.root.ids.scr_mngr.current == 'trash':
+            self.root.ids.sc3.data[data_index]['index'] = index
+
+    def delete(self, data_index):
+        """It will make delete using remove function."""
+        print("delete {}".format(data_index))
+        self._remove(data_index)
+
+    def archive(self, data_index):
+        """It will make archieve using remove function."""
+        print("archive {}".format(data_index))
+        self._remove(data_index)
+
+    def _remove(self, data_index):
+        """It will remove message by resetting the values in recycleview data."""
+        if self.root.ids.scr_mngr.current == 'inbox':
+            self.root.ids.sc1.data.pop(data_index)
+            self.root.ids.sc1.data = [{
+                'data_index': i,
+                'index': d['index'],
+                'height': d['height'],
+                'text': d['text']}
+                for i, d in enumerate(self.root.ids.sc1.data)
+            ]
+        elif self.root.ids.scr_mngr.current == 'sent':
+            self.root.ids.sc2.data.pop(data_index)
+            self.root.ids.sc2.data = [{
+                'data_index': i,
+                'index': d['index'],
+                'height': d['height'],
+                'text': d['text']}
+                for i, d in enumerate(self.root.ids.sc2.data)
+            ]
+        elif self.root.ids.scr_mngr.current == 'trash':
+            self.root.ids.sc3.data.pop(data_index)
+            self.root.ids.sc3.data = [{
+                'data_index': i,
+                'index': d['index'],
+                'height': d['height'],
+                'text': d['text']}
+                for i, d in enumerate(self.root.ids.sc3.data)
+            ]
+
+    def getInboxMessageDetail(self, instance):
+        """It will get message detail after make selected message description."""
+        try:
+            self.root.ids.scr_mngr.current = 'page'
+        except AttributeError:
+            self.parent.manager.current = 'page'
+        print('Message Clicked {}'.format(instance))
+
+    @staticmethod
+    def getCurrentAccount():
+        """It uses to get current account label."""
+        return BMConfigParser().get(state.association, 'label') + '({})'.format(state.association)
+
+
+class Navigator(NavigationDrawer):
+    """Navigator class uses NavigationDrawer.
+
+    It is an UI panel that shows our app's main navigation menu
+    It is hidden when not in use, but appears when the user swipes
+    a finger from the left edge of the screen or, when at the top
+    level of the app, the user touches the drawer icon in the app bar
+    """
+
+    image_source = StringProperty('images/qidenticon_two.png')
+    title = StringProperty('Navigation')
+
+
+class Inbox(Screen):
+    """Inbox Screen uses screen to show widgets of screens."""
+
+    data = ListProperty()
+
+    def __init__(self, *args, **kwargs):
+        super(Inbox, self).__init__(*args, **kwargs)
+        if state.association == '':
+            state.association = Navigator().ids.btn.text
+        Clock.schedule_once(self.init_ui, 0)
+
+    def init_ui(self, dt=0):
+        """Clock Schdule for method inbox accounts."""
+        self.inboxaccounts()
+        print(dt)
+
+    def inboxaccounts(self):
+        """Load inbox accounts."""
+        account = state.association
+        self.loadMessagelist(account, 'All', '')
+
+    def loadMessagelist(self, account, where="", what=""):
+        """Load Inbox list for inbox messages."""
+        xAddress = "toaddress"
+        queryreturn = kivy_helper_search.search_sql(
+            xAddress, account, 'inbox', where, what, False)
+        if queryreturn:
+            self.data = [{
+                'data_index': i,
+                'index': 1,
+                'height': 48,
+                'text': row[4]}
+                for i, row in enumerate(queryreturn)
+            ]
+        else:
+            self.data = [{
+                'data_index': 1,
+                'index': 1,
+                'height': 48,
+                'text': "yet no message for this account!!!!!!!!!!!!!"}
+            ]
+
+
+class Page(Screen):
+    pass
+
+
+class AddressSuccessful(Screen):
+    pass
+
+
+class Sent(Screen):
+    """Sent Screen uses screen to show widgets of screens."""
+
+    data = ListProperty()
+
+    def __init__(self, *args, **kwargs):
+        super(Sent, self).__init__(*args, **kwargs)
+        if state.association == '':
+            state.association = Navigator().ids.btn.text
+        Clock.schedule_once(self.init_ui, 0)
+
+    def init_ui(self, dt=0):
+        """Clock Schdule for method sent accounts."""
+        self.sentaccounts()
+        print(dt)
+
+    def sentaccounts(self):
+        """Load sent accounts."""
+        account = state.association
+        self.loadSent(account, 'All', '')
+
+    def loadSent(self, account, where="", what=""):
+        """Load Sent list for Sent messages."""
+        xAddress = 'fromaddress'
+        queryreturn = kivy_helper_search.search_sql(
+            xAddress, account, "sent", where, what, False)
+        if queryreturn:
+            self.data = [{
+                'data_index': i,
+                'index': 1,
+                'height': 48,
+                'text': row[2]}
+                for i, row in enumerate(queryreturn)
+            ]
+        else:
+            self.data = [{
+                'data_index': 1,
+                'index': 1,
+                'height': 48,
+                'text': "yet no message for this account!!!!!!!!!!!!!"}
+            ]
+
+
+class Trash(Screen):
+    """Trash Screen uses screen to show widgets of screens."""
+
+    data = ListProperty()
+
+    def __init__(self, *args, **kwargs):
+        super(Trash, self).__init__(*args, **kwargs)
+        if state.association == '':
+            state.association = Navigator().ids.btn.text
+        Clock.schedule_once(self.init_ui, 0)
+
+    def init_ui(self, dt=0):
+        """Clock Schdule for method inbox accounts."""
+        self.inboxaccounts()
+        print(dt)
+
+    def inboxaccounts(self):
+        """Load inbox accounts."""
+        account = state.association
+        self.loadTrashlist(account, 'All', '')
+
+    def loadTrashlist(self, account, where="", what=""):
+        """Load Trash list for trashed messages."""
+        xAddress = "toaddress"
+        queryreturn = kivy_helper_search.search_sql(
+            xAddress, account, 'trash', where, what, False)
+        if queryreturn:
+            self.data = [{
+                'data_index': i,
+                'index': 1,
+                'height': 48,
+                'text': row[4]}
+                for i, row in enumerate(queryreturn)
+            ]
+        else:
+            self.data = [{
+                'data_index': 1,
+                'index': 1,
+                'height': 48,
+                'text': "yet no message for this account!!!!!!!!!!!!!"}
+            ]
+
+
+class Dialog(Screen):
+    """Dialog Screen uses screen to show widgets of screens."""
+
+    pass
+
+
+class Test(Screen):
+    """Test Screen uses screen to show widgets of screens."""
+
+    pass
+
+
+class Create(Screen):
+    """Create Screen uses screen to show widgets of screens."""
+
+    def __init__(self, *args, **kwargs):
+        super(Create, self).__init__(*args, **kwargs)
 
     def send(self):
-        """It is used for sending message with subject and body."""
-        queues.apiAddressGeneratorReturnQueue.queue.clear()
-        streamNumberForAddress = 1
-        label = "CisDevelper"
-        eighteenByteRipe = False
-        nonceTrialsPerByte = 1000
-        payloadLengthExtraBytes = 1000
-        queues.addressGeneratorQueue.put((
-            'createRandomAddress', 4,
-            streamNumberForAddress, label, 1,
-            "", eighteenByteRipe, nonceTrialsPerByte,
-            payloadLengthExtraBytes
-        ))
-        fromAddress = queues.apiAddressGeneratorReturnQueue.get()
+        """Send message from one address to another."""
+        fromAddress = self.ids.spinner_id.text
+        # For now we are using static address i.e we are not using recipent field value.
         toAddress = "BM-2cWyUfBdY2FbgyuCb7abFZ49JYxSzUhNFe"
-        message = self.ids.user_input.text
-        subject = 'Test'
+        message = self.ids.message.text
+        subject = self.ids.subject.text
         encoding = 3
+        print("message: ", self.ids.message.text)
         sendMessageToPeople = True
         if sendMessageToPeople:
             if toAddress != '':
@@ -52,14 +318,15 @@ class LoginScreen(BoxLayout):
                     toAddress = addBMIfNotPresent(toAddress)
 
                     if addressVersionNumber > 4 or addressVersionNumber <= 1:
-                        logger.info("addressVersionNumber > 4 or addressVersionNumber <= 1")
+                        print("addressVersionNumber > 4 or addressVersionNumber <= 1")
                     if streamNumber > 1 or streamNumber == 0:
-                        logger.info("streamNumber > 1 or streamNumber == 0")
+                        print("streamNumber > 1 or streamNumber == 0")
                     if statusIconColor == 'red':
-                        logger.info("shared.statusIconColor == 'red'")
+                        print("shared.statusIconColor == 'red'")
                     stealthLevel = BMConfigParser().safeGetInt(
                         'bitmessagesettings', 'ackstealthlevel')
                     ackdata = genAckPayload(streamNumber, stealthLevel)
+                    t = ()
                     sqlExecute(
                         '''INSERT INTO sent VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,?)''',
                         '',
@@ -77,21 +344,50 @@ class LoginScreen(BoxLayout):
                         'sent',
                         encoding,
                         BMConfigParser().getint('bitmessagesettings', 'ttl'))
+                    toLabel = ''
                     queues.workerQueue.put(('sendmessage', toAddress))
+                    print("sqlExecute successfully #####    ##################")
+                    self.ids.message.text = ''
+                    self.ids.spinner_id.text = '<select>'
+                    self.ids.subject.text = ''
+                    self.ids.recipent.text = ''
                     return None
 
-    def sayexit(self):
-        """Method will exit the application screen."""
-        shutdown.doCleanShutdown()
-        Window.close()
+    def cancel(self):
+        """Reset values for send message."""
+        self.ids.message.text = ''
+        self.ids.spinner_id.text = '<select>'
+        self.ids.subject.text = ''
+        self.ids.recipent.text = ''
+        return None
 
 
-class MainApp(App):
-    """The App class is the base for creating Kivy applications
-    Think of it as your main entry point into the Kivy run loop."""
+class NewIdentity(Screen):
+    """Create new address for PyBitmessage."""
 
-    def build(self):
-        """To initialize an app with a widget tree, we need to override the build().
-        method in our app class and return the widget tree which we have constructed..
-        """
-        return LoginScreen()
+    is_active = BooleanProperty(False)
+    checked = StringProperty("")
+    # self.manager.parent.ids.create.children[0].source = 'images/plus-4-xxl.png'
+
+    def generateaddress(self):
+        """Generate new address."""
+        if self.checked == 'use a random number generator to make an address':
+            queues.apiAddressGeneratorReturnQueue.queue.clear()
+            streamNumberForAddress = 1
+            label = self.ids.label.text
+            eighteenByteRipe = False
+            nonceTrialsPerByte = 1000
+            payloadLengthExtraBytes = 1000
+
+            queues.addressGeneratorQueue.put((
+                'createRandomAddress',
+                4, streamNumberForAddress,
+                label, 1, "", eighteenByteRipe,
+                nonceTrialsPerByte,
+                payloadLengthExtraBytes)
+            )
+            self.manager.current = 'add_sucess'
+
+
+if __name__ == '__main__':
+    NavigateApp().run()

src/bitmessagemain.py

@@ -398,8 +398,8 @@ class Main:
                 bitmessagecurses.runwrapper()
             elif state.kivy:
                 BMConfigParser().remove_option('bitmessagesettings', 'dontconnect')
-                from bitmessagekivy.mpybit import MainApp
-                MainApp().run()
+                from bitmessagekivy.mpybit import NavigateApp
+                NavigateApp().run()
             else:
                 import bitmessageqt
                 bitmessageqt.run()

src/bitmessageqt/__init__.py

@@ -2581,7 +2581,7 @@ class MyForm(settingsmixin.SMainWindow):
                 os.remove(state.appdata + 'knownnodes.dat')
                 previousAppdataLocation = state.appdata
                 state.appdata = paths.lookupExeFolder()
-                debug.restartLoggingInUpdatedAppdataLocation()
+                debug.resetLogging()
                 try:
                     os.remove(previousAppdataLocation + 'debug.log')
                     os.remove(previousAppdataLocation + 'debug.log.1')
@@ -2599,7 +2599,7 @@ class MyForm(settingsmixin.SMainWindow):
                 knownnodes.saveKnownNodes(state.appdata)
                 os.remove(paths.lookupExeFolder() + 'keys.dat')
                 os.remove(paths.lookupExeFolder() + 'knownnodes.dat')
-                debug.restartLoggingInUpdatedAppdataLocation()
+                debug.resetLogging()
                 try:
                     os.remove(paths.lookupExeFolder() + 'debug.log')
                     os.remove(paths.lookupExeFolder() + 'debug.log.1')
@@ -2684,6 +2684,19 @@ class MyForm(settingsmixin.SMainWindow):
     def network_switch(self):
         dontconnect_option = not BMConfigParser().safeGetBoolean(
             'bitmessagesettings', 'dontconnect')
+        reply = QtGui.QMessageBox.question(
+            self, _translate("MainWindow", "Disconnecting")
+            if dontconnect_option else _translate("MainWindow", "Connecting"),
+            _translate(
+                "MainWindow",
+                "Bitmessage will now drop all connectins. Are you sure?"
+            ) if dontconnect_option else _translate(
+                "MainWindow",
+                "Bitmessage will now start connecting to network. Are you sure?"
+            ), QtGui.QMessageBox.Yes | QtGui.QMessageBox.Cancel,
+            QtGui.QMessageBox.Cancel)
+        if reply != QtGui.QMessageBox.Yes:
+            return
         BMConfigParser().set(
             'bitmessagesettings', 'dontconnect', str(dontconnect_option))
         BMConfigParser().save()

src/debug.py

@@ -23,6 +23,7 @@ Use: `from debug import logger` to import this facility into whatever module you
 
 """
 
+import ConfigParser
 import logging
 import logging.config
 import os
@@ -44,28 +45,26 @@ def log_uncaught_exceptions(ex_cls, ex, tb):
 
 
 def configureLogging():
-    have_logging = False
+    fail_msg = ''
     try:
-        logging.config.fileConfig(os.path.join(state.appdata, 'logging.dat'))
-        have_logging = True
-        print(
-            'Loaded logger configuration from %s' %
-            os.path.join(state.appdata, 'logging.dat'))
-    except:
-        if os.path.isfile(os.path.join(state.appdata, 'logging.dat')):
-            print(
-                'Failed to load logger configuration from %s, using default'
-                ' logging config\n%s' %
-                (os.path.join(state.appdata, 'logging.dat'), sys.exc_info()))
+        logging_config = os.path.join(state.appdata, 'logging.dat')
+        logging.config.fileConfig(logging_config)
+        return (
+            False,
+            'Loaded logger configuration from %s' % logging_config
+        )
+    except (OSError, ConfigParser.NoSectionError):
+        if os.path.isfile(logging_config):
+            fail_msg = \
+                'Failed to load logger configuration from %s, using default' \
+                ' logging config\n%s' % \
+                (logging_config, sys.exc_info())
         else:
             # no need to confuse the user if the logger config is missing entirely
-            print "Using default logger configuration"
+            fail_msg = 'Using default logger configuration'
 
     sys.excepthook = log_uncaught_exceptions
 
-    if have_logging:
-        return False
-
     logging.config.dictConfig({
         'version': 1,
         'formatters': {
@@ -84,7 +83,7 @@ def configureLogging():
                 'class': 'logging.handlers.RotatingFileHandler',
                 'formatter': 'default',
                 'level': log_level,
-                'filename': state.appdata + 'debug.log',
+                'filename': os.path.join(state.appdata, 'debug.log'),
                 'maxBytes': 2097152,  # 2 MiB
                 'backupCount': 1,
                 'encoding': 'UTF-8',
@@ -109,26 +108,28 @@ def configureLogging():
             'handlers': ['console'],
         },
     })
-    return True
 
+    return True, fail_msg
 
-# TODO (xj9): Get from a config file.
-# logger = logging.getLogger('console_only')
 
 def initLogging():
-    if configureLogging():
+    preconfigured, msg = configureLogging()
+    if preconfigured:
         if '-c' in sys.argv:
             logger = logging.getLogger('file_only')
         else:
             logger = logging.getLogger('both')
     else:
         logger = logging.getLogger('default')
+
+    if msg:
+        logger.log(logging.WARNING if preconfigured else logging.INFO, msg)
     return logger
 
 
-def restartLoggingInUpdatedAppdataLocation():
+def resetLogging():
     global logger
-    for i in list(logger.handlers):
+    for i in logger.handlers.iterkeys():
         logger.removeHandler(i)
         i.flush()
         i.close()

src/depends.py

@@ -19,16 +19,16 @@ import os
 from importlib import import_module
 
 # We can now use logging so set up a simple configuration
-formatter = logging.Formatter(
-    '%(levelname)s: %(message)s'
-)
+formatter = logging.Formatter('%(levelname)s: %(message)s')
 handler = logging.StreamHandler(sys.stdout)
 handler.setFormatter(formatter)
 logger = logging.getLogger('both')
 logger.addHandler(handler)
 logger.setLevel(logging.ERROR)
 
+
 OS_RELEASE = {
+    "Debian GNU/Linux".lower(): "Debian",
     "fedora": "Fedora",
     "opensuse": "openSUSE",
     "ubuntu": "Ubuntu",
@@ -137,7 +137,7 @@ def detectOSRelease():
         for line in osRelease:
             if line.startswith("NAME="):
                 detectOS.result = OS_RELEASE.get(
-                    line.split("=")[-1].strip().lower())
+                    line.replace('"', '').split("=")[-1].strip().lower())
             elif line.startswith("VERSION_ID="):
                 try:
                     version = float(line.split("=")[1].replace("\"", ""))
@@ -363,7 +363,7 @@ def check_curses():
     import subprocess
 
     try:
-        subprocess.check_call('which dialog')
+        subprocess.check_call(['which', 'dialog'])
     except subprocess.CalledProcessError:
         logger.error(
             'Curses requires the `dialog` command to be installed as well as'
@@ -463,3 +463,6 @@ def check_dependencies(verbose=False, optional=False):
             'PyBitmessage cannot start. One or more dependencies are'
             ' unavailable.'
         )
+
+
+logger.setLevel(0)

src/kivymd/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Andrés Rodríguez and KivyMD contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

src/kivymd/__init__.py

@@ -0,0 +1,6 @@
+# -*- coding: utf-8 -*-
+import os
+
+path = os.path.dirname(__file__)
+fonts_path = os.path.join(path, "fonts/")
+images_path = os.path.join(path, 'images/')

src/kivymd/accordion.py

@@ -0,0 +1,254 @@
+# -*- coding: utf-8 -*-
+
+from kivy.lang import Builder
+from kivy.properties import StringProperty, ListProperty, OptionProperty
+from kivy.utils import get_color_from_hex
+from kivymd.color_definitions import colors
+from kivymd.theming import ThemableBehavior
+from kivy.uix.accordion import Accordion, AccordionItem
+from kivymd.backgroundcolorbehavior import BackgroundColorBehavior
+from kivy.uix.boxlayout import BoxLayout
+
+
+class MDAccordionItemTitleLayout(ThemableBehavior, BackgroundColorBehavior, BoxLayout):
+    pass
+
+
+class MDAccordion(ThemableBehavior, BackgroundColorBehavior, Accordion):
+    pass
+
+
+class MDAccordionItem(ThemableBehavior, AccordionItem):
+    title_theme_color = OptionProperty(None, allownone=True,
+                                       options=['Primary', 'Secondary', 'Hint',
+                                                'Error', 'Custom'])
+    ''' Color theme for title text and  icon '''
+
+    title_color = ListProperty(None, allownone=True)
+    ''' Color for title text and icon if `title_theme_color` is Custom '''
+    
+    background_color = ListProperty(None, allownone=True)
+    ''' Color for the background of the accordian item title in rgba format. 
+    '''
+    
+    divider_color = ListProperty(None, allownone=True)
+    ''' Color for dividers between different titles in rgba format 
+    To remove the divider set a color with an alpha of 0. 
+    '''
+
+    indicator_color = ListProperty(None, allownone=True)
+    ''' Color for the indicator on the side of the active item in rgba format 
+    To remove the indicator set a color with an alpha of 0. 
+    '''
+    
+    font_style = OptionProperty(
+        'Subhead', options=['Body1', 'Body2', 'Caption', 'Subhead', 'Title',
+                          'Headline', 'Display1', 'Display2', 'Display3',
+                          'Display4', 'Button', 'Icon'])
+    ''' Font style to use for the title text '''
+
+    title_template = StringProperty('MDAccordionItemTitle')
+    ''' Template to use for the title '''
+    
+    icon = StringProperty(None,allownone=True)
+    ''' Icon name to use when this item is expanded  '''
+    
+    icon_expanded = StringProperty('chevron-up')
+    ''' Icon name to use when this item is expanded  '''
+    
+    icon_collapsed = StringProperty('chevron-down')
+    ''' Icon name to use when this item is collapsed  '''
+ 
+ 
+Builder.load_string('''
+#:import MDLabel kivymd.label.MDLabel
+#:import md_icons kivymd.icon_definitions.md_icons
+
+
+<MDAccordionItem>:
+    canvas.before:
+        Color:
+            rgba: self.background_color or self.theme_cls.primary_color
+        Rectangle:
+            size:self.size
+            pos:self.pos
+        
+        PushMatrix
+        Translate:
+            xy: (dp(2),0) if self.orientation == 'vertical' else (0,dp(2))
+    canvas.after:
+        PopMatrix
+        Color:
+            rgba: self.divider_color or self.theme_cls.divider_color   
+        Rectangle:
+            size:(dp(1),self.height) if self.orientation == 'horizontal' else (self.width,dp(1)) 
+            pos:self.pos
+        Color:
+            rgba: [0,0,0,0] if self.collapse else (self.indicator_color or self.theme_cls.accent_color)   
+        Rectangle:
+            size:(dp(2),self.height) if self.orientation == 'vertical' else (self.width,dp(2)) 
+            pos:self.pos
+
+[MDAccordionItemTitle@MDAccordionItemTitleLayout]:
+    padding: '12dp'
+    spacing: '12dp'
+    orientation: 'horizontal' if ctx.item.orientation=='vertical' else 'vertical'
+    canvas:
+        PushMatrix
+        Translate:
+            xy: (-dp(2),0) if ctx.item.orientation == 'vertical' else (0,-dp(2))
+            
+        Color:
+            rgba: self.background_color or self.theme_cls.primary_color
+        Rectangle:
+            size:self.size
+            pos:self.pos
+        
+    canvas.after:
+        Color:
+            rgba: [0,0,0,0] if ctx.item.collapse else (ctx.item.indicator_color or self.theme_cls.accent_color)   
+        Rectangle:
+            size:(dp(2),self.height) if ctx.item.orientation == 'vertical' else (self.width,dp(2)) 
+            pos:self.pos
+        PopMatrix
+    MDLabel:
+        id:_icon
+        theme_text_color:ctx.item.title_theme_color if ctx.item.icon else 'Custom'
+        text_color:ctx.item.title_color if ctx.item.icon else [0,0,0,0]
+        text: md_icons[ctx.item.icon if ctx.item.icon else 'menu']
+        font_style:'Icon'
+        size_hint: (None,1) if ctx.item.orientation == 'vertical' else (1,None)
+        size: ((self.texture_size[0],1) if ctx.item.orientation == 'vertical' else (1,self.texture_size[1])) \
+            if ctx.item.icon else (0,0)
+        text_size: (self.width, None) if ctx.item.orientation=='vertical' else (None,self.width)
+        canvas.before:
+            PushMatrix
+            Rotate:
+                angle: 90 if ctx.item.orientation == 'horizontal' else 0
+                origin: self.center
+        canvas.after:
+            PopMatrix
+    MDLabel:
+        id:_label
+        theme_text_color:ctx.item.title_theme_color
+        text_color:ctx.item.title_color
+        text: ctx.item.title
+        font_style:ctx.item.font_style
+        text_size: (self.width, None) if ctx.item.orientation=='vertical' else (None,self.width)
+        canvas.before:
+            PushMatrix
+            Rotate:
+                angle: 90 if ctx.item.orientation == 'horizontal' else 0
+                origin: self.center
+        canvas.after:
+            PopMatrix
+        
+    MDLabel:
+        id:_expand_icon
+        theme_text_color:ctx.item.title_theme_color
+        text_color:ctx.item.title_color
+        font_style:'Icon'
+        size_hint: (None,1) if ctx.item.orientation == 'vertical' else (1,None)
+        size: (self.texture_size[0],1) if ctx.item.orientation == 'vertical' else (1,self.texture_size[1])
+        text:md_icons[ctx.item.icon_collapsed if ctx.item.collapse else ctx.item.icon_expanded]
+        halign: 'right' if ctx.item.orientation=='vertical' else 'center'
+        #valign: 'middle' if ctx.item.orientation=='vertical' else 'bottom'
+        canvas.before:
+            PushMatrix
+            Rotate:
+                angle: 90 if ctx.item.orientation == 'horizontal' else 0
+                origin:self.center
+        canvas.after:
+            PopMatrix
+    
+''')           
+    
+if __name__ == '__main__':
+    from kivy.app import App
+    from kivymd.theming import ThemeManager
+    
+    class AccordionApp(App):
+        theme_cls = ThemeManager()
+
+        def build(self):
+            # self.theme_cls.primary_palette = 'Indigo'
+            return Builder.load_string("""
+#:import MDLabel kivymd.label.MDLabel
+#:import MDList kivymd.list.MDList
+#:import OneLineListItem kivymd.list.OneLineListItem
+BoxLayout:
+    spacing: '64dp'
+    MDAccordion:
+        orientation:'vertical'
+        MDAccordionItem:
+            title:'Item 1'
+            icon: 'home'
+            ScrollView:
+                MDList:
+                    OneLineListItem:
+                        text: "Subitem 1"
+                        theme_text_color: 'Custom'
+                        text_color: [1,1,1,1]
+                    OneLineListItem:
+                        text: "Subitem 2"
+                        theme_text_color: 'Custom'
+                        text_color: [1,1,1,1]
+                    OneLineListItem:
+                        text: "Subitem 3"
+                        theme_text_color: 'Custom'
+                        text_color: [1,1,1,1]
+        MDAccordionItem:
+            title:'Item 2'
+            icon: 'globe'
+            ScrollView:
+                MDList:
+                    OneLineListItem:
+                        text: "Subitem 4"
+                        theme_text_color: 'Custom'
+                        text_color: [1,1,1,1]
+                    OneLineListItem:
+                        text: "Subitem 5"
+                        theme_text_color: 'Custom'
+                        text_color: [1,1,1,1]
+                    OneLineListItem:
+                        text: "Subitem 6"
+                        theme_text_color: 'Custom'
+                        text_color: [1,1,1,1]
+        MDAccordionItem:
+            title:'Item 3'
+            ScrollView:
+                MDList:
+                    OneLineListItem:
+                        text: "Subitem 7"
+                        theme_text_color: 'Custom'
+                        text_color: [1,1,1,1]
+                    OneLineListItem:
+                        text: "Subitem 8"
+                        theme_text_color: 'Custom'
+                        text_color: [1,1,1,1]
+                    OneLineListItem:
+                        text: "Subitem 9"
+                        theme_text_color: 'Custom'
+                        text_color: [1,1,1,1]
+    MDAccordion:
+        orientation:'horizontal'
+        MDAccordionItem:
+            title:'Item 1'
+            icon: 'home'
+            MDLabel:
+                text:'Content 1'
+                theme_text_color:'Primary'
+        MDAccordionItem:
+            title:'Item 2'
+            MDLabel:
+                text:'Content 2'
+                theme_text_color:'Primary'
+        MDAccordionItem:
+            title:'Item 3'
+            MDLabel:
+                text:'Content 3'
+                theme_text_color:'Primary'
+""")
+            
+
+    AccordionApp().run()

src/kivymd/backgroundcolorbehavior.py

@@ -0,0 +1,23 @@
+# -*- coding: utf-8 -*-
+from kivy.lang import Builder
+from kivy.properties import BoundedNumericProperty, ReferenceListProperty
+from kivy.uix.widget import Widget
+
+Builder.load_string('''
+<BackgroundColorBehavior>
+    canvas:
+        Color:
+            rgba: self.background_color
+        Rectangle:
+            size: self.size
+            pos: self.pos
+''')
+
+
+class BackgroundColorBehavior(Widget):
+    r = BoundedNumericProperty(1., min=0., max=1.)
+    g = BoundedNumericProperty(1., min=0., max=1.)
+    b = BoundedNumericProperty(1., min=0., max=1.)
+    a = BoundedNumericProperty(0., min=0., max=1.)
+
+    background_color = ReferenceListProperty(r, g, b, a)

src/kivymd/bottomsheet.py

@@ -0,0 +1,211 @@
+# -*- coding: utf-8 -*-
+'''
+Bottom Sheets
+=============
+
+`Material Design spec Bottom Sheets page <http://www.google.com/design/spec/components/bottom-sheets.html>`_
+
+In this module there's the :class:`MDBottomSheet` class which will let you implement your own Material Design Bottom Sheets, and there are two classes called :class:`MDListBottomSheet` and :class:`MDGridBottomSheet` implementing the ones mentioned in the spec.
+
+Examples
+--------
+
+.. note::
+
+    These widgets are designed to be called from Python code only.
+
+For :class:`MDListBottomSheet`:
+
+.. code-block:: python
+
+    bs = MDListBottomSheet()
+    bs.add_item("Here's an item with text only", lambda x: x)
+    bs.add_item("Here's an item with an icon", lambda x: x, icon='md-cast')
+    bs.add_item("Here's another!", lambda x: x, icon='md-nfc')
+    bs.open()
+
+For :class:`MDListBottomSheet`:
+
+.. code-block:: python
+
+    bs = MDGridBottomSheet()
+    bs.add_item("Facebook", lambda x: x, icon_src='./assets/facebook-box.png')
+    bs.add_item("YouTube", lambda x: x, icon_src='./assets/youtube-play.png')
+    bs.add_item("Twitter", lambda x: x, icon_src='./assets/twitter.png')
+    bs.add_item("Da Cloud", lambda x: x, icon_src='./assets/cloud-upload.png')
+    bs.add_item("Camera", lambda x: x, icon_src='./assets/camera.png')
+    bs.open()
+
+API
+---
+'''
+from kivy.clock import Clock
+from kivy.lang import Builder
+from kivy.metrics import dp
+from kivy.properties import ObjectProperty, StringProperty
+from kivy.uix.behaviors import ButtonBehavior
+from kivy.uix.boxlayout import BoxLayout
+from kivy.uix.floatlayout import FloatLayout
+from kivy.uix.gridlayout import GridLayout
+from kivy.uix.modalview import ModalView
+from kivy.uix.scrollview import ScrollView
+from kivymd.backgroundcolorbehavior import BackgroundColorBehavior
+from kivymd.label import MDLabel
+from kivymd.list import MDList, OneLineListItem, ILeftBody, \
+    OneLineIconListItem
+from kivymd.theming import ThemableBehavior
+
+Builder.load_string('''
+<MDBottomSheet>
+    background: 'atlas://data/images/defaulttheme/action_group_disabled'
+    background_color: 0,0,0,.8
+    sv: sv
+    upper_padding: upper_padding
+    gl_content: gl_content
+    ScrollView:
+        id: sv
+        do_scroll_x: False
+        BoxLayout:
+            size_hint_y: None
+            orientation: 'vertical'
+            padding: 0,1,0,0
+            height: upper_padding.height + gl_content.height + 1  # +1 to allow overscroll
+            BsPadding:
+                id: upper_padding
+                size_hint_y: None
+                height: root.height - min(root.width * 9 / 16, gl_content.height)
+                on_release: root.dismiss()
+            BottomSheetContent:
+                id: gl_content
+                size_hint_y: None
+                background_color: root.theme_cls.bg_normal
+                cols: 1
+''')
+
+
+class BsPadding(ButtonBehavior, FloatLayout):
+    pass
+
+
+class BottomSheetContent(BackgroundColorBehavior, GridLayout):
+    pass
+
+
+class MDBottomSheet(ThemableBehavior, ModalView):
+    sv = ObjectProperty()
+    upper_padding = ObjectProperty()
+    gl_content = ObjectProperty()
+    dismiss_zone_scroll = 1000  # Arbitrary high number
+
+    def open(self, *largs):
+        super(MDBottomSheet, self).open(*largs)
+        Clock.schedule_once(self.set_dismiss_zone, 0)
+
+    def set_dismiss_zone(self, *largs):
+        # Scroll to right below overscroll threshold:
+        self.sv.scroll_y = 1 - self.sv.convert_distance_to_scroll(0, 1)[1]
+
+        # This is a line where m (slope) is 1/6 and b (y-intercept) is 80:
+        self.dismiss_zone_scroll = self.sv.convert_distance_to_scroll(
+            0, (self.height - self.upper_padding.height) * (1 / 6.0) + 80)[
+            1]
+        # Uncomment next line if the limit should just be half of
+        # visible content on open (capped by specs to 16 units to width/9:
+        # self.dismiss_zone_scroll = (self.sv.convert_distance_to_scroll(
+        #         0, self.height - self.upper_padding.height)[1] * 0.50)
+
+        # Check if user has overscrolled enough to dismiss bottom sheet:
+        self.sv.bind(on_scroll_stop=self.check_if_scrolled_to_death)
+
+    def check_if_scrolled_to_death(self, *largs):
+        if self.sv.scroll_y >= 1 + self.dismiss_zone_scroll:
+            self.dismiss()
+
+    def add_widget(self, widget, index=0):
+        if type(widget) == ScrollView:
+            super(MDBottomSheet, self).add_widget(widget, index)
+        else:
+            self.gl_content.add_widget(widget,index)
+
+
+Builder.load_string('''
+#:import md_icons kivymd.icon_definitions.md_icons
+<ListBSIconLeft>
+    font_style: 'Icon'
+    text: u"{}".format(md_icons[root.icon])
+    halign: 'center'
+    theme_text_color: 'Primary'
+    valign: 'middle'
+''')
+
+
+class ListBSIconLeft(ILeftBody, MDLabel):
+    icon = StringProperty()
+
+
+class MDListBottomSheet(MDBottomSheet):
+    mlist = ObjectProperty()
+
+    def __init__(self, **kwargs):
+        super(MDListBottomSheet, self).__init__(**kwargs)
+        self.mlist = MDList()
+        self.gl_content.add_widget(self.mlist)
+        Clock.schedule_once(self.resize_content_layout, 0)
+
+    def resize_content_layout(self, *largs):
+        self.gl_content.height = self.mlist.height
+
+    def add_item(self, text, callback, icon=None):
+        if icon:
+            item = OneLineIconListItem(text=text, on_release=callback)
+            item.add_widget(ListBSIconLeft(icon=icon))
+        else:
+            item = OneLineListItem(text=text, on_release=callback)
+
+        item.bind(on_release=lambda x: self.dismiss())
+        self.mlist.add_widget(item)
+
+
+Builder.load_string('''
+<GridBSItem>
+    orientation: 'vertical'
+    padding: 0, dp(24), 0, 0
+    size_hint_y: None
+    size: dp(64), dp(96)
+    BoxLayout:
+        padding: dp(8), 0, dp(8), dp(8)
+        size_hint_y: None
+        height: dp(48)
+        Image:
+            source: root.source
+    MDLabel:
+        font_style: 'Caption'
+        theme_text_color: 'Secondary'
+        text: root.caption
+        halign: 'center'
+''')
+
+
+class GridBSItem(ButtonBehavior, BoxLayout):
+    source = StringProperty()
+
+    caption = StringProperty()
+
+
+class MDGridBottomSheet(MDBottomSheet):
+    def __init__(self, **kwargs):
+        super(MDGridBottomSheet, self).__init__(**kwargs)
+        self.gl_content.padding = (dp(16), 0, dp(16), dp(24))
+        self.gl_content.height = dp(24)
+        self.gl_content.cols = 3
+
+    def add_item(self, text, callback, icon_src):
+        item = GridBSItem(
+            caption=text,
+            on_release=callback,
+            source=icon_src
+        )
+        item.bind(on_release=lambda x: self.dismiss())
+        if len(self.gl_content.children) % 3 == 0:
+            self.gl_content.height += dp(96)
+        self.gl_content.add_widget(item)

src/kivymd/button.py

@@ -0,0 +1,453 @@
+# -*- coding: utf-8 -*-
+'''
+Buttons
+=======
+
+`Material Design spec, Buttons page <https://www.google.com/design/spec/components/buttons.html>`_
+
+`Material Design spec, Buttons: Floating Action Button page <https://www.google.com/design/spec/components/buttons-floating-action-button.html>`_
+
+TO-DO: DOCUMENT MODULE
+'''
+from kivy.clock import Clock
+from kivy.lang import Builder
+from kivy.metrics import dp
+from kivy.utils import get_color_from_hex
+from kivy.properties import StringProperty, BoundedNumericProperty, \
+    ListProperty, AliasProperty, BooleanProperty, NumericProperty, \
+    OptionProperty
+from kivy.uix.anchorlayout import AnchorLayout
+from kivy.uix.behaviors import ButtonBehavior
+from kivy.uix.boxlayout import BoxLayout
+from kivy.animation import Animation
+from kivymd.backgroundcolorbehavior import BackgroundColorBehavior
+from kivymd.ripplebehavior import CircularRippleBehavior, \
+    RectangularRippleBehavior
+from kivymd.elevationbehavior import ElevationBehavior, \
+    RoundElevationBehavior
+from kivymd.theming import ThemableBehavior
+from kivymd.color_definitions import colors
+
+Builder.load_string('''
+#:import md_icons kivymd.icon_definitions.md_icons
+#:import colors kivymd.color_definitions.colors
+#:import MDLabel kivymd.label.MDLabel
+<MDIconButton>
+    size_hint: (None, None)
+    size: (dp(48), dp(48))
+    padding: dp(12)
+    theme_text_color: 'Primary'
+    MDLabel:
+        id: _label
+        font_style: 'Icon'
+        text: u"{}".format(md_icons[root.icon])
+        halign: 'center'
+        theme_text_color: root.theme_text_color
+        text_color: root.text_color
+        opposite_colors: root.opposite_colors
+        valign: 'middle'
+
+<MDFlatButton>
+    canvas:
+        Color:
+            #rgba: self.background_color if self.state == 'normal' else self._bg_color_down
+            rgba: self._current_button_color
+        Rectangle:
+            size: self.size
+            pos: self.pos
+    size_hint: (None, None)
+    height: dp(36)
+    width: _label.texture_size[0] + dp(16)
+    padding: (dp(8), 0)
+    theme_text_color: 'Custom'
+    text_color: root.theme_cls.primary_color
+    MDLabel:
+        id: _label
+        text: root._text
+        font_style: 'Button'
+        size_hint_x: None
+        text_size: (None, root.height)
+        height: self.texture_size[1]
+        theme_text_color: root.theme_text_color
+        text_color: root.text_color
+        valign: 'middle'
+        halign: 'center'
+        opposite_colors: root.opposite_colors
+
+<MDRaisedButton>:
+    canvas:
+        Clear
+        Color:
+            rgba: self.background_color_disabled if self.disabled else \
+            (self.background_color if self.state == 'normal' else self.background_color_down)
+        Rectangle:
+            size: self.size
+            pos: self.pos
+
+    anchor_x: 'center'
+    anchor_y: 'center'
+    background_color: root.theme_cls.primary_color
+    background_color_down: root.theme_cls.primary_dark
+    background_color_disabled: root.theme_cls.divider_color
+    theme_text_color: 'Primary'
+    MDLabel:
+        id: label
+        font_style:         'Button'
+        text:                root._text
+        size_hint:            None, None
+        width:                root.width
+        text_size:            self.width, None
+        height:                self.texture_size[1]
+        theme_text_color:    root.theme_text_color
+        text_color:         root.text_color
+        opposite_colors:    root.opposite_colors
+        disabled:            root.disabled
+        halign:                'center'
+        valign:                'middle'
+
+<MDFloatingActionButton>:
+    canvas:
+        Clear
+        Color:
+            rgba: self.background_color_disabled if self.disabled else \
+            (self.background_color if self.state == 'normal' else self.background_color_down)
+        Ellipse:
+            size: self.size
+            pos: self.pos
+
+    anchor_x:            'center'
+    anchor_y:            'center'
+    background_color: root.theme_cls.accent_color
+    background_color_down: root.theme_cls.accent_dark
+    background_color_disabled: root.theme_cls.divider_color
+    theme_text_color: 'Primary'
+    MDLabel:
+        id: label
+        font_style:         'Icon'
+        text:                 u"{}".format(md_icons[root.icon])
+        size_hint:            None, None
+        size:                dp(24), dp(24)
+        text_size:            self.size
+        theme_text_color:    root.theme_text_color
+        text_color:         root.text_color
+        opposite_colors:    root.opposite_colors
+        disabled:            root.disabled
+        halign:                'center'
+        valign:                'middle'
+''')
+
+
+class MDIconButton(CircularRippleBehavior, ButtonBehavior, BoxLayout):
+    icon = StringProperty('circle')
+    theme_text_color = OptionProperty(None, allownone=True,
+                                      options=['Primary', 'Secondary', 'Hint',
+                                               'Error', 'Custom'])
+    text_color = ListProperty(None, allownone=True)
+    opposite_colors = BooleanProperty(False)
+
+
+class MDFlatButton(ThemableBehavior, RectangularRippleBehavior,
+                   ButtonBehavior, BackgroundColorBehavior, AnchorLayout):
+    width = BoundedNumericProperty(dp(64), min=dp(64), max=None,
+                                   errorhandler=lambda x: dp(64))
+
+    text_color = ListProperty()
+
+    text = StringProperty('')
+    theme_text_color = OptionProperty(None, allownone=True,
+                                      options=['Primary', 'Secondary', 'Hint',
+                                               'Error', 'Custom'])
+    text_color = ListProperty(None, allownone=True)
+
+    _text = StringProperty('')
+    _bg_color_down = ListProperty([0, 0, 0, 0])
+    _current_button_color = ListProperty([0, 0, 0, 0])
+
+    def __init__(self, **kwargs):
+        super(MDFlatButton, self).__init__(**kwargs)
+        self._current_button_color = self.background_color
+        self._bg_color_down = get_color_from_hex(
+            colors[self.theme_cls.theme_style]['FlatButtonDown'])
+
+        Clock.schedule_once(lambda x: self.ids._label.bind(
+            texture_size=self.update_width_on_label_texture))
+
+    def update_width_on_label_texture(self, instance, value):
+        self.ids._label.width = value[0]
+
+    def on_text(self, instance, value):
+        self._text = value.upper()
+
+    def on_touch_down(self, touch):
+        if touch.is_mouse_scrolling:
+            return False
+        elif not self.collide_point(touch.x, touch.y):
+            return False
+        elif self in touch.ud:
+            return False
+        elif self.disabled:
+            return False
+        else:
+            self.fade_bg = Animation(duration=.2, _current_button_color=get_color_from_hex(
+                                     colors[self.theme_cls.theme_style]['FlatButtonDown']))
+            self.fade_bg.start(self)
+            return super(MDFlatButton, self).on_touch_down(touch)
+
+    def on_touch_up(self, touch):
+        if touch.grab_current is self:
+            self.fade_bg.stop_property(self, '_current_button_color')
+            Animation(duration=.05, _current_button_color=self.background_color).start(self)
+        return super(MDFlatButton, self).on_touch_up(touch)
+
+
+class MDRaisedButton(ThemableBehavior, RectangularRippleBehavior,
+                     ElevationBehavior, ButtonBehavior,
+                     AnchorLayout):
+    _bg_color_down = ListProperty([])
+    background_color = ListProperty()
+    background_color_down = ListProperty()
+    background_color_disabled = ListProperty()
+    theme_text_color = OptionProperty(None, allownone=True,
+                                      options=['Primary', 'Secondary', 'Hint',
+                                               'Error', 'Custom'])
+    text_color = ListProperty(None, allownone=True)
+
+    def _get_bg_color_down(self):
+        return self._bg_color_down
+
+    def _set_bg_color_down(self, color, alpha=None):
+        if len(color) == 2:
+            self._bg_color_down = get_color_from_hex(
+                colors[color[0]][color[1]])
+            if alpha:
+                self._bg_color_down[3] = alpha
+        elif len(color) == 4:
+            self._bg_color_down = color
+
+    background_color_down = AliasProperty(_get_bg_color_down,
+                                          _set_bg_color_down,
+                                          bind=('_bg_color_down',))
+
+    _bg_color_disabled = ListProperty([])
+
+    def _get_bg_color_disabled(self):
+        return self._bg_color_disabled
+
+    def _set_bg_color_disabled(self, color, alpha=None):
+        if len(color) == 2:
+            self._bg_color_disabled = get_color_from_hex(
+                colors[color[0]][color[1]])
+            if alpha:
+                self._bg_color_disabled[3] = alpha
+        elif len(color) == 4:
+            self._bg_color_disabled = color
+
+    background_color_disabled = AliasProperty(_get_bg_color_disabled,
+                                              _set_bg_color_disabled,
+                                              bind=('_bg_color_disabled',))
+
+    _elev_norm = NumericProperty(2)
+
+    def _get_elev_norm(self):
+        return self._elev_norm
+
+    def _set_elev_norm(self, value):
+        self._elev_norm = value if value <= 12 else 12
+        self._elev_raised = (value + 6) if value + 6 <= 12 else 12
+        self.elevation = self._elev_norm
+
+    elevation_normal = AliasProperty(_get_elev_norm, _set_elev_norm,
+                                     bind=('_elev_norm',))
+
+    _elev_raised = NumericProperty(8)
+
+    def _get_elev_raised(self):
+        return self._elev_raised
+
+    def _set_elev_raised(self, value):
+        self._elev_raised = value if value + self._elev_norm <= 12 else 12
+
+    elevation_raised = AliasProperty(_get_elev_raised, _set_elev_raised,
+                                     bind=('_elev_raised',))
+
+    text = StringProperty()
+
+    _text = StringProperty()
+
+    def __init__(self, **kwargs):
+        super(MDRaisedButton, self).__init__(**kwargs)
+        self.elevation_press_anim = Animation(elevation=self.elevation_raised,
+                                              duration=.2, t='out_quad')
+        self.elevation_release_anim = Animation(
+            elevation=self.elevation_normal, duration=.2, t='out_quad')
+
+    def on_disabled(self, instance, value):
+        if value:
+            self.elevation = 0
+        else:
+            self.elevation = self.elevation_normal
+        super(MDRaisedButton, self).on_disabled(instance, value)
+
+    def on_touch_down(self, touch):
+        if not self.disabled:
+            if touch.is_mouse_scrolling:
+                return False
+            if not self.collide_point(touch.x, touch.y):
+                return False
+            if self in touch.ud:
+                return False
+            Animation.cancel_all(self, 'elevation')
+            self.elevation_press_anim.start(self)
+        return super(MDRaisedButton, self).on_touch_down(touch)
+
+    def on_touch_up(self, touch):
+        if not self.disabled:
+            if touch.grab_current is not self:
+                return super(ButtonBehavior, self).on_touch_up(touch)
+            Animation.cancel_all(self, 'elevation')
+            self.elevation_release_anim.start(self)
+        else:
+            Animation.cancel_all(self, 'elevation')
+            self.elevation = 0
+        return super(MDRaisedButton, self).on_touch_up(touch)
+
+    def on_text(self, instance, text):
+        self._text = text.upper()
+
+    def on__elev_norm(self, instance, value):
+        self.elevation_release_anim = Animation(elevation=value,
+                                                duration=.2, t='out_quad')
+
+    def on__elev_raised(self, instance, value):
+        self.elevation_press_anim = Animation(elevation=value,
+                                              duration=.2, t='out_quad')
+
+
+class MDFloatingActionButton(ThemableBehavior, CircularRippleBehavior,
+                             RoundElevationBehavior, ButtonBehavior,
+                             AnchorLayout):
+    _bg_color_down = ListProperty([])
+    background_color = ListProperty()
+    background_color_down = ListProperty()
+    background_color_disabled = ListProperty()
+    theme_text_color = OptionProperty(None, allownone=True,
+                                      options=['Primary', 'Secondary', 'Hint',
+                                               'Error', 'Custom'])
+    text_color = ListProperty(None, allownone=True)
+
+    def _get_bg_color_down(self):
+        return self._bg_color_down
+
+    def _set_bg_color_down(self, color, alpha=None):
+        if len(color) == 2:
+            self._bg_color_down = get_color_from_hex(
+                colors[color[0]][color[1]])
+            if alpha:
+                self._bg_color_down[3] = alpha
+        elif len(color) == 4:
+            self._bg_color_down = color
+
+    background_color_down = AliasProperty(_get_bg_color_down,
+                                          _set_bg_color_down,
+                                          bind=('_bg_color_down',))
+
+    _bg_color_disabled = ListProperty([])
+
+    def _get_bg_color_disabled(self):
+        return self._bg_color_disabled
+
+    def _set_bg_color_disabled(self, color, alpha=None):
+        if len(color) == 2:
+            self._bg_color_disabled = get_color_from_hex(
+                colors[color[0]][color[1]])
+            if alpha:
+                self._bg_color_disabled[3] = alpha
+        elif len(color) == 4:
+            self._bg_color_disabled = color
+
+    background_color_disabled = AliasProperty(_get_bg_color_disabled,
+                                              _set_bg_color_disabled,
+                                              bind=('_bg_color_disabled',))
+    icon = StringProperty('android')
+
+    _elev_norm = NumericProperty(6)
+
+    def _get_elev_norm(self):
+        return self._elev_norm
+
+    def _set_elev_norm(self, value):
+        self._elev_norm = value if value <= 12 else 12
+        self._elev_raised = (value + 6) if value + 6 <= 12 else 12
+        self.elevation = self._elev_norm
+
+    elevation_normal = AliasProperty(_get_elev_norm, _set_elev_norm,
+                                     bind=('_elev_norm',))
+
+    # _elev_raised = NumericProperty(12)
+    _elev_raised = NumericProperty(6)
+
+    def _get_elev_raised(self):
+        return self._elev_raised
+
+    def _set_elev_raised(self, value):
+        self._elev_raised = value if value + self._elev_norm <= 12 else 12
+
+    elevation_raised = AliasProperty(_get_elev_raised, _set_elev_raised,
+                                     bind=('_elev_raised',))
+
+    def __init__(self, **kwargs):
+        if self.elevation_raised == 0 and self.elevation_normal + 6 <= 12:
+            self.elevation_raised = self.elevation_normal + 6
+        elif self.elevation_raised == 0:
+            self.elevation_raised = 12
+
+        super(MDFloatingActionButton, self).__init__(**kwargs)
+
+        self.elevation_press_anim = Animation(elevation=self.elevation_raised,
+                                              duration=.2, t='out_quad')
+        self.elevation_release_anim = Animation(
+            elevation=self.elevation_normal, duration=.2, t='out_quad')
+
+    def _set_ellipse(self, instance, value):
+        ellipse = self.ellipse
+        ripple_rad = self.ripple_rad
+
+        ellipse.size = (ripple_rad, ripple_rad)
+        ellipse.pos = (self.center_x - ripple_rad / 2.,
+                       self.center_y - ripple_rad / 2.)
+
+    def on_disabled(self, instance, value):
+        super(MDFloatingActionButton, self).on_disabled(instance, value)
+        if self.disabled:
+            self.elevation = 0
+        else:
+            self.elevation = self.elevation_normal
+
+    def on_touch_down(self, touch):
+        if not self.disabled:
+            if touch.is_mouse_scrolling:
+                return False
+            if not self.collide_point(touch.x, touch.y):
+                return False
+            if self in touch.ud:
+                return False
+            self.elevation_press_anim.stop(self)
+            self.elevation_press_anim.start(self)
+        return super(MDFloatingActionButton, self).on_touch_down(touch)
+
+    def on_touch_up(self, touch):
+        if not self.disabled:
+            if touch.grab_current is not self:
+                return super(ButtonBehavior, self).on_touch_up(touch)
+            self.elevation_release_anim.stop(self)
+            self.elevation_release_anim.start(self)
+        return super(MDFloatingActionButton, self).on_touch_up(touch)
+
+    def on_elevation_normal(self, instance, value):
+        self.elevation = value
+
+    def on_elevation_raised(self, instance, value):
+        if self.elevation_raised == 0 and self.elevation_normal + 6 <= 12:
+            self.elevation_raised = self.elevation_normal + 6
+        elif self.elevation_raised == 0:
+            self.elevation_raised = 12

src/kivymd/card.py

@@ -0,0 +1,58 @@
+# -*- coding: utf-8 -*-
+from kivy.lang import Builder
+from kivy.properties import BoundedNumericProperty, ReferenceListProperty, ListProperty,BooleanProperty
+from kivy.uix.boxlayout import BoxLayout
+from kivymd.elevationbehavior import ElevationBehavior
+from kivymd.theming import ThemableBehavior
+from kivy.metrics import dp
+from kivy.uix.widget import Widget
+
+Builder.load_string('''
+<MDCard>
+    canvas:
+        Color:
+            rgba: self.background_color
+        RoundedRectangle:
+            size: self.size
+            pos: self.pos
+            radius: [self.border_radius]
+        Color:
+            rgba: self.theme_cls.divider_color
+            a: self.border_color_a
+        Line:
+            rounded_rectangle: (self.pos[0],self.pos[1],self.size[0],self.size[1],self.border_radius) 
+    background_color: self.theme_cls.bg_light
+    
+<MDSeparator>
+    canvas:
+        Color:
+            rgba: self.theme_cls.divider_color
+        Rectangle:
+            size: self.size
+            pos: self.pos
+''')
+
+
+class MDSeparator(ThemableBehavior, BoxLayout):
+    """ A separator line """
+    def __init__(self, *args, **kwargs):
+        super(MDSeparator, self).__init__(*args, **kwargs)
+        self.on_orientation()
+    
+    def on_orientation(self,*args):
+        self.size_hint = (1, None) if self.orientation == 'horizontal' else (None, 1)
+        if self.orientation == 'horizontal':
+            self.height = dp(1)
+        else:
+            self.width = dp(1)
+
+
+class MDCard(ThemableBehavior, ElevationBehavior, BoxLayout):
+    r = BoundedNumericProperty(1., min=0., max=1.)
+    g = BoundedNumericProperty(1., min=0., max=1.)
+    b = BoundedNumericProperty(1., min=0., max=1.)
+    a = BoundedNumericProperty(0., min=0., max=1.)
+    
+    border_radius = BoundedNumericProperty(dp(3),min=0)
+    border_color_a = BoundedNumericProperty(0, min=0., max=1.)
+    background_color = ReferenceListProperty(r, g, b, a)

src/kivymd/color_definitions.py

@@ -0,0 +1,360 @@
+colors = {
+    'Pink': {
+        '50': 'fce4ec',
+        '100': 'f8bbd0',
+        '200': 'f48fb1',
+        '300': 'f06292',
+        '400': 'ec407a',
+        '500': 'e91e63',
+        '600': 'd81b60',
+        '700': 'C2185B',
+        '800': 'ad1457',
+        '900': '88e4ff',
+        'A100': 'ff80ab',
+        'A400': 'F50057',
+        'A700': 'c51162',
+        'A200': 'ff4081'
+    },
+
+    'Blue': {
+        '200': '90caf9',
+        '900': '0D47A1',
+        '600': '1e88e5',
+        'A100': '82b1ff',
+        '300': '64b5f6',
+        'A400': '2979ff',
+        '700': '1976d2',
+        '50': 'e3f2fd',
+        'A700': '2962ff',
+        '400': '42a5f5',
+        '100': 'bbdefb',
+        '800': '1565c0',
+        'A200': '448aff',
+        '500': '2196f3'
+    },
+
+    'Indigo': {
+        '200': '9fa8da',
+        '900': '1a237e',
+        '600': '3949ab',
+        'A100': '8c9eff',
+        '300': '7986cb',
+        'A400': '3d5afe',
+        '700': '303f9f',
+        '50': 'e8eaf6',
+        'A700': '304ffe',
+        '400': '5c6bc0',
+        '100': 'c5cae9',
+        '800': '283593',
+        'A200': '536dfe',
+        '500': '3f51b5'
+    },
+
+    'BlueGrey': {
+        '200': 'b0bec5',
+        '900': '263238',
+        '600': '546e7a',
+        '300': '90a4ae',
+        '700': '455a64',
+        '50': 'eceff1',
+        '400': '78909c',
+        '100': 'cfd8dc',
+        '800': '37474f',
+        '500': '607d8b'
+    },
+
+    'Brown': {
+        '200': 'bcaaa4',
+        '900': '3e2723',
+        '600': '6d4c41',
+        '300': 'a1887f',
+        '700': '5d4037',
+        '50': 'efebe9',
+        '400': '8d6e63',
+        '100': 'd7ccc8',
+        '800': '4e342e',
+        '500': '795548'
+    },
+
+    'LightBlue': {
+        '200': '81d4fa',
+        '900': '01579B',
+        '600': '039BE5',
+        'A100': '80d8ff',
+        '300': '4fc3f7',
+        'A400': '00B0FF',
+        '700': '0288D1',
+        '50': 'e1f5fe',
+        'A700': '0091EA',
+        '400': '29b6f6',
+        '100': 'b3e5fc',
+        '800': '0277BD',
+        'A200': '40c4ff',
+        '500': '03A9F4'
+    },
+
+    'Purple': {
+        '200': 'ce93d8',
+        '900': '4a148c',
+        '600': '8e24aa',
+        'A100': 'ea80fc',
+        '300': 'ba68c8',
+        'A400': 'D500F9',
+        '700': '7b1fa2',
+        '50': 'f3e5f5',
+        'A700': 'AA00FF',
+        '400': 'ab47bc',
+        '100': 'e1bee7',
+        '800': '6a1b9a',
+        'A200': 'e040fb',
+        '500': '9c27b0'
+    },
+
+    'Grey': {
+        '200': 'eeeeee',
+        '900': '212121',
+        '600': '757575',
+        '300': 'e0e0e0',
+        '700': '616161',
+        '50': 'fafafa',
+        '400': 'bdbdbd',
+        '100': 'f5f5f5',
+        '800': '424242',
+        '500': '9e9e9e'
+    },
+
+    'Yellow': {
+        '200': 'fff59d',
+        '900': 'f57f17',
+        '600': 'fdd835',
+        'A100': 'ffff8d',
+        '300': 'fff176',
+        'A400': 'FFEA00',
+        '700': 'fbc02d',
+        '50': 'fffde7',
+        'A700': 'FFD600',
+        '400': 'ffee58',
+        '100': 'fff9c4',
+        '800': 'f9a825',
+        'A200': 'FFFF00',
+        '500': 'ffeb3b'
+    },
+
+    'LightGreen': {
+        '200': 'c5e1a5',
+        '900': '33691e',
+        '600': '7cb342',
+        'A100': 'ccff90',
+        '300': 'aed581',
+        'A400': '76FF03',
+        '700': '689f38',
+        '50': 'f1f8e9',
+        'A700': '64dd17',
+        '400': '9ccc65',
+        '100': 'dcedc8',
+        '800': '558b2f',
+        'A200': 'b2ff59',
+        '500': '8bc34a'
+    },
+
+    'DeepOrange': {
+        '200': 'ffab91',
+        '900': 'bf36c',
+        '600': 'f4511e',
+        'A100': 'ff9e80',
+        '300': 'ff8a65',
+        'A400': 'FF3D00',
+        '700': 'e64a19',
+        '50': 'fbe9e7',
+        'A700': 'DD2C00',
+        '400': 'ff7043',
+        '100': 'ffccbc',
+        '800': 'd84315',
+        'A200': 'ff6e40',
+        '500': 'ff5722'
+    },
+
+    'Green': {
+        '200': 'a5d6a7',
+        '900': '1b5e20',
+        '600': '43a047',
+        'A100': 'b9f6ca',
+        '300': '81c784',
+        'A400': '00E676',
+        '700': '388e3c',
+        '50': 'e8f5e9',
+        'A700': '00C853',
+        '400': '66bb6a',
+        '100': 'c8e6c9',
+        '800': '2e7d32',
+        'A200': '69f0ae',
+        '500': '4caf50'
+    },
+
+    'Red': {
+        '200': 'ef9a9a',
+        '900': 'b71c1c',
+        '600': 'e53935',
+        'A100': 'ff8a80',
+        '300': 'e57373',
+        'A400': 'ff1744',
+        '700': 'd32f2f',
+        '50': 'ffebee',
+        'A700': 'd50000',
+        '400': 'ef5350',
+        '100': 'ffcdd2',
+        '800': 'c62828',
+        'A200': 'ff5252',
+        '500': 'f44336'
+    },
+
+    'Teal': {
+        '200': '80cbc4',
+        '900': '004D40',
+        '600': '00897B',
+        'A100': 'a7ffeb',
+        '300': '4db6ac',
+        'A400': '1de9b6',
+        '700': '00796B',
+        '50': 'e0f2f1',
+        'A700': '00BFA5',
+        '400': '26a69a',
+        '100': 'b2dfdb',
+        '800': '00695C',
+        'A200': '64ffda',
+        '500': '009688'
+    },
+
+    'Orange': {
+        '200': 'ffcc80',
+        '900': 'E65100',
+        '600': 'FB8C00',
+        'A100': 'ffd180',
+        '300': 'ffb74d',
+        'A400': 'FF9100',
+        '700': 'F57C00',
+        '50': 'fff3e0',
+        'A700': 'FF6D00',
+        '400': 'ffa726',
+        '100': 'ffe0b2',
+        '800': 'EF6C00',
+        'A200': 'ffab40',
+        '500': 'FF9800'
+    },
+
+    'Cyan': {
+        '200': '80deea',
+        '900': '006064',
+        '600': '00ACC1',
+        'A100': '84ffff',
+        '300': '4dd0e1',
+        'A400': '00E5FF',
+        '700': '0097A7',
+        '50': 'e0f7fa',
+        'A700': '00B8D4',
+        '400': '26c6da',
+        '100': 'b2ebf2',
+        '800': '00838F',
+        'A200': '18ffff',
+        '500': '00BCD4'
+    },
+
+    'Amber': {
+        '200': 'ffe082',
+        '900': 'FF6F00',
+        '600': 'FFB300',
+        'A100': 'ffe57f',
+        '300': 'ffd54f',
+        'A400': 'FFC400',
+        '700': 'FFA000',
+        '50': 'fff8e1',
+        'A700': 'FFAB00',
+        '400': 'ffca28',
+        '100': 'ffecb3',
+        '800': 'FF8F00',
+        'A200': 'ffd740',
+        '500': 'FFC107'
+    },
+
+    'DeepPurple': {
+        '200': 'b39ddb',
+        '900': '311b92',
+        '600': '5e35b1',
+        'A100': 'b388ff',
+        '300': '9575cd',
+        'A400': '651fff',
+        '700': '512da8',
+        '50': 'ede7f6',
+        'A700': '6200EA',
+        '400': '7e57c2',
+        '100': 'd1c4e9',
+        '800': '4527a0',
+        'A200': '7c4dff',
+        '500': '673ab7'
+    },
+
+    'Lime': {
+        '200': 'e6ee9c',
+        '900': '827717',
+        '600': 'c0ca33',
+        'A100': 'f4ff81',
+        '300': 'dce775',
+        'A400': 'C6FF00',
+        '700': 'afb42b',
+        '50': 'f9fbe7',
+        'A700': 'AEEA00',
+        '400': 'd4e157',
+        '100': 'f0f4c3',
+        '800': '9e9d24',
+        'A200': 'eeff41',
+        '500': 'cddc39'
+    },
+
+    'Light': {
+        'StatusBar': 'E0E0E0',
+        'AppBar': 'F5F5F5',
+        'Background': 'FAFAFA',
+        'CardsDialogs': 'FFFFFF',
+        'FlatButtonDown': 'cccccc'
+    },
+
+    'Dark': {
+        'StatusBar': '000000',
+        'AppBar': '212121',
+        'Background': '303030',
+        'CardsDialogs': '424242',
+        'FlatButtonDown': '999999'
+    }
+}
+
+light_colors = {
+    'Pink': ['50' '100', '200', 'A100'],
+    'Blue': ['50' '100', '200', '300', '400', 'A100'],
+    'Indigo': ['50' '100', '200', 'A100'],
+    'BlueGrey': ['50' '100', '200', '300'],
+    'Brown': ['50' '100', '200'],
+    'LightBlue': ['50' '100', '200', '300', '400', '500', 'A100', 'A200',
+                  'A400'],
+    'Purple': ['50' '100', '200', 'A100'],
+    'Grey': ['50' '100', '200', '300', '400', '500'],
+    'Yellow': ['50' '100', '200', '300', '400', '500', '600', '700', '800',
+               '900', 'A100', 'A200', 'A400', 'A700'],
+    'LightGreen': ['50' '100', '200', '300', '400', '500', '600', 'A100',
+                   'A200', 'A400', 'A700'],
+    'DeepOrange': ['50' '100', '200', '300', '400', 'A100', 'A200'],
+    'Green': ['50' '100', '200', '300', '400', '500', 'A100', 'A200', 'A400',
+              'A700'],
+    'Red': ['50' '100', '200', '300', 'A100'],
+    'Teal': ['50' '100', '200', '300', '400', 'A100', 'A200', 'A400', 'A700'],
+    'Orange': ['50' '100', '200', '300', '400', '500', '600', '700', 'A100',
+               'A200', 'A400', 'A700'],
+    'Cyan': ['50' '100', '200', '300', '400', '500', '600', 'A100', 'A200',
+             'A400', 'A700'],
+    'Amber': ['50' '100', '200', '300', '400', '500', '600', '700', '800',
+              '900', 'A100', 'A200', 'A400', 'A700'],
+    'DeepPurple': ['50' '100', '200', 'A100'],
+    'Lime': ['50' '100', '200', '300', '400', '500', '600', '700', '800',
+             'A100', 'A200', 'A400', 'A700'],
+    'Dark': [],
+    'Light': ['White', 'MainBackground', 'DialogBackground']
+}

src/kivymd/date_picker.py

@@ -0,0 +1,325 @@
+# -*- coding: utf-8 -*-
+from kivy.lang import Builder
+from kivy.uix.modalview import ModalView
+from kivymd.label import MDLabel
+from kivymd.theming import ThemableBehavior
+from kivy.uix.floatlayout import FloatLayout
+from kivymd.elevationbehavior import ElevationBehavior
+import calendar
+from datetime import date
+import datetime
+from kivy.properties import StringProperty, NumericProperty, ObjectProperty, \
+    BooleanProperty
+from kivy.uix.anchorlayout import AnchorLayout
+from kivy.uix.behaviors import ButtonBehavior
+from kivymd.ripplebehavior import CircularRippleBehavior
+from kivy.clock import Clock
+from kivy.core.window import Window
+
+Builder.load_string("""
+#:import calendar calendar
+<MDDatePicker>
+    cal_layout: cal_layout
+
+    size_hint: (None, None)
+    size: [dp(328), dp(484)] if self.theme_cls.device_orientation == 'portrait'\
+        else [dp(512), dp(304)]
+    pos_hint: {'center_x': .5, 'center_y': .5}
+    canvas:
+        Color:
+            rgb: app.theme_cls.primary_color
+        Rectangle:
+            size: [dp(328), dp(96)] if self.theme_cls.device_orientation == 'portrait'\
+                else [dp(168), dp(304)]
+            pos: [root.pos[0], root.pos[1] + root.height-dp(96)] if self.theme_cls.device_orientation == 'portrait'\
+                else [root.pos[0], root.pos[1] + root.height-dp(304)]
+        Color:
+            rgb: app.theme_cls.bg_normal
+        Rectangle:
+            size: [dp(328), dp(484)-dp(96)] if self.theme_cls.device_orientation == 'portrait'\
+                else [dp(344), dp(304)]
+            pos: [root.pos[0], root.pos[1] + root.height-dp(96)-(dp(484)-dp(96))]\
+                if self.theme_cls.device_orientation == 'portrait' else [root.pos[0]+dp(168), root.pos[1]]  #+dp(334)
+    MDLabel:
+        id: label_full_date
+        font_style: 'Display1'
+        text_color: 1, 1, 1, 1
+        theme_text_color: 'Custom'
+        size_hint: (None, None)
+        size: [root.width, dp(30)] if root.theme_cls.device_orientation == 'portrait'\
+            else [dp(168), dp(30)]
+        pos: [root.pos[0]+dp(23), root.pos[1] + root.height - dp(74)] \
+            if root.theme_cls.device_orientation == 'portrait' \
+            else [root.pos[0]+dp(3), root.pos[1] + dp(214)]
+        line_height: 0.84
+        valign: 'middle'
+        text_size: [root.width, None] if root.theme_cls.device_orientation == 'portrait'\
+            else [dp(149), None]
+        bold: True
+        text: root.fmt_lbl_date(root.sel_year, root.sel_month, root.sel_day, root.theme_cls.device_orientation)
+    MDLabel:
+        id: label_year
+        font_style: 'Subhead'
+        text_color: 1, 1, 1, 1
+        theme_text_color: 'Custom'
+        size_hint: (None, None)
+        size: root.width, dp(30)
+        pos: (root.pos[0]+dp(23), root.pos[1]+root.height-dp(40)) if root.theme_cls.device_orientation == 'portrait'\
+            else (root.pos[0]+dp(16), root.pos[1]+root.height-dp(41))
+        valign: 'middle'
+        text: str(root.sel_year)
+    GridLayout:
+        id: cal_layout
+        cols: 7
+        size: (dp(44*7), dp(40*7)) if root.theme_cls.device_orientation == 'portrait'\
+            else (dp(46*7), dp(32*7))
+        col_default_width: dp(42) if root.theme_cls.device_orientation == 'portrait'\
+            else dp(39)
+        size_hint: (None, None)
+        padding: (dp(2), 0) if root.theme_cls.device_orientation == 'portrait'\
+            else (dp(7), 0)
+        spacing: (dp(2), 0) if root.theme_cls.device_orientation == 'portrait'\
+            else (dp(7), 0)
+        pos: (root.pos[0]+dp(10), root.pos[1]+dp(60)) if root.theme_cls.device_orientation == 'portrait'\
+            else (root.pos[0]+dp(168)+dp(8), root.pos[1]+dp(48))
+    MDLabel:
+        id: label_month_selector
+        font_style: 'Body2'
+        text: calendar.month_name[root.month].capitalize() + ' ' + str(root.year)
+        size_hint: (None, None)
+        size: root.width, dp(30)
+        pos: root.pos
+        theme_text_color: 'Primary'
+        pos_hint: {'center_x': 0.5, 'center_y': 0.75} if self.theme_cls.device_orientation == 'portrait'\
+            else {'center_x': 0.67, 'center_y': 0.915}
+        valign: "middle"
+        halign: "center"
+    MDIconButton:
+        icon: 'chevron-left'
+        theme_text_color: 'Secondary'
+        pos_hint: {'center_x': 0.09, 'center_y': 0.745} if root.theme_cls.device_orientation == 'portrait'\
+            else {'center_x': 0.39, 'center_y': 0.925}
+        on_release: root.change_month('prev')
+    MDIconButton:
+        icon: 'chevron-right'
+        theme_text_color: 'Secondary'
+        pos_hint: {'center_x': 0.92, 'center_y': 0.745} if root.theme_cls.device_orientation == 'portrait'\
+            else {'center_x': 0.94, 'center_y': 0.925}
+        on_release: root.change_month('next')
+    MDFlatButton:
+        pos: root.pos[0]+root.size[0]-dp(72)*2, root.pos[1] + dp(7)
+        text: "Cancel"
+        on_release: root.dismiss()
+    MDFlatButton:
+        pos: root.pos[0]+root.size[0]-dp(72), root.pos[1] + dp(7)
+        text: "OK"
+        on_release: root.ok_click()
+
+<DayButton>
+    size_hint: None, None
+    size: (dp(40), dp(40)) if root.theme_cls.device_orientation == 'portrait'\
+        else (dp(32), dp(32))
+    MDLabel:
+        font_style: 'Caption'
+        theme_text_color: 'Custom' if root.is_today and not root.is_selected else 'Primary'
+        text_color: root.theme_cls.primary_color
+        opposite_colors: root.is_selected if root.owner.sel_month == root.owner.month \
+            and root.owner.sel_year == root.owner.year and str(self.text) == str(root.owner.sel_day) else False
+        size_hint_x: None
+        valign: 'middle'
+        halign: 'center'
+        text: root.text
+
+<WeekdayLabel>
+    font_style: 'Caption'
+    theme_text_color: 'Secondary'
+    size: (dp(40), dp(40)) if root.theme_cls.device_orientation == 'portrait'\
+        else (dp(32), dp(32))
+    size_hint: None, None
+    text_size: self.size
+    valign: 'middle' if root.theme_cls.device_orientation == 'portrait' else 'bottom'
+    halign: 'center'
+
+<DaySelector>
+    size: (dp(40), dp(40)) if root.theme_cls.device_orientation == 'portrait'\
+                else (dp(32), dp(32))
+    size_hint: (None, None)
+    canvas:
+        Color:
+            rgba: self.theme_cls.primary_color if self.shown else [0, 0, 0, 0]
+        Ellipse:
+            size: (dp(40), dp(40)) if root.theme_cls.device_orientation == 'portrait'\
+                else (dp(32), dp(32))
+            pos: self.pos if root.theme_cls.device_orientation == 'portrait'\
+                else [self.pos[0] + dp(3), self.pos[1]]
+""")
+
+
+class DaySelector(ThemableBehavior, AnchorLayout):
+    shown = BooleanProperty(False)
+
+    def __init__(self, parent):
+        super(DaySelector, self).__init__()
+        self.parent_class = parent
+        self.parent_class.add_widget(self, index=7)
+        self.selected_widget = None
+        Window.bind(on_resize=self.move_resize)
+
+    def update(self):
+        parent = self.parent_class
+        if parent.sel_month == parent.month and parent.sel_year == parent.year:
+            self.shown = True
+        else:
+            self.shown = False
+
+    def set_widget(self, widget):
+        self.selected_widget = widget
+        self.pos = widget.pos
+        self.move_resize(do_again=True)
+        self.update()
+
+    def move_resize(self, window=None, width=None, height=None, do_again=True):
+        self.pos = self.selected_widget.pos
+        if do_again:
+            Clock.schedule_once(lambda x: self.move_resize(do_again=False), 0.01)
+
+
+class DayButton(ThemableBehavior, CircularRippleBehavior, ButtonBehavior,
+                AnchorLayout):
+    text = StringProperty()
+    owner = ObjectProperty()
+    is_today = BooleanProperty(False)
+    is_selected = BooleanProperty(False)
+
+    def on_release(self):
+        self.owner.set_selected_widget(self)
+
+
+class WeekdayLabel(MDLabel):
+    pass
+
+
+class MDDatePicker(FloatLayout, ThemableBehavior, ElevationBehavior,
+                   ModalView):
+    _sel_day_widget = ObjectProperty()
+    cal_list = None
+    cal_layout = ObjectProperty()
+    sel_year = NumericProperty()
+    sel_month = NumericProperty()
+    sel_day = NumericProperty()
+    day = NumericProperty()
+    month = NumericProperty()
+    year = NumericProperty()
+    today = date.today()
+    callback = ObjectProperty()
+
+    class SetDateError(Exception):
+        pass
+
+    def __init__(self, callback, year=None, month=None, day=None,
+                 firstweekday=0,
+                 **kwargs):
+        self.callback = callback
+        self.cal = calendar.Calendar(firstweekday)
+        self.sel_year = year if year else self.today.year
+        self.sel_month = month if month else self.today.month
+        self.sel_day = day if day else self.today.day
+        self.month = self.sel_month
+        self.year = self.sel_year
+        self.day = self.sel_day
+        super(MDDatePicker, self).__init__(**kwargs)
+        self.selector = DaySelector(parent=self)
+        self.generate_cal_widgets()
+        self.update_cal_matrix(self.sel_year, self.sel_month)
+        self.set_month_day(self.sel_day)
+        self.selector.update()
+
+    def ok_click(self):
+        self.callback(date(self.sel_year, self.sel_month, self.sel_day))
+        self.dismiss()
+
+    def fmt_lbl_date(self, year, month, day, orientation):
+        d = datetime.date(int(year), int(month), int(day))
+        separator = '\n' if orientation == 'landscape' else ' '
+        return d.strftime('%a,').capitalize() + separator + d.strftime(
+            '%b').capitalize() + ' ' + str(day).lstrip('0')
+
+    def set_date(self, year, month, day):
+        try:
+            date(year, month, day)
+        except Exception as e:
+            print(e)
+            if str(e) == "day is out of range for month":
+                raise self.SetDateError(" Day %s day is out of range for month %s" % (day, month))
+            elif str(e) == "month must be in 1..12":
+                raise self.SetDateError("Month must be between 1 and 12, got %s" % month)
+            elif str(e) == "year is out of range":
+                raise self.SetDateError("Year must be between %s and %s, got %s" %
+                                        (datetime.MINYEAR, datetime.MAXYEAR, year))
+        else:
+            self.sel_year = year
+            self.sel_month = month
+            self.sel_day = day
+            self.month = self.sel_month
+            self.year = self.sel_year
+            self.day = self.sel_day
+            self.update_cal_matrix(self.sel_year, self.sel_month)
+            self.set_month_day(self.sel_day)
+            self.selector.update()
+
+    def set_selected_widget(self, widget):
+        if self._sel_day_widget:
+            self._sel_day_widget.is_selected = False
+        widget.is_selected = True
+        self.sel_month = int(self.month)
+        self.sel_year = int(self.year)
+        self.sel_day = int(widget.text)
+        self._sel_day_widget = widget
+        self.selector.set_widget(widget)
+
+    def set_month_day(self, day):
+        for idx in range(len(self.cal_list)):
+            if str(day) == str(self.cal_list[idx].text):
+                self._sel_day_widget = self.cal_list[idx]
+                self.sel_day = int(self.cal_list[idx].text)
+                if self._sel_day_widget:
+                    self._sel_day_widget.is_selected = False
+                self._sel_day_widget = self.cal_list[idx]
+                self.cal_list[idx].is_selected = True
+                self.selector.set_widget(self.cal_list[idx])
+
+    def update_cal_matrix(self, year, month):
+        try:
+            dates = [x for x in self.cal.itermonthdates(year, month)]
+        except ValueError as e:
+            if str(e) == "year is out of range":
+                pass
+        else:
+            self.year = year
+            self.month = month
+            for idx in range(len(self.cal_list)):
+                if idx >= len(dates) or dates[idx].month != month:
+                    self.cal_list[idx].disabled = True
+                    self.cal_list[idx].text = ''
+                else:
+                    self.cal_list[idx].disabled = False
+                    self.cal_list[idx].text = str(dates[idx].day)
+                    self.cal_list[idx].is_today = dates[idx] == self.today
+            self.selector.update()
+
+    def generate_cal_widgets(self):
+        cal_list = []
+        for i in calendar.day_abbr:
+            self.cal_layout.add_widget(WeekdayLabel(text=i[0].upper()))
+        for i in range(6 * 7):  # 6 weeks, 7 days a week
+            db = DayButton(owner=self)
+            cal_list.append(db)
+            self.cal_layout.add_widget(db)
+        self.cal_list = cal_list
+
+    def change_month(self, operation):
+        op = 1 if operation is 'next' else -1
+        sl, sy = self.month, self.year
+        m = 12 if sl + op == 0 else 1 if sl + op == 13 else sl + op
+        y = sy - 1 if sl + op == 0 else sy + 1 if sl + op == 13 else sy
+        self.update_cal_matrix(y, m)

src/kivymd/dialog.py

@@ -0,0 +1,176 @@
+# -*- coding: utf-8 -*-
+
+from kivy.lang import Builder
+from kivy.properties import StringProperty, ObjectProperty, ListProperty
+from kivy.metrics import dp
+from kivy.uix.modalview import ModalView
+from kivy.animation import Animation
+from kivymd.theming import ThemableBehavior
+from kivymd.elevationbehavior import ElevationBehavior
+from kivymd.button import MDFlatButton
+
+Builder.load_string('''
+<MDDialog>:
+    canvas:
+        Color:
+            rgba:     self.theme_cls.bg_light
+        Rectangle:
+            size:     self.size
+            pos:     self.pos
+
+    _container:        container
+    _action_area:    action_area
+    elevation:        12
+    GridLayout:
+        cols:            1
+
+        GridLayout:
+            cols: 1
+            padding:        dp(24), dp(24), dp(24), 0
+            spacing:        dp(20)
+            MDLabel:
+                text:                root.title
+                font_style:            'Title'
+                theme_text_color:    'Primary'
+                halign:                'left'
+                valign:                'middle'
+                size_hint_y:        None
+                text_size:            self.width, None
+                height:                self.texture_size[1]
+
+            BoxLayout:
+                id:                    container
+
+        AnchorLayout:
+            anchor_x:            'right'
+            anchor_y:            'center'
+            size_hint:            1, None
+            height:                dp(48)
+            padding:            dp(8), dp(8)
+            spacing:            dp(4)
+
+            GridLayout:
+                id:                action_area
+                rows:            1
+                size_hint:        None, None if len(root._action_buttons) > 0 else 1
+                height:            dp(36) if len(root._action_buttons) > 0 else 0
+                width:            self.minimum_width
+''')
+
+
+class MDDialog(ThemableBehavior, ElevationBehavior, ModalView):
+    title = StringProperty('')
+
+    content = ObjectProperty(None)
+
+    background_color = ListProperty([0, 0, 0, .2])
+
+    _container = ObjectProperty()
+    _action_buttons = ListProperty([])
+    _action_area = ObjectProperty()
+
+    def __init__(self, **kwargs):
+        super(MDDialog, self).__init__(**kwargs)
+        self.bind(_action_buttons=self._update_action_buttons,
+                  auto_dismiss=lambda *x: setattr(self.shadow, 'on_release',
+                                                  self.shadow.dismiss if self.auto_dismiss else None))
+
+    def add_action_button(self, text, action=None):
+        """Add an :class:`FlatButton` to the right of the action area.
+
+        :param icon: Unicode character for the icon
+        :type icon: str or None
+        :param action: Function set to trigger when on_release fires
+        :type action: function or None
+        """
+        button = MDFlatButton(text=text,
+                              size_hint=(None, None),
+                              height=dp(36))
+        if action:
+            button.bind(on_release=action)
+        button.text_color = self.theme_cls.primary_color
+        button.background_color = self.theme_cls.bg_light
+        self._action_buttons.append(button)
+
+    def add_widget(self, widget):
+        if self._container:
+            if self.content:
+                raise PopupException(
+                    'Popup can have only one widget as content')
+            self.content = widget
+        else:
+            super(MDDialog, self).add_widget(widget)
+
+    def open(self, *largs):
+        '''Show the view window from the :attr:`attach_to` widget. If set, it
+        will attach to the nearest window. If the widget is not attached to any
+        window, the view will attach to the global
+        :class:`~kivy.core.window.Window`.
+        '''
+        if self._window is not None:
+            Logger.warning('ModalView: you can only open once.')
+            return self
+        # search window
+        self._window = self._search_window()
+        if not self._window:
+            Logger.warning('ModalView: cannot open view, no window found.')
+            return self
+        self._window.add_widget(self)
+        self._window.bind(on_resize=self._align_center,
+                          on_keyboard=self._handle_keyboard)
+        self.center = self._window.center
+        self.bind(size=self._align_center)
+        a = Animation(_anim_alpha=1., d=self._anim_duration)
+        a.bind(on_complete=lambda *x: self.dispatch('on_open'))
+        a.start(self)
+        return self
+
+    def dismiss(self, *largs, **kwargs):
+        '''Close the view if it is open. If you really want to close the
+        view, whatever the on_dismiss event returns, you can use the *force*
+        argument:
+        ::
+
+            view = ModalView(...)
+            view.dismiss(force=True)
+
+        When the view is dismissed, it will be faded out before being
+        removed from the parent. If you don't want animation, use::
+
+            view.dismiss(animation=False)
+
+        '''
+        if self._window is None:
+            return self
+        if self.dispatch('on_dismiss') is True:
+            if kwargs.get('force', False) is not True:
+                return self
+        if kwargs.get('animation', True):
+            Animation(_anim_alpha=0., d=self._anim_duration).start(self)
+        else:
+            self._anim_alpha = 0
+            self._real_remove_widget()
+        return self
+
+    def on_content(self, instance, value):
+        if self._container:
+            self._container.clear_widgets()
+            self._container.add_widget(value)
+
+    def on__container(self, instance, value):
+        if value is None or self.content is None:
+            return
+        self._container.clear_widgets()
+        self._container.add_widget(self.content)
+
+    def on_touch_down(self, touch):
+        if self.disabled and self.collide_point(*touch.pos):
+            return True
+        return super(MDDialog, self).on_touch_down(touch)
+
+    def _update_action_buttons(self, *args):
+        self._action_area.clear_widgets()
+        for btn in self._action_buttons:
+            btn.ids._label.texture_update()
+            btn.width = btn.ids._label.texture_size[0] + dp(16)
+            self._action_area.add_widget(btn)

src/kivymd/elevationbehavior.py

@@ -0,0 +1,187 @@
+# -*- coding: utf-8 -*-
+
+from kivy.app import App
+from kivy.lang import Builder
+from kivy.properties import (ListProperty, ObjectProperty, NumericProperty)
+from kivy.properties import AliasProperty
+from kivy.metrics import dp
+
+Builder.load_string('''
+<ElevationBehavior>
+    canvas.before:
+        Color:
+            a: self._soft_shadow_a
+        Rectangle:
+            texture: self._soft_shadow_texture
+            size: self._soft_shadow_size
+            pos: self._soft_shadow_pos
+        Color:
+            a: self._hard_shadow_a
+        Rectangle:
+            texture: self._hard_shadow_texture
+            size: self._hard_shadow_size
+            pos: self._hard_shadow_pos
+        Color:
+            a: 1
+
+<RoundElevationBehavior>
+    canvas.before:
+        Color:
+            a: self._soft_shadow_a
+        Rectangle:
+            texture: self._soft_shadow_texture
+            size: self._soft_shadow_size
+            pos: self._soft_shadow_pos
+        Color:
+            a: self._hard_shadow_a
+        Rectangle:
+            texture: self._hard_shadow_texture
+            size: self._hard_shadow_size
+            pos: self._hard_shadow_pos
+        Color:
+            a: 1
+''')
+
+
+class ElevationBehavior(object):
+    _elevation = NumericProperty(1)
+
+    def _get_elevation(self):
+        return self._elevation
+
+    def _set_elevation(self, elevation):
+        try:
+            self._elevation = elevation
+        except:
+            self._elevation = 1
+
+    elevation = AliasProperty(_get_elevation, _set_elevation,
+                              bind=('_elevation',))
+
+    _soft_shadow_texture = ObjectProperty()
+    _soft_shadow_size = ListProperty([0, 0])
+    _soft_shadow_pos = ListProperty([0, 0])
+    _soft_shadow_a = NumericProperty(0)
+    _hard_shadow_texture = ObjectProperty()
+    _hard_shadow_size = ListProperty([0, 0])
+    _hard_shadow_pos = ListProperty([0, 0])
+    _hard_shadow_a = NumericProperty(0)
+
+    def __init__(self, **kwargs):
+        super(ElevationBehavior, self).__init__(**kwargs)
+        self.bind(elevation=self._update_shadow,
+                  pos=self._update_shadow,
+                  size=self._update_shadow)
+
+    def _update_shadow(self, *args):
+        if self.elevation > 0:
+            ratio = self.width / (self.height if self.height != 0 else 1)
+            if ratio > -2 and ratio < 2:
+                self._shadow = App.get_running_app().theme_cls.quad_shadow
+                width = soft_width = self.width * 1.9
+                height = soft_height = self.height * 1.9
+            elif ratio <= -2:
+                self._shadow = App.get_running_app().theme_cls.rec_st_shadow
+                ratio = abs(ratio)
+                if ratio > 5:
+                    ratio = ratio * 22
+                else:
+                    ratio = ratio * 11.5
+
+                width = soft_width = self.width * 1.9
+                height = self.height + dp(ratio)
+                soft_height = self.height + dp(ratio) + dp(self.elevation) * .5
+            else:
+                self._shadow = App.get_running_app().theme_cls.quad_shadow
+                width = soft_width = self.width * 1.8
+                height = soft_height = self.height * 1.8
+                #                 self._shadow = App.get_running_app().theme_cls.rec_shadow
+                #                 ratio = abs(ratio)
+                #                 if ratio > 5:
+                #                     ratio = ratio * 22
+                #                 else:
+                #                     ratio = ratio * 11.5
+                #
+                #                 width = self.width + dp(ratio)
+                #                 soft_width = self.width + dp(ratio) + dp(self.elevation) * .9
+                #                 height = soft_height = self.height * 1.9
+
+            x = self.center_x - width / 2
+            soft_x = self.center_x - soft_width / 2
+            self._soft_shadow_size = (soft_width, soft_height)
+            self._hard_shadow_size = (width, height)
+
+            y = self.center_y - soft_height / 2 - dp(
+                .1 * 1.5 ** self.elevation)
+            self._soft_shadow_pos = (soft_x, y)
+            self._soft_shadow_a = 0.1 * 1.1 ** self.elevation
+            self._soft_shadow_texture = self._shadow.textures[
+                str(int(round(self.elevation - 1)))]
+
+            y = self.center_y - height / 2 - dp(.5 * 1.18 ** self.elevation)
+            self._hard_shadow_pos = (x, y)
+            self._hard_shadow_a = .4 * .9 ** self.elevation
+            self._hard_shadow_texture = self._shadow.textures[
+                str(int(round(self.elevation)))]
+
+        else:
+            self._soft_shadow_a = 0
+            self._hard_shadow_a = 0
+
+
+class RoundElevationBehavior(object):
+    _elevation = NumericProperty(1)
+
+    def _get_elevation(self):
+        return self._elevation
+
+    def _set_elevation(self, elevation):
+        try:
+            self._elevation = elevation
+        except:
+            self._elevation = 1
+
+    elevation = AliasProperty(_get_elevation, _set_elevation,
+                              bind=('_elevation',))
+
+    _soft_shadow_texture = ObjectProperty()
+    _soft_shadow_size = ListProperty([0, 0])
+    _soft_shadow_pos = ListProperty([0, 0])
+    _soft_shadow_a = NumericProperty(0)
+    _hard_shadow_texture = ObjectProperty()
+    _hard_shadow_size = ListProperty([0, 0])
+    _hard_shadow_pos = ListProperty([0, 0])
+    _hard_shadow_a = NumericProperty(0)
+
+    def __init__(self, **kwargs):
+        super(RoundElevationBehavior, self).__init__(**kwargs)
+        self._shadow = App.get_running_app().theme_cls.round_shadow
+        self.bind(elevation=self._update_shadow,
+                  pos=self._update_shadow,
+                  size=self._update_shadow)
+
+    def _update_shadow(self, *args):
+        if self.elevation > 0:
+            width = self.width * 2
+            height = self.height * 2
+
+            x = self.center_x - width / 2
+            self._soft_shadow_size = (width, height)
+
+            self._hard_shadow_size = (width, height)
+
+            y = self.center_y - height / 2 - dp(.1 * 1.5 ** self.elevation)
+            self._soft_shadow_pos = (x, y)
+            self._soft_shadow_a = 0.1 * 1.1 ** self.elevation
+            self._soft_shadow_texture = self._shadow.textures[
+                str(int(round(self.elevation)))]
+
+            y = self.center_y - height / 2 - dp(.5 * 1.18 ** self.elevation)
+            self._hard_shadow_pos = (x, y)
+            self._hard_shadow_a = .4 * .9 ** self.elevation
+            self._hard_shadow_texture = self._shadow.textures[
+                str(int(round(self.elevation - 1)))]
+
+        else:
+            self._soft_shadow_a = 0
+            self._hard_shadow_a = 0

src/kivymd/grid.py

@@ -0,0 +1,168 @@
+# coding=utf-8
+from kivy.lang import Builder
+from kivy.properties import StringProperty, BooleanProperty, ObjectProperty, \
+    NumericProperty, ListProperty, OptionProperty
+from kivy.uix.behaviors import ButtonBehavior
+from kivy.uix.boxlayout import BoxLayout
+from kivy.uix.floatlayout import FloatLayout
+from kivymd.ripplebehavior import RectangularRippleBehavior
+from kivymd.theming import ThemableBehavior
+
+Builder.load_string("""
+<SmartTile>
+    _img_widget: img
+    _img_overlay: img_overlay
+    _box_overlay: box
+    AsyncImage:
+        id: img
+        allow_stretch: root.allow_stretch
+        anim_delay: root.anim_delay
+        anim_loop: root.anim_loop
+        color: root.img_color
+        keep_ratio: root.keep_ratio
+        mipmap: root.mipmap
+        source: root.source
+        size_hint_y: 1 if root.overlap else None
+        x: root.x
+        y: root.y if root.overlap or root.box_position == 'header' else box.top
+    BoxLayout:
+        id: img_overlay
+        size_hint: img.size_hint
+        size: img.size
+        pos: img.pos
+    BoxLayout:
+        canvas:
+            Color:
+                rgba: root.box_color
+            Rectangle:
+                pos: self.pos
+                size: self.size
+        id: box
+        size_hint_y: None
+        height: dp(68) if root.lines == 2 else dp(48)
+        x: root.x
+        y: root.y if root.box_position == 'footer' else root.y + root.height - self.height
+
+<SmartTileWithLabel>
+    _img_widget: img
+    _img_overlay: img_overlay
+    _box_overlay: box
+    _box_label: boxlabel
+    AsyncImage:
+        id: img
+        allow_stretch: root.allow_stretch
+        anim_delay: root.anim_delay
+        anim_loop: root.anim_loop
+        color: root.img_color
+        keep_ratio: root.keep_ratio
+        mipmap: root.mipmap
+        source: root.source
+        size_hint_y: 1 if root.overlap else None
+        x: root.x
+        y: root.y if root.overlap or root.box_position == 'header' else box.top
+    BoxLayout:
+        id: img_overlay
+        size_hint: img.size_hint
+        size: img.size
+        pos: img.pos
+    BoxLayout:
+        canvas:
+            Color:
+                rgba: root.box_color
+            Rectangle:
+                pos: self.pos
+                size: self.size
+        id: box
+        size_hint_y: None
+        height: dp(68) if root.lines == 2 else dp(48)
+        x: root.x
+        y: root.y if root.box_position == 'footer' else root.y + root.height - self.height
+        MDLabel:
+            id: boxlabel
+            font_style: "Caption"
+            halign: "center"
+            text: root.text
+""")
+
+
+class Tile(ThemableBehavior, RectangularRippleBehavior, ButtonBehavior,
+           BoxLayout):
+    """A simple tile. It does nothing special, just inherits the right behaviors
+    to work as a building block.
+    """
+    pass
+
+
+class SmartTile(ThemableBehavior, RectangularRippleBehavior, ButtonBehavior,
+                FloatLayout):
+    """A tile for more complex needs.
+
+    Includes an image, a container to place overlays and a box that can act
+    as a header or a footer, as described in the Material Design specs.
+    """
+
+    box_color = ListProperty([0, 0, 0, 0.5])
+    """Sets the color and opacity for the information box."""
+
+    box_position = OptionProperty('footer', options=['footer', 'header'])
+    """Determines wether the information box acts as a header or footer to the
+    image.
+    """
+
+    lines = OptionProperty(1, options=[1, 2])
+    """Number of lines in the header/footer.
+
+    As per Material Design specs, only 1 and 2 are valid values.
+    """
+
+    overlap = BooleanProperty(True)
+    """Determines if the header/footer overlaps on top of the image or not"""
+
+    # Img properties
+    allow_stretch = BooleanProperty(True)
+    anim_delay = NumericProperty(0.25)
+    anim_loop = NumericProperty(0)
+    img_color = ListProperty([1, 1, 1, 1])
+    keep_ratio = BooleanProperty(False)
+    mipmap = BooleanProperty(False)
+    source = StringProperty()
+
+    _img_widget = ObjectProperty()
+    _img_overlay = ObjectProperty()
+    _box_overlay = ObjectProperty()
+    _box_label = ObjectProperty()
+
+    def reload(self):
+        self._img_widget.reload()
+
+    def add_widget(self, widget, index=0):
+        if issubclass(widget.__class__, IOverlay):
+            self._img_overlay.add_widget(widget, index)
+        elif issubclass(widget.__class__, IBoxOverlay):
+            self._box_overlay.add_widget(widget, index)
+        else:
+            super(SmartTile, self).add_widget(widget, index)
+
+
+class SmartTileWithLabel(SmartTile):
+    _box_label = ObjectProperty()
+
+    # MDLabel properties
+    font_style = StringProperty("Caption")
+    theme_text_color = StringProperty("")
+    text = StringProperty("")
+    """Determines the text for the box footer/header"""
+
+
+class IBoxOverlay():
+    """An interface to specify widgets that belong to to the image overlay
+    in the :class:`SmartTile` widget when added as a child.
+    """
+    pass
+
+
+class IOverlay():
+    """An interface to specify widgets that belong to to the image overlay
+    in the :class:`SmartTile` widget when added as a child.
+    """
+    pass

src/kivymd/icon_definitions.py

@@ -0,0 +1,1569 @@
+# -*- coding: utf-8 -*-
+
+# Thanks to Sergey Kupletsky (github.com/zavoloklom) for its Material Design
+# Iconic Font, which provides KivyMD's icons.
+
+# GALLERY HERE:
+# https://zavoloklom.github.io/material-design-iconic-font/icons.html
+
+# LAST UPDATED: version 2.2.0 of Material Design Iconic Font
+
+md_icons = {
+    '3d-rotation': u'',
+
+    'airplane-off': u'',
+
+    'address': u'',
+
+    'airplane': u'',
+
+    'album': u'',
+
+    'archive': u'',
+
+    'assignment-account': u'',
+
+    'assignment-alert': u'',
+
+    'assignment-check': u'',
+
+    'assignment-o': u'',
+
+    'assignment-return': u'',
+
+    'assignment-returned': u'',
+
+    'assignment': u'',
+
+    'attachment-alt': u'',
+
+    'attachment': u'',
+
+    'audio': u'',
+
+    'badge-check': u'',
+
+    'balance-wallet': u'',
+
+    'balance': u'',
+
+    'battery-alert': u'',
+
+    'battery-flash': u'',
+
+    'battery-unknown': u'',
+
+    'battery': u'',
+
+    'bike': u'',
+
+    'block-alt': u'',
+
+    'block': u'',
+
+    'boat': u'',
+
+    'book-image': u'',
+
+    'book': u'',
+
+    'bookmark-outline': u'',
+
+    'bookmark': u'',
+
+    'brush': u'',
+
+    'bug': u'',
+
+    'bus': u'',
+
+    'cake': u'',
+
+    'car-taxi': u'',
+
+    'car-wash': u'',
+
+    'car': u'',
+
+    'card-giftcard': u'',
+
+    'card-membership': u'',
+
+    'card-travel': u'',
+
+    'card': u'',
+
+    'case-check': u'',
+
+    'case-download': u'',
+
+    'case-play': u'',
+
+    'case': u'',
+
+    'cast-connected': u'',
+
+    'cast': u'',
+
+    'chart-donut': u'',
+
+    'chart': u'',
+
+    'city-alt': u'',
+
+    'city': u'',
+
+    'close-circle-o': u'',
+
+    'close-circle': u'',
+
+    'close': u'',
+
+    'cocktail': u'',
+
+    'code-setting': u'',
+
+    'code-smartphone': u'',
+
+    'code': u'',
+
+    'coffee': u'',
+
+    'collection-bookmark': u'',
+
+    'collection-case-play': u'',
+
+    'collection-folder-image': u'',
+
+    'collection-image-o': u'',
+
+    'collection-image': u'',
+
+    'collection-item-1': u'',
+
+    'collection-item-2': u'',
+
+    'collection-item-3': u'',
+
+    'collection-item-4': u'',
+
+    'collection-item-5': u'',
+
+    'collection-item-6': u'',
+
+    'collection-item-7': u'',
+
+    'collection-item-8': u'',
+
+    'collection-item-9-plus': u'',
+
+    'collection-item-9': u'',
+
+    'collection-item': u'',
+
+    'collection-music': u'',
+
+    'collection-pdf': u'',
+
+    'collection-plus': u'',
+
+    'collection-speaker': u'',
+
+    'collection-text': u'',
+
+    'collection-video': u'',
+
+    'compass': u'',
+
+    'cutlery': u'',
+
+    'delete': u'',
+
+    'dialpad': u'',
+
+    'dns': u'',
+
+    'drink': u'',
+
+    'edit': u'',
+
+    'email-open': u'',
+
+    'email': u'',
+
+    'eye-off': u'',
+
+    'eye': u'',
+
+    'eyedropper': u'',
+
+    'favorite-outline': u'',
+
+    'favorite': u'',
+
+    'filter-list': u'',
+
+    'fire': u'',
+
+    'flag': u'',
+
+    'flare': u'',
+
+    'flash-auto': u'',
+
+    'flash-off': u'',
+
+    'flash': u'',
+
+    'flip': u'',
+
+    'flower-alt': u'',
+
+    'flower': u'',
+
+    'font': u'',
+
+    'fullscreen-alt': u'',
+
+    'fullscreen-exit': u'',
+
+    'fullscreen': u'',
+
+    'functions': u'',
+
+    'gas-station': u'',
+
+    'gesture': u'',
+
+    'globe-alt': u'',
+
+    'globe-lock': u'',
+
+    'globe': u'',
+
+    'graduation-cap': u'',
+
+    'group': u'',
+
+    'home': u'',
+
+    'hospital-alt': u'',
+
+    'hospital': u'',
+
+    'hotel': u'',
+
+    'hourglass-alt': u'',
+
+    'hourglass-outline': u'',
+
+    'hourglass': u'',
+
+    'http': u'',
+
+    'image-alt': u'',
+
+    'image-o': u'',
+
+    'image': u'',
+
+    'inbox': u'',
+
+    'invert-colors-off': u'',
+
+    'invert-colors': u'',
+
+    'key': u'',
+
+    'label-alt-outline': u'',
+
+    'label-alt': u'',
+
+    'label-heart': u'',
+
+    'label': u'',
+
+    'labels': u'',
+
+    'lamp': u'',
+
+    'landscape': u'',
+
+    'layers-off': u'',
+
+    'layers': u'',
+
+    'library': u'',
+
+    'link': u'',
+
+    'lock-open': u'',
+
+    'lock-outline': u'',
+
+    'lock': u'',
+
+    'mail-reply-all': u'',
+
+    'mail-reply': u'',
+
+    'mail-send': u'',
+
+    'mall': u'',
+
+    'map': u'',
+
+    'menu': u'',
+
+    'money-box': u'',
+
+    'money-off': u'',
+
+    'money': u'',
+
+    'more-vert': u'',
+
+    'more': u'',
+
+    'movie-alt': u'',
+
+    'movie': u'',
+
+    'nature-people': u'',
+
+    'nature': u'',
+
+    'navigation': u'',
+
+    'open-in-browser': u'',
+
+    'open-in-new': u'',
+
+    'palette': u'',
+
+    'parking': u'',
+
+    'pin-account': u'',
+
+    'pin-assistant': u'',
+
+    'pin-drop': u'',
+
+    'pin-help': u'',
+
+    'pin-off': u'',
+
+    'pin': u'',
+
+    'pizza': u'',
+
+    'plaster': u'',
+
+    'power-setting': u'',
+
+    'power': u'',
+
+    'print': u'',
+
+    'puzzle-piece': u'',
+
+    'quote': u'',
+
+    'railway': u'',
+
+    'receipt': u'',
+
+    'refresh-alt': u'',
+
+    'refresh-sync-alert': u'',
+
+    'refresh-sync-off': u'',
+
+    'refresh-sync': u'',
+
+    'refresh': u'',
+
+    'roller': u'',
+
+    'ruler': u'',
+
+    'scissors': u'',
+
+    'screen-rotation-lock': u'',
+
+    'screen-rotation': u'',
+
+    'search-for': u'',
+
+    'search-in-file': u'',
+
+    'search-in-page': u'',
+
+    'search-replace': u'',
+
+    'search': u'',
+
+    'seat': u'',
+
+    'settings-square': u'',
+
+    'settings': u'',
+
+    'shape': u'',
+
+    'shield-check': u'',
+
+    'shield-security': u'',
+
+    'shopping-basket': u'',
+
+    'shopping-cart-plus': u'',
+
+    'shopping-cart': u'',
+
+    'sign-in': u'',
+
+    'sort-amount-asc': u'',
+
+    'sort-amount-desc': u'',
+
+    'sort-asc': u'',
+
+    'sort-desc': u'',
+
+    'spellcheck': u'',
+
+    'spinner': u'',
+
+    'storage': u'',
+
+    'store-24': u'',
+
+    'store': u'',
+
+    'subway': u'',
+
+    'sun': u'',
+
+    'tab-unselected': u'',
+
+    'tab': u'',
+
+    'tag-close': u'',
+
+    'tag-more': u'',
+
+    'tag': u'',
+
+    'thumb-down': u'',
+
+    'thumb-up-down': u'',
+
+    'thumb-up': u'',
+
+    'ticket-star': u'',
+
+    'toll': u'',
+
+    'toys': u'',
+
+    'traffic': u'',
+
+    'translate': u'',
+
+    'triangle-down': u'',
+
+    'triangle-up': u'',
+
+    'truck': u'',
+
+    'turning-sign': u'',
+
+    ' ungroup': u'',
+
+    'wallpaper': u'',
+
+    'washing-machine': u'',
+
+    'window-maximize': u'',
+
+    'window-minimize': u'',
+
+    'window-restore': u'',
+
+    'wrench': u'',
+
+    'zoom-in': u'',
+
+    'zoom-out': u'',
+
+    'alert-circle-o': u'',
+
+    'alert-circle': u'',
+
+    'alert-octagon': u'',
+
+    'alert-polygon': u'',
+
+    'alert-triangle': u'',
+
+    'help-outline': u'',
+
+    'help': u'',
+
+    'info-outline': u'',
+
+    'info': u'',
+
+    'notifications-active': u'',
+
+    'notifications-add': u'',
+
+    'notifications-none': u'',
+
+    'notifications-off': u'',
+
+    'notifications-paused': u'',
+
+    'notifications': u'',
+
+    'account-add': u'',
+
+    'account-box-mail': u'',
+
+    'account-box-o': u'',
+
+    'account-box-phone': u'',
+
+    'account-box': u'',
+
+    'account-calendar': u'',
+
+    'account-circle': u'',
+
+    'account-o': u'',
+
+    'account': u'',
+
+    'accounts-add': u'',
+
+    'accounts-alt': u'',
+
+    'accounts-list-alt': u'',
+
+    'accounts-list': u'',
+
+    'accounts-outline': u'',
+
+    'accounts': u'',
+
+    'face': u'',
+
+    'female': u'',
+
+    'male-alt': u'',
+
+    'male-female': u'',
+
+    'male': u'',
+
+    'mood-bad': u'',
+
+    'mood': u'',
+
+    'run': u'',
+
+    'walk': u'',
+
+    'cloud-box': u'',
+
+    'cloud-circle': u'',
+
+    'cloud-done': u'',
+
+    'cloud-download': u'',
+
+    'cloud-off': u'',
+
+    'cloud-outline-alt': u'',
+
+    'cloud-outline': u'',
+
+    'cloud-upload': u'',
+
+    'cloud': u'',
+
+    'download': u'',
+
+    'file-plus': u'',
+
+    'file-text': u'',
+
+    'file': u'',
+
+    'folder-outline': u'',
+
+    'folder-person': u'',
+
+    'folder-star-alt': u'',
+
+    'folder-star': u'',
+
+    'folder': u'',
+
+    'gif': u'',
+
+    'upload': u'',
+
+    'border-all': u'',
+
+    'border-bottom': u'',
+
+    'border-clear': u'',
+
+    'border-color': u'',
+
+    'border-horizontal': u'',
+
+    'border-inner': u'',
+
+    'border-left': u'',
+
+    'border-outer': u'',
+
+    'border-right': u'',
+
+    'border-style': u'',
+
+    'border-top': u'',
+
+    'border-vertical': u'',
+
+    'copy': u'',
+
+    'crop': u'',
+
+    'format-align-center': u'',
+
+    'format-align-justify': u'',
+
+    'format-align-left': u'',
+
+    'format-align-right': u'',
+
+    'format-bold': u'',
+
+    'format-clear-all': u'',
+
+    'format-clear': u'',
+
+    'format-color-fill': u'',
+
+    'format-color-reset': u'',
+
+    'format-color-text': u'',
+
+    'format-indent-decrease': u'',
+
+    'format-indent-increase': u'',
+
+    'format-italic': u'',
+
+    'format-line-spacing': u'',
+
+    'format-list-bulleted': u'',
+
+    'format-list-numbered': u'',
+
+    'format-ltr': u'',
+
+    'format-rtl': u'',
+
+    'format-size': u'',
+
+    'format-strikethrough-s': u'',
+
+    'format-strikethrough': u'',
+
+    'format-subject': u'',
+
+    'format-underlined': u'',
+
+    'format-valign-bottom': u'',
+
+    'format-valign-center': u'',
+
+    'format-valign-top': u'',
+
+    'redo': u'',
+
+    'select-all': u'',
+
+    'space-bar': u'',
+
+    'text-format': u'',
+
+    'transform': u'',
+
+    'undo': u'',
+
+    'wrap-text': u'',
+
+    'comment-alert': u'',
+
+    'comment-alt-text': u'',
+
+    'comment-alt': u'',
+
+    'comment-edit': u'',
+
+    'comment-image': u'',
+
+    'comment-list': u'',
+
+    'comment-more': u'',
+
+    'comment-outline': u'',
+
+    'comment-text-alt': u'',
+
+    'comment-text': u'',
+
+    'comment-video': u'',
+
+    'comment': u'',
+
+    'comments': u'',
+
+    'rm': u'F',
+
+    'check-all': u'',
+
+    'check-circle-u': u'',
+
+    'check-circle': u'',
+
+    'check-square': u'',
+
+    'check': u'',
+
+    'circle-o': u'',
+
+    'circle': u'',
+
+    'dot-circle-alt': u'',
+
+    'dot-circle': u'',
+
+    'minus-circle-outline': u'',
+
+    'minus-circle': u'',
+
+    'minus-square': u'',
+
+    'minus': u'',
+
+    'plus-circle-o-duplicate': u'',
+
+    'plus-circle-o': u'',
+
+    'plus-circle': u'',
+
+    'plus-square': u'',
+
+    'plus': u'',
+
+    'square-o': u'',
+
+    'star-circle': u'',
+
+    'star-half': u'',
+
+    'star-outline': u'',
+
+    'star': u'',
+
+    'bluetooth-connected': u'',
+
+    'bluetooth-off': u'',
+
+    'bluetooth-search': u'',
+
+    'bluetooth-setting': u'',
+
+    'bluetooth': u'',
+
+    'camera-add': u'',
+
+    'camera-alt': u'',
+
+    'camera-bw': u'',
+
+    'camera-front': u'',
+
+    'camera-mic': u'',
+
+    'camera-party-mode': u'',
+
+    'camera-rear': u'',
+
+    'camera-roll': u'',
+
+    'camera-switch': u'',
+
+    'camera': u'',
+
+    'card-alert': u'',
+
+    'card-off': u'',
+
+    'card-sd': u'',
+
+    'card-sim': u'',
+
+    'desktop-mac': u'',
+
+    'desktop-windows': u'',
+
+    'device-hub': u'',
+
+    'devices-off': u'',
+
+    'devices': u'',
+
+    'dock': u'',
+
+    'floppy': u'',
+
+    'gamepad': u'',
+
+    'gps-dot': u'',
+
+    'gps-off': u'',
+
+    'gps': u'',
+
+    'headset-mic': u'',
+
+    'headset': u'',
+
+    'input-antenna': u'',
+
+    'input-composite': u'',
+
+    'input-hdmi': u'',
+
+    'input-power': u'',
+
+    'input-svideo': u'',
+
+    'keyboard-hide': u'',
+
+    'keyboard': u'',
+
+    'laptop-chromebook': u'',
+
+    'laptop-mac': u'',
+
+    'laptop': u'',
+
+    'mic-off': u'',
+
+    'mic-outline': u'',
+
+    'mic-setting': u'',
+
+    'mic': u'',
+
+    'mouse': u'',
+
+    'network-alert': u'',
+
+    'network-locked': u'',
+
+    'network-off': u'',
+
+    'network-outline': u'',
+
+    'network-setting': u'',
+
+    'network': u'',
+
+    'phone-bluetooth': u'',
+
+    'phone-end': u'',
+
+    'phone-forwarded': u'',
+
+    'phone-in-talk': u'',
+
+    'phone-locked': u'',
+
+    'phone-missed': u'',
+
+    'phone-msg': u'',
+
+    'phone-paused': u'',
+
+    'phone-ring': u'',
+
+    'phone-setting': u'',
+
+    'phone-sip': u'',
+
+    'phone': u'',
+
+    'portable-wifi-changes': u'',
+
+    'portable-wifi-off': u'',
+
+    'portable-wifi': u'',
+
+    'radio': u'',
+
+    'reader': u'',
+
+    'remote-control-alt': u'',
+
+    'remote-control': u'',
+
+    'router': u'',
+
+    'scanner': u'',
+
+    'smartphone-android': u'',
+
+    'smartphone-download': u'',
+
+    'smartphone-erase': u'',
+
+    'smartphone-info': u'',
+
+    'smartphone-iphone': u'',
+
+    'smartphone-landscape-lock': u'',
+
+    'smartphone-landscape': u'',
+
+    'smartphone-lock': u'',
+
+    'smartphone-portrait-lock': u'',
+
+    'smartphone-ring': u'',
+
+    'smartphone-setting': u'',
+
+    'smartphone-setup': u'',
+
+    'smartphone': u'',
+
+    'speaker': u'',
+
+    'tablet-android': u'',
+
+    'tablet-mac': u'',
+
+    'tablet': u'',
+
+    'tv-alt-play': u'',
+
+    'tv-list': u'',
+
+    'tv-play': u'',
+
+    'tv': u'',
+
+    'usb': u'',
+
+    'videocam-off': u'',
+
+    'videocam-switch': u'',
+
+    'videocam': u'',
+
+    'watch': u'',
+
+    'wifi-alt-2': u'',
+
+    'wifi-alt': u'',
+
+    'wifi-info': u'',
+
+    'wifi-lock': u'',
+
+    'wifi-off': u'',
+
+    'wifi-outline': u'',
+
+    'wifi': u'',
+
+    'arrow-left-bottom': u'',
+
+    'arrow-left': u'',
+
+    'arrow-merge': u'',
+
+    'arrow-missed': u'',
+
+    'arrow-right-top': u'',
+
+    'arrow-right': u'',
+
+    'arrow-split': u'',
+
+    'arrows': u'',
+
+    'caret-down-circle': u'',
+
+    'caret-down': u'',
+
+    'caret-left-circle': u'',
+
+    'caret-left': u'',
+
+    'caret-right-circle': u'',
+
+    'caret-right': u'',
+
+    'caret-up-circle': u'',
+
+    'caret-up': u'',
+
+    'chevron-down': u'',
+
+    'chevron-left': u'',
+
+    'chevron-right': u'',
+
+    'chevron-up': u'',
+
+    'forward': u'',
+
+    'long-arrow-down': u'',
+
+    'long-arrow-left': u'',
+
+    'long-arrow-return': u'',
+
+    'long-arrow-right': u'',
+
+    'long-arrow-tab': u'',
+
+    'long-arrow-up': u'',
+
+    'rotate-ccw': u'',
+
+    'rotate-cw': u'',
+
+    'rotate-left': u'',
+
+    'rotate-right': u'',
+
+    'square-down': u'',
+
+    'square-right': u'',
+
+    'swap-alt': u'',
+
+    'swap-vertical-circle': u'',
+
+    'swap-vertical': u'',
+
+    'swap': u'',
+
+    'trending-down': u'',
+
+    'trending-flat': u'',
+
+    'trending-up': u'',
+
+    'unfold-less': u'',
+
+    'unfold-more': u'',
+
+    'apps': u'',
+
+    'grid-off': u'',
+
+    'grid': u'',
+
+    'view-agenda': u'',
+
+    'view-array': u'',
+
+    'view-carousel': u'',
+
+    'view-column': u'',
+
+    'view-comfy': u'',
+
+    'view-compact': u'',
+
+    'view-dashboard': u'',
+
+    'view-day': u'',
+
+    'view-headline': u'',
+
+    'view-list-alt': u'',
+
+    'view-list': u'',
+
+    'view-module': u'',
+
+    'view-quilt': u'',
+
+    'view-stream': u'',
+
+    'view-subtitles': u'',
+
+    'view-toc': u'',
+
+    'view-web': u'',
+
+    'view-week': u'',
+
+    'widgets': u'',
+
+    'alarm-check': u'',
+
+    'alarm-off': u'',
+
+    'alarm-plus': u'',
+
+    'alarm-snooze': u'',
+
+    'alarm': u'',
+
+    'calendar-alt': u'',
+
+    'calendar-check': u'',
+
+    'calendar-close': u'',
+
+    'calendar-note': u'',
+
+    'calendar': u'',
+
+    'time-countdown': u'',
+
+    'time-interval': u'',
+
+    'time-restore-setting': u'',
+
+    'time-restore': u'',
+
+    'time': u'',
+
+    'timer-off': u'',
+
+    'timer': u'',
+
+    'android-alt': u'',
+
+    'android': u'',
+
+    'apple': u'',
+
+    'behance': u'',
+
+    'codepen': u'',
+
+    'dribbble': u'',
+
+    'dropbox': u'',
+
+    'evernote': u'',
+
+    'facebook-box': u'',
+
+    'facebook': u'',
+
+    'github-box': u'',
+
+    'github': u'',
+
+    'google-drive': u'',
+
+    'google-earth': u'',
+
+    'google-glass': u'',
+
+    'google-maps': u'',
+
+    'google-pages': u'',
+
+    'google-play': u'',
+
+    'google-plus-box': u'',
+
+    'google-plus': u'',
+
+    'google': u'',
+
+    'instagram': u'',
+
+    'language-css3': u'',
+
+    'language-html5': u'',
+
+    'language-javascript': u'',
+
+    'language-python-alt': u'',
+
+    'language-python': u'',
+
+    'lastfm': u'',
+
+    'linkedin-box': u'',
+
+    'paypal': u'',
+
+    'pinterest-box': u'',
+
+    'pocket': u'',
+
+    'polymer': u'',
+
+    'rss': u'',
+
+    'share': u'',
+
+    'stackoverflow': u'',
+
+    'steam-square': u'',
+
+    'steam': u'',
+
+    'twitter-box': u'',
+
+    'twitter': u'',
+
+    'vk': u'',
+
+    'wikipedia': u'',
+
+    'windows': u'',
+
+    '500px': u'',
+
+    '8tracks': u'',
+
+    'amazon': u'',
+
+    'blogger': u'',
+
+    'delicious': u'',
+
+    'disqus': u'',
+
+    'flattr': u'',
+
+    'flickr': u'',
+
+    'github-alt': u'',
+
+    'google-old': u'',
+
+    'linkedin': u'',
+
+    'odnoklassniki': u'',
+
+    'outlook': u'',
+
+    'paypal-alt': u'',
+
+    'pinterest': u'',
+
+    'playstation': u'',
+
+    'reddit': u'',
+
+    'skype': u'',
+
+    'slideshare': u'',
+
+    'soundcloud': u'',
+
+    'tumblr': u'',
+
+    'twitch': u'',
+
+    'vimeo': u'',
+
+    'whatsapp': u'',
+
+    'xbox': u'',
+
+    'yahoo': u'',
+
+    'youtube-play': u'',
+
+    'youtube': u'',
+
+    'aspect-ratio-alt': u'',
+
+    'aspect-ratio': u'',
+
+    'blur-circular': u'',
+
+    'blur-linear': u'',
+
+    'blur-off': u'',
+
+    'blur': u'',
+
+    'brightness-2': u'',
+
+    'brightness-3': u'',
+
+    'brightness-4': u'',
+
+    'brightness-5': u'',
+
+    'brightness-6': u'',
+
+    'brightness-7': u'',
+
+    'brightness-auto': u'',
+
+    'brightness-setting': u'',
+
+    'broken-image': u'',
+
+    'center-focus-strong': u'',
+
+    'center-focus-weak': u'',
+
+    'compare': u'',
+
+    'crop-16-9': u'',
+
+    'crop-3-2': u'',
+
+    'crop-5-4': u'',
+
+    'crop-7-5': u'',
+
+    'crop-din': u'',
+
+    'crop-free': u'',
+
+    'crop-landscape': u'',
+
+    'crop-portrait': u'',
+
+    'crop-square': u'',
+
+    'exposure-alt': u'',
+
+    'exposure': u'',
+
+    'filter-b-and-w': u'',
+
+    'filter-center-focus': u'',
+
+    'filter-frames': u'',
+
+    'filter-tilt-shift': u'',
+
+    'gradient': u'',
+
+    'grain': u'',
+
+    'graphic-eq': u'',
+
+    'hdr-off': u'',
+
+    'hdr-strong': u'',
+
+    'hdr-weak': u'',
+
+    'hdr': u'',
+
+    'iridescent': u'',
+
+    'leak-off': u'',
+
+    'leak': u'',
+
+    'looks': u'',
+
+    'loupe': u'',
+
+    'panorama-horizontal': u'',
+
+    'panorama-vertical': u'',
+
+    'panorama-wide-angle': u'',
+
+    'photo-size-select-large': u'',
+
+    'photo-size-select-small': u'',
+
+    'picture-in-picture': u'',
+
+    'slideshow': u'',
+
+    'texture': u'',
+
+    'tonality': u'',
+
+    'vignette': u'',
+
+    'wb-auto': u'',
+
+    'eject-alt': u'',
+
+    'eject': u'',
+
+    'equalizer': u'',
+
+    'fast-forward': u'',
+
+    'fast-rewind': u'',
+
+    'forward-10': u'',
+
+    'forward-30': u'',
+
+    'forward-5': u'',
+
+    'hearing': u'',
+
+    'pause-circle-outline': u'',
+
+    'pause-circle': u'',
+
+    'pause': u'',
+
+    'play-circle-outline': u'',
+
+    'play-circle': u'',
+
+    'play': u'',
+
+    'playlist-audio': u'',
+
+    'playlist-plus': u'',
+
+    'repeat-one': u'',
+
+    'repeat': u'',
+
+    'replay-10': u'',
+
+    'replay-30': u'',
+
+    'replay-5': u'',
+
+    'replay': u'',
+
+    'shuffle': u'',
+
+    'skip-next': u'',
+
+    'skip-previous': u'',
+
+    'stop': u'',
+
+    'surround-sound': u'',
+
+    'tune': u'',
+
+    'volume-down': u'',
+
+    'volume-mute': u'',
+
+    'volume-off': u'',
+
+    'volume-up': u'',
+
+    'n-1-square': u'',
+
+    'n-2-square': u'',
+
+    'n-3-square': u'',
+
+    'n-4-square': u'',
+
+    'n-5-square': u'',
+
+    'n-6-square': u'',
+
+    'neg-1': u'',
+
+    'neg-2': u'',
+
+    'plus-1': u'',
+
+    'plus-2': u'',
+
+    'sec-10': u'',
+
+    'sec-3': u'',
+
+    'zero': u'',
+
+    'airline-seat-flat-angled': u'',
+
+    'airline-seat-flat': u'',
+
+    'airline-seat-individual-suite': u'',
+
+    'airline-seat-legroom-extra': u'',
+
+    'airline-seat-legroom-normal': u'',
+
+    'airline-seat-legroom-reduced': u'',
+
+    'airline-seat-recline-extra': u'',
+
+    'airline-seat-recline-normal': u'',
+
+    'airplay': u'',
+
+    'closed-caption': u'',
+
+    'confirmation-number': u'',
+
+    'developer-board': u'',
+
+    'disc-full': u'',
+
+    'explicit': u'',
+
+    'flight-land': u'',
+
+    'flight-takeoff': u'',
+
+    'flip-to-back': u'',
+
+    'flip-to-front': u'',
+
+    'group-work': u'',
+
+    'hd': u'',
+
+    'hq': u'',
+
+    'markunread-mailbox': u'',
+
+    'memory': u'',
+
+    'nfc': u'',
+
+    'play-for-work': u'',
+
+    'power-input': u'',
+
+    'present-to-all': u'',
+
+    'satellite': u'',
+
+    'tap-and-play': u'',
+
+    'vibration': u'',
+
+    'voicemail': u'',
+}

src/kivymd/images/quad_shadow.atlas

@@ -0,0 +1 @@
+{"quad_shadow-1.png": {"20": [2, 136, 128, 128], "21": [132, 136, 128, 128], "22": [262, 136, 128, 128], "23": [2, 6, 128, 128], "19": [132, 266, 128, 128], "18": [2, 266, 128, 128], "1": [262, 266, 128, 128], "3": [262, 6, 128, 128], "2": [132, 6, 128, 128]}, "quad_shadow-0.png": {"11": [262, 266, 128, 128], "10": [132, 266, 128, 128], "13": [132, 136, 128, 128], "12": [2, 136, 128, 128], "15": [2, 6, 128, 128], "14": [262, 136, 128, 128], "17": [262, 6, 128, 128], "16": [132, 6, 128, 128], "0": [2, 266, 128, 128]}, "quad_shadow-2.png": {"5": [132, 266, 128, 128], "4": [2, 266, 128, 128], "7": [2, 136, 128, 128], "6": [262, 266, 128, 128], "9": [262, 136, 128, 128], "8": [132, 136, 128, 128]}}

src/kivymd/images/rec_shadow.atlas

@@ -0,0 +1 @@
+{"rec_shadow-1.png": {"20": [2, 266, 256, 128], "21": [260, 266, 256, 128], "22": [518, 266, 256, 128], "23": [776, 266, 256, 128], "3": [260, 136, 256, 128], "2": [2, 136, 256, 128], "5": [776, 136, 256, 128], "4": [518, 136, 256, 128], "7": [260, 6, 256, 128], "6": [2, 6, 256, 128], "9": [776, 6, 256, 128], "8": [518, 6, 256, 128]}, "rec_shadow-0.png": {"11": [518, 266, 256, 128], "10": [260, 266, 256, 128], "13": [2, 136, 256, 128], "12": [776, 266, 256, 128], "15": [518, 136, 256, 128], "14": [260, 136, 256, 128], "17": [2, 6, 256, 128], "16": [776, 136, 256, 128], "19": [518, 6, 256, 128], "18": [260, 6, 256, 128], "1": [776, 6, 256, 128], "0": [2, 266, 256, 128]}}

src/kivymd/images/rec_st_shadow.atlas

@@ -0,0 +1 @@
+{"rec_st_shadow-0.png": {"11": [262, 138, 128, 256], "10": [132, 138, 128, 256], "13": [522, 138, 128, 256], "12": [392, 138, 128, 256], "15": [782, 138, 128, 256], "14": [652, 138, 128, 256], "16": [912, 138, 128, 256], "0": [2, 138, 128, 256]}, "rec_st_shadow-1.png": {"20": [522, 138, 128, 256], "21": [652, 138, 128, 256], "17": [2, 138, 128, 256], "23": [912, 138, 128, 256], "19": [262, 138, 128, 256], "18": [132, 138, 128, 256], "22": [782, 138, 128, 256], "1": [392, 138, 128, 256]}, "rec_st_shadow-2.png": {"3": [132, 138, 128, 256], "2": [2, 138, 128, 256], "5": [392, 138, 128, 256], "4": [262, 138, 128, 256], "7": [652, 138, 128, 256], "6": [522, 138, 128, 256], "9": [912, 138, 128, 256], "8": [782, 138, 128, 256]}}

src/kivymd/images/round_shadow.atlas

@@ -0,0 +1 @@
+{"round_shadow-1.png": {"20": [2, 136, 128, 128], "21": [132, 136, 128, 128], "22": [262, 136, 128, 128], "23": [2, 6, 128, 128], "19": [132, 266, 128, 128], "18": [2, 266, 128, 128], "1": [262, 266, 128, 128], "3": [262, 6, 128, 128], "2": [132, 6, 128, 128]}, "round_shadow-0.png": {"11": [262, 266, 128, 128], "10": [132, 266, 128, 128], "13": [132, 136, 128, 128], "12": [2, 136, 128, 128], "15": [2, 6, 128, 128], "14": [262, 136, 128, 128], "17": [262, 6, 128, 128], "16": [132, 6, 128, 128], "0": [2, 266, 128, 128]}, "round_shadow-2.png": {"5": [132, 266, 128, 128], "4": [2, 266, 128, 128], "7": [2, 136, 128, 128], "6": [262, 266, 128, 128], "9": [262, 136, 128, 128], "8": [132, 136, 128, 128]}}

src/kivymd/label.py

@@ -0,0 +1,94 @@
+# -*- coding: utf-8 -*-
+from kivy.lang import Builder
+from kivy.metrics import sp
+from kivy.properties import OptionProperty, DictProperty, ListProperty
+from kivy.uix.label import Label
+from kivymd.material_resources import DEVICE_TYPE
+from kivymd.theming import ThemableBehavior
+
+Builder.load_string('''
+<MDLabel>
+    disabled_color: self.theme_cls.disabled_hint_text_color
+    text_size: (self.width, None)
+''')
+
+
+class MDLabel(ThemableBehavior, Label):
+    font_style = OptionProperty(
+        'Body1', options=['Body1', 'Body2', 'Caption', 'Subhead', 'Title',
+                          'Headline', 'Display1', 'Display2', 'Display3',
+                          'Display4', 'Button', 'Icon'])
+
+    # Font, Bold, Mobile size, Desktop size (None if same as Mobile)
+    _font_styles = DictProperty({'Body1': ['Roboto', False, 14, 13],
+                                 'Body2': ['Roboto', True, 14, 13],
+                                 'Caption': ['Roboto', False, 12, None],
+                                 'Subhead': ['Roboto', False, 16, 15],
+                                 'Title': ['Roboto', True, 20, None],
+                                 'Headline': ['Roboto', False, 24, None],
+                                 'Display1': ['Roboto', False, 34, None],
+                                 'Display2': ['Roboto', False, 45, None],
+                                 'Display3': ['Roboto', False, 56, None],
+                                 'Display4': ['RobotoLight', False, 112, None],
+                                 'Button': ['Roboto', True, 14, None],
+                                 'Icon': ['Icons', False, 24, None]})
+
+    theme_text_color = OptionProperty(None, allownone=True,
+                                      options=['Primary', 'Secondary', 'Hint',
+                                               'Error', 'Custom'])
+
+    text_color = ListProperty(None, allownone=True)
+
+    _currently_bound_property = {}
+
+    def __init__(self, **kwargs):
+        super(MDLabel, self).__init__(**kwargs)
+        self.on_theme_text_color(None, self.theme_text_color)
+        self.on_font_style(None, self.font_style)
+        self.on_opposite_colors(None, self.opposite_colors)
+
+    def on_font_style(self, instance, style):
+        info = self._font_styles[style]
+        self.font_name = info[0]
+        self.bold = info[1]
+        if DEVICE_TYPE == 'desktop' and info[3] is not None:
+            self.font_size = sp(info[3])
+        else:
+            self.font_size = sp(info[2])
+
+    def on_theme_text_color(self, instance, value):
+        t = self.theme_cls
+        op = self.opposite_colors
+        setter = self.setter('color')
+        t.unbind(**self._currently_bound_property)
+        c = {}
+        if value == 'Primary':
+            c = {'text_color' if not op else 'opposite_text_color': setter}
+            t.bind(**c)
+            self.color = t.text_color if not op else t.opposite_text_color
+        elif value == 'Secondary':
+            c = {'secondary_text_color' if not op else
+                 'opposite_secondary_text_color': setter}
+            t.bind(**c)
+            self.color = t.secondary_text_color if not op else \
+                t.opposite_secondary_text_color
+        elif value == 'Hint':
+            c = {'disabled_hint_text_color' if not op else
+                 'opposite_disabled_hint_text_color': setter}
+            t.bind(**c)
+            self.color = t.disabled_hint_text_color if not op else \
+                t.opposite_disabled_hint_text_color
+        elif value == 'Error':
+            c = {'error_color': setter}
+            t.bind(**c)
+            self.color = t.error_color
+        elif value == 'Custom':
+            self.color = self.text_color if self.text_color else (0, 0, 0, 1)
+        self._currently_bound_property = c
+
+    def on_text_color(self, *args):
+        if self.theme_text_color == 'Custom':
+            self.color = self.text_color
+
+    def on_opposite_colors(self, instance, value):
+        self.on_theme_text_color(self, self.theme_text_color)

src/kivymd/list.py

@@ -0,0 +1,531 @@
+# -*- coding: utf-8 -*-
+'''
+Lists
+=====
+
+`Material Design spec, Lists page <https://www.google.com/design/spec/components/lists.html>`_
+
+`Material Design spec, Lists: Controls page <https://www.google.com/design/spec/components/lists-controls.html>`_
+
+The class :class:`MDList` in combination with a ListItem like
+:class:`OneLineListItem` will create a list that expands as items are added to
+it, working nicely with Kivy's :class:`~kivy.uix.scrollview.ScrollView`.
+
+
+Simple examples
+---------------
+
+Kv Lang:
+
+.. code-block:: python
+
+    ScrollView:
+        do_scroll_x: False  # Important for MD compliance
+        MDList:
+            OneLineListItem:
+                text: "Single-line item"
+            TwoLineListItem:
+                text: "Two-line item"
+                secondary_text: "Secondary text here"
+            ThreeLineListItem:
+                text: "Three-line item"
+                secondary_text: "This is a multi-line label where you can fit more text than usual"
+
+
+Python:
+
+.. code-block:: python
+
+    # Sets up ScrollView with MDList, as normally used in Android:
+    sv = ScrollView()
+    ml = MDList()
+    sv.add_widget(ml)
+
+    contacts = ["Paula", "John", "Kate", "Vlad"]
+    for c in contacts:
+        ml.add_widget(
+            OneLineListItem(
+                text=c
+            )
+        )
+
+Advanced usage
+--------------
+
+Due to the variety in sizes and controls in the MD spec, this module suffers
+from a certain level of complexity to keep the widgets compliant, flexible
+and performant.
+
+For this KivyMD provides ListItems that try to cover the most common usecases,
+when those are insufficient, there's a base class called :class:`ListItem`
+which you can use to create your own ListItems. This documentation will only
+cover the provided ones, for custom implementations please refer to this
+module's source code.
+
+Text only ListItems
+-------------------
+
+- :class:`~OneLineListItem`
+- :class:`~TwoLineListItem`
+- :class:`~ThreeLineListItem`
+
+These are the simplest ones. The :attr:`~ListItem.text` attribute changes the
+text in the most prominent line, while :attr:`~ListItem.secondary_text`
+changes the second and third line.
+
+If there are only two lines, :attr:`~ListItem.secondary_text` will shorten
+the text to fit in case it is too long; if a third line is available, it will
+instead wrap the text to make use of it.
+
+ListItems with widget containers
+--------------------------------
+
+- :class:`~OneLineAvatarListItem`
+- :class:`~TwoLineAvatarListItem`
+- :class:`~ThreeLineAvatarListItem`
+- :class:`~OneLineIconListItem`
+- :class:`~TwoLineIconListItem`
+- :class:`~ThreeLineIconListItem`
+- :class:`~OneLineAvatarIconListItem`
+- :class:`~TwoLineAvatarIconListItem`
+- :class:`~ThreeLineAvatarIconListItem`
+
+These widgets will take other widgets that inherit from :class:`~ILeftBody`,
+:class:`ILeftBodyTouch`, :class:`~IRightBody` or :class:`~IRightBodyTouch` and
+put them in their corresponding container.
+
+As the name implies, :class:`~ILeftBody` and :class:`~IRightBody` will signal
+that the widget goes into the left or right container, respectively.
+
+:class:`~ILeftBodyTouch` and :class:`~IRightBodyTouch` do the same thing,
+except these widgets will also receive touch events that occur within their
+surfaces.
+
+Python example:
+
+.. code-block:: python
+
+    class ContactPhoto(ILeftBody, AsyncImage):
+        pass
+
+    class MessageButton(IRightBodyTouch, MDIconButton):
+        phone_number = StringProperty()
+
+        def on_release(self):
+            # sample code:
+            Dialer.send_sms(phone_number, "Hey! What's up?")
+            pass
+
+    # Sets up ScrollView with MDList, as normally used in Android:
+    sv = ScrollView()
+    ml = MDList()
+    sv.add_widget(ml)
+
+    contacts = [
+        ["Annie", "555-24235", "http://myphotos.com/annie.png"],
+        ["Bob", "555-15423", "http://myphotos.com/bob.png"],
+        ["Claire", "555-66098", "http://myphotos.com/claire.png"]
+    ]
+
+    for c in contacts:
+        item = TwoLineAvatarIconListItem(
+            text=c[0],
+            secondary_text=c[1]
+        )
+        item.add_widget(ContactPhoto(source=c[2]))
+        item.add_widget(MessageButton(phone_number=c[1])
+        ml.add_widget(item)
+
+API
+---
+'''
+
+from kivy.lang import Builder
+from kivy.metrics import dp
+from kivy.properties import ObjectProperty, StringProperty, NumericProperty, \
+    ListProperty, OptionProperty
+from kivy.uix.behaviors import ButtonBehavior
+from kivy.uix.floatlayout import FloatLayout
+from kivy.uix.gridlayout import GridLayout
+import kivymd.material_resources as m_res
+from kivymd.ripplebehavior import RectangularRippleBehavior
+from kivymd.theming import ThemableBehavior
+
+Builder.load_string('''
+#:import m_res kivymd.material_resources
+<MDList>
+    cols: 1
+    size_hint_y: None
+    height: self._min_list_height
+    padding: 0, self._list_vertical_padding
+
+<BaseListItem>
+    size_hint_y: None
+    canvas:
+        Color:
+            rgba: self.theme_cls.divider_color
+        Line:
+            points: root.x,root.y, root.x+self.width,root.y
+    BoxLayout:
+        id: _text_container
+        orientation: 'vertical'
+        pos: root.pos
+        padding: root._txt_left_pad, root._txt_top_pad, root._txt_right_pad, root._txt_bot_pad
+        MDLabel:
+            id: _lbl_primary
+            text: root.text
+            font_style: root.font_style
+            theme_text_color: root.theme_text_color
+            text_color: root.text_color
+            size_hint_y: None
+            height: self.texture_size[1]
+        MDLabel:
+            id: _lbl_secondary
+            text: '' if root._num_lines == 1 else root.secondary_text
+            font_style: root.secondary_font_style
+            theme_text_color: root.secondary_theme_text_color
+            text_color: root.secondary_text_color
+            size_hint_y: None
+            height: 0 if root._num_lines == 1 else self.texture_size[1]
+            shorten: True if root._num_lines == 2 else False
+
+<OneLineAvatarListItem>
+    BoxLayout:
+        id: _left_container
+        size_hint: None, None
+        x: root.x + dp(16)
+        y: root.y + root.height/2 - self.height/2
+        size: dp(40), dp(40)
+
+<ThreeLineAvatarListItem>
+    BoxLayout:
+        id: _left_container
+        size_hint: None, None
+        x: root.x + dp(16)
+        y: root.y + root.height - root._txt_top_pad - self.height - dp(5)
+        size: dp(40), dp(40)
+
+<OneLineIconListItem>
+    BoxLayout:
+        id: _left_container
+        size_hint: None, None
+        x: root.x + dp(16)
+        y: root.y + root.height/2 - self.height/2
+        size: dp(48), dp(48)
+
+<ThreeLineIconListItem>
+    BoxLayout:
+        id: _left_container
+        size_hint: None, None
+        x: root.x + dp(16)
+        y: root.y + root.height - root._txt_top_pad - self.height - dp(5)
+        size: dp(48), dp(48)
+
+<OneLineRightIconListItem>
+    BoxLayout:
+        id: _right_container
+        size_hint: None, None
+        x: root.x + root.width - m_res.HORIZ_MARGINS - self.width
+        y: root.y + root.height/2 - self.height/2
+        size: dp(48), dp(48)
+
+<ThreeLineRightIconListItem>
+    BoxLayout:
+        id: _right_container
+        size_hint: None, None
+        x: root.x + root.width - m_res.HORIZ_MARGINS - self.width
+        y: root.y + root.height/2 - self.height/2
+        size: dp(48), dp(48)
+
+<OneLineAvatarIconListItem>
+    BoxLayout:
+        id: _right_container
+        size_hint: None, None
+        x: root.x + root.width - m_res.HORIZ_MARGINS - self.width
+        y: root.y + root.height/2 - self.height/2
+        size: dp(48), dp(48)
+
+<TwoLineAvatarIconListItem>
+    BoxLayout:
+        id: _right_container
+        size_hint: None, None
+        x: root.x + root.width - m_res.HORIZ_MARGINS - self.width
+        y: root.y + root.height/2 - self.height/2
+        size: dp(48), dp(48)
+
+<ThreeLineAvatarIconListItem>
+    BoxLayout:
+        id: _right_container
+        size_hint: None, None
+        x: root.x + root.width - m_res.HORIZ_MARGINS - self.width
+        y: root.y + root.height - root._txt_top_pad - self.height - dp(5)
+        size: dp(48), dp(48)
+''')
+
+
+class MDList(GridLayout):
+    '''ListItem container. Best used in conjunction with a
+    :class:`kivy.uix.ScrollView`.
+
+    When adding (or removing) a widget, it will resize itself to fit its
+    children, plus top and bottom paddings as described by the MD spec.
+    '''
+    selected = ObjectProperty()
+    _min_list_height = dp(16)
+    _list_vertical_padding = dp(8)
+
+    icon = StringProperty()
+
+    def add_widget(self, widget, index=0):
+        super(MDList, self).add_widget(widget, index)
+        self.height += widget.height
+
+    def remove_widget(self, widget):
+        super(MDList, self).remove_widget(widget)
+        self.height -= widget.height
+
+
+class BaseListItem(ThemableBehavior, RectangularRippleBehavior,
+                   ButtonBehavior, FloatLayout):
+    '''Base class to all ListItems. Not supposed to be instantiated on its own.
+    '''
+
+    text = StringProperty()
+    '''Text shown in the first line.
+
+    :attr:`text` is a :class:`~kivy.properties.StringProperty` and defaults
+    to "".
+    '''
+    
+    text_color = ListProperty(None)
+    ''' Text color used if theme_text_color is set to 'Custom' '''
+
+    font_style = OptionProperty(
+        'Subhead', options=['Body1', 'Body2', 'Caption', 'Subhead', 'Title',
+                            'Headline', 'Display1', 'Display2', 'Display3',
+                            'Display4', 'Button', 'Icon'])
+    
+    theme_text_color = StringProperty('Primary',allownone=True)
+    ''' Theme text color for primary text '''
+
+    secondary_text = StringProperty()
+    '''Text shown in the second and potentially third line.
+
+    The text will wrap into the third line if the ListItem's type is set to
+    \'one-line\'. It can be forced into the third line by adding a \\n
+    escape sequence.
+
+    :attr:`secondary_text` is a :class:`~kivy.properties.StringProperty` and
+    defaults to "".
+    '''
+    
+    secondary_text_color = ListProperty(None)
+    ''' Text color used for secondary text if secondary_theme_text_color 
+    is set to 'Custom' '''
+    
+    secondary_theme_text_color = StringProperty('Secondary',allownone=True)
+    ''' Theme text color for secondary primary text '''
+    
+    secondary_font_style = OptionProperty(
+        'Body1', options=['Body1', 'Body2', 'Caption', 'Subhead', 'Title',
+                          'Headline', 'Display1', 'Display2', 'Display3',
+                          'Display4', 'Button', 'Icon'])
+
+    _txt_left_pad = NumericProperty(dp(16))
+    _txt_top_pad = NumericProperty()
+    _txt_bot_pad = NumericProperty()
+    _txt_right_pad = NumericProperty(m_res.HORIZ_MARGINS)
+    _num_lines = 2
+
+
+class ILeftBody:
+    '''Pseudo-interface for widgets that go in the left container for
+    ListItems that support it.
+
+    Implements nothing and requires no implementation, for annotation only.
+    '''
+    pass
+
+
+class ILeftBodyTouch:
+    '''Same as :class:`~ILeftBody`, but allows the widget to receive touch
+    events instead of triggering the ListItem's ripple effect
+    '''
+    pass
+
+
+class IRightBody:
+    '''Pseudo-interface for widgets that go in the right container for
+    ListItems that support it.
+
+    Implements nothing and requires no implementation, for annotation only.
+    '''
+    pass
+
+
+class IRightBodyTouch:
+    '''Same as :class:`~IRightBody`, but allows the widget to receive touch
+    events instead of triggering the ListItem's ripple effect
+    '''
+    pass
+
+
+class ContainerSupport:
+    '''Overrides add_widget in a ListItem to include support for I*Body
+    widgets when the appropiate containers are present.
+    '''
+    _touchable_widgets = ListProperty()
+
+    def add_widget(self, widget, index=0):
+        if issubclass(widget.__class__, ILeftBody):
+            self.ids['_left_container'].add_widget(widget)
+        elif issubclass(widget.__class__, ILeftBodyTouch):
+            self.ids['_left_container'].add_widget(widget)
+            self._touchable_widgets.append(widget)
+        elif issubclass(widget.__class__, IRightBody):
+            self.ids['_right_container'].add_widget(widget)
+        elif issubclass(widget.__class__, IRightBodyTouch):
+            self.ids['_right_container'].add_widget(widget)
+            self._touchable_widgets.append(widget)
+        else:
+            return super(BaseListItem, self).add_widget(widget,index)
+
+    def remove_widget(self, widget):
+        super(BaseListItem, self).remove_widget(widget)
+        if widget in self._touchable_widgets:
+            self._touchable_widgets.remove(widget)
+
+    def on_touch_down(self, touch):
+        if self.propagate_touch_to_touchable_widgets(touch, 'down'):
+            return
+        super(BaseListItem, self).on_touch_down(touch)
+
+    def on_touch_move(self, touch, *args):
+        if self.propagate_touch_to_touchable_widgets(touch, 'move', *args):
+            return
+        super(BaseListItem, self).on_touch_move(touch, *args)
+
+    def on_touch_up(self, touch):
+        if self.propagate_touch_to_touchable_widgets(touch, 'up'):
+            return
+        super(BaseListItem, self).on_touch_up(touch)
+
+    def propagate_touch_to_touchable_widgets(self, touch, touch_event, *args):
+        triggered = False
+        for i in self._touchable_widgets:
+            if i.collide_point(touch.x, touch.y):
+                triggered = True
+                if touch_event == 'down':
+                    i.on_touch_down(touch)
+                elif touch_event == 'move':
+                    i.on_touch_move(touch, *args)
+                elif touch_event == 'up':
+                    i.on_touch_up(touch)
+        return triggered
+
+
+class OneLineListItem(BaseListItem):
+    _txt_top_pad = NumericProperty(dp(16))
+    _txt_bot_pad = NumericProperty(dp(15))  # dp(20) - dp(5)
+    _num_lines = 1
+
+    def __init__(self, **kwargs):
+        super(OneLineListItem, self).__init__(**kwargs)
+        self.height = dp(48)
+
+
+class TwoLineListItem(BaseListItem):
+    _txt_top_pad = NumericProperty(dp(20))
+    _txt_bot_pad = NumericProperty(dp(15))  # dp(20) - dp(5)
+
+    def __init__(self, **kwargs):
+        super(TwoLineListItem, self).__init__(**kwargs)
+        self.height = dp(72)
+
+
+class ThreeLineListItem(BaseListItem):
+    _txt_top_pad = NumericProperty(dp(16))
+    _txt_bot_pad = NumericProperty(dp(15))  # dp(20) - dp(5)
+    _num_lines = 3
+
+    def __init__(self, **kwargs):
+        super(ThreeLineListItem, self).__init__(**kwargs)
+        self.height = dp(88)
+
+
+class OneLineAvatarListItem(ContainerSupport, BaseListItem):
+    _txt_left_pad = NumericProperty(dp(72))
+    _txt_top_pad = NumericProperty(dp(20))
+    _txt_bot_pad = NumericProperty(dp(19))  # dp(24) - dp(5)
+    _num_lines = 1
+
+    def __init__(self, **kwargs):
+        super(OneLineAvatarListItem, self).__init__(**kwargs)
+        self.height = dp(56)
+
+
+class TwoLineAvatarListItem(OneLineAvatarListItem):
+    _txt_top_pad = NumericProperty(dp(20))
+    _txt_bot_pad = NumericProperty(dp(15))  # dp(20) - dp(5)
+    _num_lines = 2
+
+    def __init__(self, **kwargs):
+        super(BaseListItem, self).__init__(**kwargs)
+        self.height = dp(72)
+
+
+class ThreeLineAvatarListItem(ContainerSupport, ThreeLineListItem):
+    _txt_left_pad = NumericProperty(dp(72))
+
+
+class OneLineIconListItem(ContainerSupport, OneLineListItem):
+    _txt_left_pad = NumericProperty(dp(72))
+
+
+class TwoLineIconListItem(OneLineIconListItem):
+    _txt_top_pad = NumericProperty(dp(20))
+    _txt_bot_pad = NumericProperty(dp(15))  # dp(20) - dp(5)
+    _num_lines = 2
+
+    def __init__(self, **kwargs):
+        super(BaseListItem, self).__init__(**kwargs)
+        self.height = dp(72)
+
+
+class ThreeLineIconListItem(ContainerSupport, ThreeLineListItem):
+    _txt_left_pad = NumericProperty(dp(72))
+
+
+class OneLineRightIconListItem(ContainerSupport, OneLineListItem):
+    # dp(40) = dp(16) + dp(24):
+    _txt_right_pad = NumericProperty(dp(40) + m_res.HORIZ_MARGINS)
+
+
+class TwoLineRightIconListItem(OneLineRightIconListItem):
+    _txt_top_pad = NumericProperty(dp(20))
+    _txt_bot_pad = NumericProperty(dp(15))  # dp(20) - dp(5)
+    _num_lines = 2
+
+    def __init__(self, **kwargs):
+        super(BaseListItem, self).__init__(**kwargs)
+        self.height = dp(72)
+
+
+class ThreeLineRightIconListitem(ContainerSupport, ThreeLineListItem):
+    # dp(40) = dp(16) + dp(24):
+    _txt_right_pad = NumericProperty(dp(40) + m_res.HORIZ_MARGINS)
+
+
+class OneLineAvatarIconListItem(OneLineAvatarListItem):
+    # dp(40) = dp(16) + dp(24):
+    _txt_right_pad = NumericProperty(dp(40) + m_res.HORIZ_MARGINS)
+
+
+class TwoLineAvatarIconListItem(TwoLineAvatarListItem):
+    # dp(40) = dp(16) + dp(24):
+    _txt_right_pad = NumericProperty(dp(40) + m_res.HORIZ_MARGINS)
+
+
+class ThreeLineAvatarIconListItem(ThreeLineAvatarListItem):
+    # dp(40) = dp(16) + dp(24):
+    _txt_right_pad = NumericProperty(dp(40) + m_res.HORIZ_MARGINS)

src/kivymd/material_resources.py

@@ -0,0 +1,50 @@
+# -*- coding: utf-8 -*-
+from kivy import platform
+from kivy.core.window import Window
+from kivy.metrics import dp
+from kivymd import fonts_path
+
+# Feel free to override this const if you're designing for a device such as
+# a GNU/Linux tablet.
+if platform != "android" and platform != "ios":
+    DEVICE_TYPE = "desktop"
+elif Window.width >= dp(600) and Window.height >= dp(600):
+    DEVICE_TYPE = "tablet"
+else:
+    DEVICE_TYPE = "mobile"
+
+if DEVICE_TYPE == "mobile":
+    MAX_NAV_DRAWER_WIDTH = dp(300)
+    HORIZ_MARGINS = dp(16)
+    STANDARD_INCREMENT = dp(56)
+    PORTRAIT_TOOLBAR_HEIGHT = STANDARD_INCREMENT
+    LANDSCAPE_TOOLBAR_HEIGHT = STANDARD_INCREMENT - dp(8)
+else:
+    MAX_NAV_DRAWER_WIDTH = dp(400)
+    HORIZ_MARGINS = dp(24)
+    STANDARD_INCREMENT = dp(64)
+    PORTRAIT_TOOLBAR_HEIGHT = STANDARD_INCREMENT
+    LANDSCAPE_TOOLBAR_HEIGHT = STANDARD_INCREMENT
+
+TOUCH_TARGET_HEIGHT = dp(48)
+
+FONTS = [
+    {
+        "name": "Roboto",
+        "fn_regular": fonts_path + 'Roboto-Regular.ttf',
+        "fn_bold": fonts_path + 'Roboto-Medium.ttf',
+        "fn_italic": fonts_path + 'Roboto-Italic.ttf',
+        "fn_bolditalic": fonts_path + 'Roboto-MediumItalic.ttf'
+    },
+    {
+        "name": "RobotoLight",
+        "fn_regular": fonts_path + 'Roboto-Thin.ttf',
+        "fn_bold": fonts_path + 'Roboto-Light.ttf',
+        "fn_italic": fonts_path + 'Roboto-ThinItalic.ttf',
+        "fn_bolditalic": fonts_path + 'Roboto-LightItalic.ttf'
+    },
+    {
+        "name": "Icons",
+        "fn_regular": fonts_path + 'Material-Design-Iconic-Font.ttf'
+    }
+]

src/kivymd/menu.py

@@ -0,0 +1,192 @@
+# -*- coding: utf-8 -*-
+from kivy.animation import Animation
+from kivy.clock import Clock
+from kivy.core.window import Window
+from kivy.lang import Builder
+from kivy.garden.recycleview import RecycleView
+from kivy.metrics import dp
+from kivy.properties import NumericProperty, ListProperty, OptionProperty, \
+    StringProperty
+from kivy.uix.behaviors import ButtonBehavior
+from kivy.uix.boxlayout import BoxLayout
+import kivymd.material_resources as m_res
+from kivymd.theming import ThemableBehavior
+
+Builder.load_string('''
+#:import STD_INC kivymd.material_resources.STANDARD_INCREMENT
+<MDMenuItem>
+    size_hint_y: None
+    height: dp(48)
+    padding: dp(16), 0
+    on_release: root.parent.parent.parent.parent.dismiss()  # Horrible, but hey it works
+    MDLabel:
+        text: root.text
+        theme_text_color: 'Primary'
+
+<MDMenu>
+    size_hint: None, None
+    width: root.width_mult * STD_INC
+    key_viewclass: 'viewclass'
+    key_size: 'height'
+
+<MDDropdownMenu>
+    FloatLayout:
+        id: fl
+        MDMenu:
+            id: md_menu
+            data: root.items
+            width_mult: root.width_mult
+            size_hint: None, None
+            size: 0,0
+            canvas.before:
+                Color:
+                    rgba: root.theme_cls.bg_light
+                Rectangle:
+                    size: self.size
+                    pos: self.pos
+''')
+
+
+class MDMenuItem(ButtonBehavior, BoxLayout):
+    text = StringProperty()
+
+
+class MDMenu(RecycleView):
+    width_mult = NumericProperty(1)
+
+
+class MDDropdownMenu(ThemableBehavior, BoxLayout):
+    items = ListProperty()
+    '''See :attr:`~kivy.garden.recycleview.RecycleView.data`
+    '''
+
+    width_mult = NumericProperty(1)
+    '''This number multiplied by the standard increment (56dp on mobile,
+    64dp on desktop, determines the width of the menu items.
+
+    If the resulting number were to be too big for the application Window,
+    the multiplier will be adjusted for the biggest possible one.
+    '''
+
+    max_height = NumericProperty()
+    '''The menu will grow no bigger than this number.
+
+    Set to 0 for no limit. Defaults to 0.
+    '''
+
+    border_margin = NumericProperty(dp(4))
+    '''Margin between Window border and menu
+    '''
+
+    ver_growth = OptionProperty(None, allownone=True,
+                                options=['up', 'down'])
+    '''Where the menu will grow vertically to when opening
+
+    Set to None to let the widget pick for you. Defaults to None.
+    '''
+
+    hor_growth = OptionProperty(None, allownone=True,
+                                options=['left', 'right'])
+    '''Where the menu will grow horizontally to when opening
+
+    Set to None to let the widget pick for you. Defaults to None.
+    '''
+
+    def open(self, *largs):
+        Window.add_widget(self)
+        Clock.schedule_once(lambda x: self.display_menu(largs[0]), -1)
+
+    def display_menu(self, caller):
+        # We need to pick a starting point, see how big we need to be,
+        # and where to grow to.
+
+        c = caller.to_window(caller.center_x,
+                             caller.center_y)  # Starting coords
+
+        # ---ESTABLISH INITIAL TARGET SIZE ESTIMATE---
+        target_width = self.width_mult * m_res.STANDARD_INCREMENT
+        # If we're wider than the Window...
+        if target_width > Window.width:
+            # ...reduce our multiplier to max allowed.
+            target_width = int(
+                Window.width / m_res.STANDARD_INCREMENT) * m_res.STANDARD_INCREMENT
+
+        target_height = sum([dp(48) for i in self.items])
+        # If we're over max_height...
+        if 0 < self.max_height < target_height:
+            target_height = self.max_height
+
+        # ---ESTABLISH VERTICAL GROWTH DIRECTION---
+        if self.ver_growth is not None:
+            ver_growth = self.ver_growth
+        else:
+            # If there's enough space below us:
+            if target_height <= c[1] - self.border_margin:
+                ver_growth = 'down'
+            # if there's enough space above us:
+            elif target_height < Window.height - c[1] - self.border_margin:
+                ver_growth = 'up'
+            # otherwise, let's pick the one with more space and adjust ourselves
+            else:
+                # if there's more space below us:
+                if c[1] >= Window.height - c[1]:
+                    ver_growth = 'down'
+                    target_height = c[1] - self.border_margin
+                # if there's more space above us:
+                else:
+                    ver_growth = 'up'
+                    target_height = Window.height - c[1] - self.border_margin
+
+        if self.hor_growth is not None:
+            hor_growth = self.hor_growth
+        else:
+            # If there's enough space to the right:
+            if target_width <= Window.width - c[0] - self.border_margin:
+                hor_growth = 'right'
+            # if there's enough space to the left:
+            elif target_width < c[0] - self.border_margin:
+                hor_growth = 'left'
+            # otherwise, let's pick the one with more space and adjust ourselves
+            else:
+                # if there's more space to the right:
+                if Window.width - c[0] >= c[0]:
+                    hor_growth = 'right'
+                    target_width = Window.width - c[0] - self.border_margin
+                # if there's more space to the left:
+                else:
+                    hor_growth = 'left'
+                    target_width = c[0] - self.border_margin
+
+        if ver_growth == 'down':
+            tar_y = c[1] - target_height
+        else:  # should always be 'up'
+            tar_y = c[1]
+
+        if hor_growth == 'right':
+            tar_x = c[0]
+        else:  # should always be 'left'
+            tar_x = c[0] - target_width
+        anim = Animation(x=tar_x, y=tar_y,
+                         width=target_width, height=target_height,
+                         duration=.3, transition='out_quint')
+        menu = self.ids['md_menu']
+        menu.pos = c
+        anim.start(menu)
+
+    def on_touch_down(self, touch):
+        if not self.ids['md_menu'].collide_point(*touch.pos):
+            self.dismiss()
+            return True
+        super(MDDropdownMenu, self).on_touch_down(touch)
+        return True
+
+    def on_touch_move(self, touch):
+        super(MDDropdownMenu, self).on_touch_move(touch)
+        return True
+
+    def on_touch_up(self, touch):
+        super(MDDropdownMenu, self).on_touch_up(touch)
+        return True
+
+    def dismiss(self):
+        Window.remove_widget(self)

src/kivymd/navigationdrawer.py

@@ -0,0 +1,76 @@
+# -*- coding: utf-8 -*-
+from kivy.animation import Animation
+from kivy.lang import Builder
+from kivy.properties import StringProperty, ObjectProperty
+from kivymd.elevationbehavior import ElevationBehavior
+from kivymd.icon_definitions import md_icons
+from kivymd.label import MDLabel
+from kivymd.list import OneLineIconListItem, ILeftBody, BaseListItem
+from kivymd.slidingpanel import SlidingPanel
+from kivymd.theming import ThemableBehavior
+
+Builder.load_string('''
+<NavDrawerToolbar@Toolbar>
+    canvas:
+        Color:
+            rgba: root.theme_cls.divider_color
+        Line:
+            points: self.x, self.y, self.x+self.width,self.y
+
+<NavigationDrawer>
+    _list: list
+    elevation: 0
+    canvas:
+        Color:
+            rgba: root.theme_cls.bg_light
+        Rectangle:
+            size: root.size
+            pos: root.pos
+    NavDrawerToolbar:
+        title: root.title
+        opposite_colors: False
+        title_theme_color: 'Secondary'
+        background_color: root.theme_cls.bg_light
+        elevation: 0
+    ScrollView:
+        do_scroll_x: False
+        MDList:
+            id: ml
+            id: list
+
+<NavigationDrawerIconButton>
+    NDIconLabel:
+        id: _icon
+        font_style: 'Icon'
+        theme_text_color: 'Secondary'
+''')
+
+
+class NavigationDrawer(SlidingPanel, ThemableBehavior, ElevationBehavior):
+    title = StringProperty()
+
+    _list = ObjectProperty()
+
+    def add_widget(self, widget, index=0):
+        if issubclass(widget.__class__, BaseListItem):
+            self._list.add_widget(widget, index)
+            widget.bind(on_release=lambda x: self.toggle())
+        else:
+            super(NavigationDrawer, self).add_widget(widget, index)
+
+    def _get_main_animation(self, duration, t, x, is_closing):
+        a = super(NavigationDrawer, self)._get_main_animation(duration, t, x,
+                                                              is_closing)
+        a &= Animation(elevation=0 if is_closing else 5, t=t, duration=duration)
+        return a
+
+
+class NDIconLabel(ILeftBody, MDLabel):
+    pass
+
+
+class NavigationDrawerIconButton(OneLineIconListItem):
+    icon = StringProperty()
+
+    def on_icon(self, instance, value):
+        self.ids['_icon'].text = u"{}".format(md_icons[value])

src/kivymd/progressbar.py

@@ -0,0 +1,79 @@
+# -*- coding: utf-8 -*-
+
+from kivy.lang import Builder
+from kivy.properties import ListProperty, OptionProperty, BooleanProperty
+from kivy.utils import get_color_from_hex
+from kivymd.color_definitions import colors
+from kivymd.theming import ThemableBehavior
+from kivy.uix.progressbar import ProgressBar
+
+
+Builder.load_string('''
+<MDProgressBar>:
+    canvas:
+        Clear
+        Color:
+            rgba:  self.theme_cls.divider_color
+        Rectangle:
+            size:    (self.width , dp(4)) if self.orientation == 'horizontal' else (dp(4),self.height) 
+            pos:   (self.x, self.center_y - dp(4)) if self.orientation == 'horizontal' \
+                else (self.center_x - dp(4),self.y)
+        
+            
+        Color:
+            rgba:  self.theme_cls.primary_color
+        Rectangle:
+            size:     (self.width*self.value_normalized, sp(4)) if self.orientation == 'horizontal' else (sp(4), \
+                self.height*self.value_normalized)
+            pos:    (self.width*(1-self.value_normalized)+self.x if self.reversed else self.x, self.center_y - dp(4)) \
+                if self.orientation == 'horizontal' else \
+                (self.center_x - dp(4),self.height*(1-self.value_normalized)+self.y if self.reversed else self.y)
+        
+''')
+
+
+class MDProgressBar(ThemableBehavior, ProgressBar):
+    reversed = BooleanProperty(False)
+    ''' Reverse the direction the progressbar moves. '''
+    
+    orientation = OptionProperty('horizontal', options=['horizontal', 'vertical'])
+    ''' Orientation of progressbar'''
+            
+    
+if __name__ == '__main__':
+    from kivy.app import App
+    from kivymd.theming import ThemeManager
+    
+    class ProgressBarApp(App):
+        theme_cls = ThemeManager()
+
+        def build(self):
+            return Builder.load_string("""#:import MDSlider kivymd.slider.MDSlider
+BoxLayout:
+    orientation:'vertical'
+    padding: '8dp'
+    MDSlider:
+        id:slider
+        min:0
+        max:100
+        value: 40
+        
+    MDProgressBar:
+        value: slider.value
+    MDProgressBar:
+        reversed: True
+        value: slider.value
+    BoxLayout:
+        MDProgressBar:
+            orientation:"vertical"
+            reversed: True
+            value: slider.value
+            
+        MDProgressBar:
+            orientation:"vertical"
+            value: slider.value
+        
+""")
+            
+
+    ProgressBarApp().run()

src/kivymd/ripplebehavior.py

@@ -0,0 +1,169 @@
+# -*- coding: utf-8 -*-
+from kivy.properties import ListProperty, NumericProperty, StringProperty, \
+    BooleanProperty
+from kivy.animation import Animation
+from kivy.graphics import Color, Ellipse, StencilPush, StencilPop, \
+    StencilUse, StencilUnUse, Rectangle
+
+
+class CommonRipple(object):
+    ripple_rad = NumericProperty()
+    ripple_rad_default = NumericProperty(1)
+    ripple_post = ListProperty()
+    ripple_color = ListProperty()
+    ripple_alpha = NumericProperty(.5)
+    ripple_scale = NumericProperty(None)
+    ripple_duration_in_fast = NumericProperty(.3)
+    # FIXME: These speeds should be calculated based on widget size in dp
+    ripple_duration_in_slow = NumericProperty(2)
+    ripple_duration_out = NumericProperty(.3)
+    ripple_func_in = StringProperty('out_quad')
+    ripple_func_out = StringProperty('out_quad')
+
+    doing_ripple = BooleanProperty(False)
+    finishing_ripple = BooleanProperty(False)
+    fading_out = BooleanProperty(False)
+
+    def on_touch_down(self, touch):
+        if touch.is_mouse_scrolling:
+            return False
+        if not self.collide_point(touch.x, touch.y):
+            return False
+
+        if not self.disabled:
+            if self.doing_ripple:
+                Animation.cancel_all(self, 'ripple_rad', 'ripple_color',
+                                     'rect_color')
+                self.anim_complete()
+            self.ripple_rad = self.ripple_rad_default
+            self.ripple_pos = (touch.x, touch.y)
+
+            if self.ripple_color != []:
+                pass
+            elif hasattr(self, 'theme_cls'):
+                self.ripple_color = self.theme_cls.ripple_color
+            else:
+                # If no theme, set Grey 300
+                self.ripple_color = [0.8784313725490196, 0.8784313725490196,
+                                     0.8784313725490196, self.ripple_alpha]
+            self.ripple_color[3] = self.ripple_alpha
+
+            self.lay_canvas_instructions()
+            self.finish_rad = max(self.width, self.height) * self.ripple_scale
+            self.start_ripple()
+        return super(CommonRipple, self).on_touch_down(touch)
+
+    def lay_canvas_instructions(self):
+        raise NotImplementedError
+
+    def on_touch_move(self, touch, *args):
+        if not self.collide_point(touch.x, touch.y):
+            if not self.finishing_ripple and self.doing_ripple:
+                self.finish_ripple()
+        return super(CommonRipple, self).on_touch_move(touch, *args)
+
+    def on_touch_up(self, touch):
+        if self.collide_point(touch.x, touch.y) and self.doing_ripple:
+            self.finish_ripple()
+        return super(CommonRipple, self).on_touch_up(touch)
+
+    def start_ripple(self):
+        if not self.doing_ripple:
+            anim = Animation(
+                ripple_rad=self.finish_rad,
+                t='linear',
+                duration=self.ripple_duration_in_slow)
+            anim.bind(on_complete=self.fade_out)
+            self.doing_ripple = True
+            anim.start(self)
+
+    def _set_ellipse(self, instance, value):
+        self.ellipse.size = (self.ripple_rad, self.ripple_rad)
+
+    # Adjust ellipse pos here
+
+    def _set_color(self, instance, value):
+        self.col_instruction.a = value[3]
+
+    def finish_ripple(self):
+        if self.doing_ripple and not self.finishing_ripple:
+            Animation.cancel_all(self, 'ripple_rad')
+            anim = Animation(ripple_rad=self.finish_rad,
+                             t=self.ripple_func_in,
+                             duration=self.ripple_duration_in_fast)
+            anim.bind(on_complete=self.fade_out)
+            self.finishing_ripple = True
+            anim.start(self)
+
+    def fade_out(self, *args):
+        rc = self.ripple_color
+        if not self.fading_out:
+            Animation.cancel_all(self, 'ripple_color')
+            anim = Animation(ripple_color=[rc[0], rc[1], rc[2], 0.],
+                             t=self.ripple_func_out,
+                             duration=self.ripple_duration_out)
+            anim.bind(on_complete=self.anim_complete)
+            self.fading_out = True
+            anim.start(self)
+
+    def anim_complete(self, *args):
+        self.doing_ripple = False
+        self.finishing_ripple = False
+        self.fading_out = False
+        self.canvas.after.clear()
+
+
+class RectangularRippleBehavior(CommonRipple):
+    ripple_scale = NumericProperty(2.75)
+
+    def lay_canvas_instructions(self):
+        with self.canvas.after:
+            StencilPush()
+            Rectangle(pos=self.pos, size=self.size)
+            StencilUse()
+            self.col_instruction = Color(rgba=self.ripple_color)
+            self.ellipse = \
+                Ellipse(size=(self.ripple_rad, self.ripple_rad),
+                        pos=(self.ripple_pos[0] - self.ripple_rad / 2.,
+                             self.ripple_pos[1] - self.ripple_rad / 2.))
+            StencilUnUse()
+            Rectangle(pos=self.pos, size=self.size)
+            StencilPop()
+        self.bind(ripple_color=self._set_color,
+                  ripple_rad=self._set_ellipse)
+
+    def _set_ellipse(self, instance, value):
+        super(RectangularRippleBehavior, self)._set_ellipse(instance, value)
+        self.ellipse.pos = (self.ripple_pos[0] - self.ripple_rad / 2.,
+                            self.ripple_pos[1] - self.ripple_rad / 2.)
+
+
+class CircularRippleBehavior(CommonRipple):
+    ripple_scale = NumericProperty(1)
+
+    def lay_canvas_instructions(self):
+        with self.canvas.after:
+            StencilPush()
+            self.stencil = Ellipse(size=(self.width * self.ripple_scale,
+                                         self.height * self.ripple_scale),
+                                   pos=(self.center_x - (
+                                       self.width * self.ripple_scale) / 2,
+                                        self.center_y - (
+                                            self.height * self.ripple_scale) / 2))
+            StencilUse()
+            self.col_instruction = Color(rgba=self.ripple_color)
+            self.ellipse = Ellipse(size=(self.ripple_rad, self.ripple_rad),
+                                   pos=(self.center_x - self.ripple_rad / 2.,
+                                        self.center_y - self.ripple_rad / 2.))
+            StencilUnUse()
+            Ellipse(pos=self.pos, size=self.size)
+            StencilPop()
+            self.bind(ripple_color=self._set_color,
+                      ripple_rad=self._set_ellipse)
+
+    def _set_ellipse(self, instance, value):
+        super(CircularRippleBehavior, self)._set_ellipse(instance, value)
+        if self.ellipse.size[0] > self.width * .6 and not self.fading_out:
+            self.fade_out()
+        self.ellipse.pos = (self.center_x - self.ripple_rad / 2.,
+                            self.center_y - self.ripple_rad / 2.)

src/kivymd/selectioncontrols.py

@@ -0,0 +1,240 @@
+# -*- coding: utf-8 -*-
+
+from kivy.lang import Builder
+from kivy.properties import StringProperty, ListProperty, NumericProperty
+from kivy.uix.behaviors import ToggleButtonBehavior
+from kivy.uix.label import Label
+from kivy.uix.floatlayout import FloatLayout
+from kivy.properties import AliasProperty, BooleanProperty
+from kivy.metrics import dp, sp
+from kivy.animation import Animation
+from kivy.utils import get_color_from_hex
+from kivymd.color_definitions import colors
+from kivymd.icon_definitions import md_icons
+from kivymd.theming import ThemableBehavior
+from kivymd.elevationbehavior import RoundElevationBehavior
+from kivymd.ripplebehavior import CircularRippleBehavior
+from kivy.uix.behaviors import ButtonBehavior
+from kivy.uix.widget import Widget
+
+Builder.load_string('''
+<MDCheckbox>:
+    canvas:
+        Clear
+        Color:
+            rgba:         self.color
+        Rectangle:
+            texture:    self.texture
+            size:        self.texture_size
+            pos:        int(self.center_x - self.texture_size[0] / 2.), int(self.center_y - self.texture_size[1] / 2.)
+
+    text:             self._radio_icon if self.group else self._checkbox_icon
+    font_name:        'Icons'
+    font_size:        sp(24)
+    color:            self.theme_cls.primary_color if self.active else self.theme_cls.secondary_text_color
+    halign:            'center'
+    valign:            'middle'
+
+<Thumb>:
+    color:        1, 1, 1, 1
+    canvas:
+        Color:
+            rgba:        self.color
+        Ellipse:
+            size: self.size
+            pos:        self.pos
+
+<MDSwitch>:
+    canvas.before:
+        Color:
+            rgba: self._track_color_disabled if self.disabled else \
+            (self._track_color_active if self.active else self._track_color_normal)
+        Ellipse:
+            size:             dp(16), dp(16)
+            pos:            self.x, self.center_y - dp(8)
+            angle_start:    180
+            angle_end:        360
+        Rectangle:
+            size:            self.width - dp(16), dp(16)
+            pos:            self.x + dp(8), self.center_y - dp(8)
+        Ellipse:
+            size:            dp(16), dp(16)
+            pos:            self.right - dp(16), self.center_y - dp(8)
+            angle_start:    0
+            angle_end:        180
+    on_release: thumb.trigger_action()
+
+    Thumb:
+        id:            thumb
+        size_hint:    None, None
+        size:        dp(24), dp(24)
+        pos:        root._thumb_pos
+        color:        root.thumb_color_disabled if root.disabled else \
+                    (root.thumb_color_down if root.active else root.thumb_color)
+        elevation:    4 if root.active else 2
+        on_release: setattr(root, 'active', not root.active)
+''')
+
+
+class MDCheckbox(ThemableBehavior, CircularRippleBehavior,
+                 ToggleButtonBehavior, Label):
+    active = BooleanProperty(False)
+
+    _checkbox_icon = StringProperty(
+        u"{}".format(md_icons['square-o']))
+    _radio_icon = StringProperty(u"{}".format(md_icons['circle-o']))
+    _icon_active = StringProperty(u"{}".format(md_icons['check-square']))
+
+    def __init__(self, **kwargs):
+        super(MDCheckbox, self).__init__(**kwargs)
+        self.register_event_type('on_active')
+        self.check_anim_out = Animation(font_size=0, duration=.1, t='out_quad')
+        self.check_anim_in = Animation(font_size=sp(24), duration=.1,
+                                       t='out_quad')
+        self.check_anim_out.bind(
+            on_complete=lambda *x: self.check_anim_in.start(self))
+
+    def on_state(self, *args):
+        if self.state == 'down':
+            self.check_anim_in.cancel(self)
+            self.check_anim_out.start(self)
+            self._radio_icon = u"{}".format(md_icons['dot-circle'])
+            self._checkbox_icon = u"{}".format(md_icons['check-square'])
+            self.active = True
+        else:
+            self.check_anim_in.cancel(self)
+            self.check_anim_out.start(self)
+            self._radio_icon = u"{}".format(md_icons['circle-o'])
+            self._checkbox_icon = u"{}".format(
+                md_icons['square-o'])
+            self.active = False
+
+    def on_active(self, instance, value):
+        self.state = 'down' if value else 'normal'
+
+
+class Thumb(RoundElevationBehavior, CircularRippleBehavior, ButtonBehavior,
+            Widget):
+    ripple_scale = NumericProperty(2)
+
+    def _set_ellipse(self, instance, value):
+        self.ellipse.size = (self.ripple_rad, self.ripple_rad)
+        if self.ellipse.size[0] > self.width * 1.5 and not self.fading_out:
+            self.fade_out()
+        self.ellipse.pos = (self.center_x - self.ripple_rad / 2.,
+                            self.center_y - self.ripple_rad / 2.)
+        self.stencil.pos = (
+            self.center_x - (self.width * self.ripple_scale) / 2,
+            self.center_y - (self.height * self.ripple_scale) / 2)
+
+
+class MDSwitch(ThemableBehavior, ButtonBehavior, FloatLayout):
+    active = BooleanProperty(False)
+
+    _thumb_color = ListProperty(get_color_from_hex(colors['Grey']['50']))
+
+    def _get_thumb_color(self):
+        return self._thumb_color
+
+    def _set_thumb_color(self, color, alpha=None):
+        if len(color) == 2:
+            self._thumb_color = get_color_from_hex(colors[color[0]][color[1]])
+            if alpha:
+                self._thumb_color[3] = alpha
+        elif len(color) == 4:
+            self._thumb_color = color
+
+    thumb_color = AliasProperty(_get_thumb_color, _set_thumb_color,
+                                bind=['_thumb_color'])
+
+    _thumb_color_down = ListProperty([1, 1, 1, 1])
+
+    def _get_thumb_color_down(self):
+        return self._thumb_color_down
+
+    def _set_thumb_color_down(self, color, alpha=None):
+        if len(color) == 2:
+            self._thumb_color_down = get_color_from_hex(
+                colors[color[0]][color[1]])
+            if alpha:
+                self._thumb_color_down[3] = alpha
+            else:
+                self._thumb_color_down[3] = 1
+        elif len(color) == 4:
+            self._thumb_color_down = color
+
+    thumb_color_down = AliasProperty(_get_thumb_color_down,
+                                     _set_thumb_color_down,
+                                     bind=['_thumb_color_down'])
+
+    _thumb_color_disabled = ListProperty(
+        get_color_from_hex(colors['Grey']['400']))
+
+    def _get_thumb_color_disabled(self):
+        return self._thumb_color_disabled
+
+    def _set_thumb_color_disabled(self, color, alpha=None):
+        if len(color) == 2:
+            self._thumb_color_disabled = get_color_from_hex(
+                colors[color[0]][color[1]])
+            if alpha:
+                self._thumb_color_disabled[3] = alpha
+        elif len(color) == 4:
+            self._thumb_color_disabled = color
+
+    thumb_color_down = AliasProperty(_get_thumb_color_disabled,
+                                     _set_thumb_color_disabled,
+                                     bind=['_thumb_color_disabled'])
+
+    _track_color_active = ListProperty()
+    _track_color_normal = ListProperty()
+    _track_color_disabled = ListProperty()
+    _thumb_pos = ListProperty([0, 0])
+
+    def __init__(self, **kwargs):
+        super(MDSwitch, self).__init__(**kwargs)
+        self.theme_cls.bind(theme_style=self._set_colors,
+                            primary_color=self._set_colors,
+                            primary_palette=self._set_colors)
+        self._set_colors()
+
+    def _set_colors(self, *args):
+        self._track_color_normal = self.theme_cls.disabled_hint_text_color
+        if self.theme_cls.theme_style == 'Dark':
+            self._track_color_active = self.theme_cls.primary_color
+            self._track_color_active[3] = .5
+            self._track_color_disabled = get_color_from_hex('FFFFFF')
+            self._track_color_disabled[3] = .1
+            self.thumb_color = get_color_from_hex(colors['Grey']['400'])
+            self.thumb_color_down = get_color_from_hex(
+                colors[self.theme_cls.primary_palette]['200'])
+            self.thumb_color_disabled = get_color_from_hex(
+                colors['Grey']['800'])
+        else:
+            self._track_color_active = get_color_from_hex(
+                colors[self.theme_cls.primary_palette]['200'])
+            self._track_color_active[3] = .5
+            self._track_color_disabled = self.theme_cls.disabled_hint_text_color
+            self.thumb_color_down = self.theme_cls.primary_color
+
+    def on_pos(self, *args):
+        if self.active:
+            self._thumb_pos = (self.right - dp(12), self.center_y - dp(12))
+        else:
+            self._thumb_pos = (self.x - dp(12), self.center_y - dp(12))
+        self.bind(active=self._update_thumb)
+
+    def _update_thumb(self, *args):
+        if self.active:
+            Animation.cancel_all(self, '_thumb_pos')
+            anim = Animation(
+                _thumb_pos=(self.right - dp(12), self.center_y - dp(12)),
+                duration=.2,
+                t='out_quad')
+        else:
+            Animation.cancel_all(self, '_thumb_pos')
+            anim = Animation(
+                _thumb_pos=(self.x - dp(12), self.center_y - dp(12)),
+                duration=.2,
+                t='out_quad')
+        anim.start(self)

src/kivymd/slider.py

@@ -0,0 +1,247 @@
+# -*- coding: utf-8 -*-
+
+from kivy.lang import Builder
+from kivy.properties import StringProperty, ListProperty, NumericProperty,AliasProperty, BooleanProperty
+from kivy.utils import get_color_from_hex
+from kivy.metrics import dp, sp
+from kivymd.color_definitions import colors
+from kivymd.theming import ThemableBehavior
+from kivy.uix.slider import Slider
+
+
+Builder.load_string('''
+#:import Thumb kivymd.selectioncontrols.Thumb
+
+<MDSlider>:
+    id: slider
+    canvas:
+        Clear
+        Color:
+            rgba: self._track_color_disabled if self.disabled else (self._track_color_active if self.active \
+                else self._track_color_normal)
+        Rectangle:
+            size:    (self.width - self.padding*2 - self._offset[0], dp(4)) if self.orientation == 'horizontal' \
+                else (dp(4),self.height - self.padding*2 - self._offset[1])
+            pos:   (self.x + self.padding + self._offset[0], self.center_y - dp(4)) \
+                if self.orientation == 'horizontal' else (self.center_x - dp(4),self.y + self.padding + self._offset[1])
+        
+        # If 0 draw circle
+        Color:
+            rgba: [0,0,0,0] if not self._is_off else (self._track_color_disabled if self.disabled \
+                else (self._track_color_active if self.active else self._track_color_normal))
+        Line:
+            width: 2
+            circle: (self.x+self.padding+dp(3),self.center_y-dp(2),8 if self.active else 6 ) \
+                if self.orientation == 'horizontal' else (self.center_x-dp(2),self.y+self.padding+dp(3),8 \
+                if self.active else 6)
+            
+        Color:
+            rgba: [0,0,0,0] if self._is_off \
+                else (self.thumb_color_down if not self.disabled else self._track_color_disabled)
+        Rectangle:
+            size:     ((self.width-self.padding*2)*self.value_normalized, sp(4)) \
+                if slider.orientation == 'horizontal' else (sp(4), (self.height-self.padding*2)*self.value_normalized)
+            pos:    (self.x + self.padding, self.center_y - dp(4)) if self.orientation == 'horizontal' \
+                else (self.center_x - dp(4),self.y + self.padding)
+    Thumb:
+        id:          thumb
+        size_hint:   None, None
+        size:        (dp(12), dp(12)) if root.disabled else ((dp(24), dp(24)) if root.active else (dp(16),dp(16)))
+        pos:         (slider.value_pos[0] - dp(8), slider.center_y - thumb.height/2 - dp(2)) \
+            if slider.orientation == 'horizontal' \
+            else (slider.center_x - thumb.width/2 - dp(2), slider.value_pos[1]-dp(8))
+        color:       [0,0,0,0] if slider._is_off else (root._track_color_disabled if root.disabled \
+            else root.thumb_color_down)
+        elevation:    0 if slider._is_off else (4 if root.active else 2)
+        
+''')
+
+
+class MDSlider(ThemableBehavior, Slider):
+    # If the slider is clicked
+    active = BooleanProperty(False)
+    
+    # Show the "off" ring when set to minimum value
+    show_off = BooleanProperty(True)
+    
+    # Internal state of ring
+    _is_off = BooleanProperty(False)
+    
+    # Internal adjustment to reposition sliders for ring
+    _offset = ListProperty((0, 0))
+
+    _thumb_color = ListProperty(get_color_from_hex(colors['Grey']['50']))
+    
+    def _get_thumb_color(self):
+        return self._thumb_color
+
+    def _set_thumb_color(self, color, alpha=None):
+        if len(color) == 2:
+            self._thumb_color = get_color_from_hex(colors[color[0]][color[1]])
+            if alpha:
+                self._thumb_color[3] = alpha
+        elif len(color) == 4:
+            self._thumb_color = color
+
+    thumb_color = AliasProperty(_get_thumb_color, _set_thumb_color,
+                                bind=['_thumb_color'])
+
+    _thumb_color_down = ListProperty([1, 1, 1, 1])
+
+    def _get_thumb_color_down(self):
+        return self._thumb_color_down
+
+    def _set_thumb_color_down(self, color, alpha=None):
+        if len(color) == 2:
+            self._thumb_color_down = get_color_from_hex(
+                colors[color[0]][color[1]])
+            if alpha:
+                self._thumb_color_down[3] = alpha
+            else:
+                self._thumb_color_down[3] = 1
+        elif len(color) == 4:
+            self._thumb_color_down = color
+
+    thumb_color_down = AliasProperty(_get_thumb_color_down,
+                                     _set_thumb_color_down,
+                                     bind=['_thumb_color_down'])
+
+    _thumb_color_disabled = ListProperty(
+        get_color_from_hex(colors['Grey']['400']))
+
+    def _get_thumb_color_disabled(self):
+        return self._thumb_color_disabled
+
+    def _set_thumb_color_disabled(self, color, alpha=None):
+        if len(color) == 2:
+            self._thumb_color_disabled = get_color_from_hex(
+                colors[color[0]][color[1]])
+            if alpha:
+                self._thumb_color_disabled[3] = alpha
+        elif len(color) == 4:
+            self._thumb_color_disabled = color
+
+    thumb_color_down = AliasProperty(_get_thumb_color_disabled,
+                                     _set_thumb_color_disabled,
+                                     bind=['_thumb_color_disabled'])
+
+    _track_color_active = ListProperty()
+    _track_color_normal = ListProperty()
+    _track_color_disabled = ListProperty()
+    _thumb_pos = ListProperty([0, 0])
+
+    def __init__(self, **kwargs):
+        super(MDSlider, self).__init__(**kwargs)
+        self.theme_cls.bind(theme_style=self._set_colors,
+                            primary_color=self._set_colors,
+                            primary_palette=self._set_colors)
+        self._set_colors()
+        
+    def _set_colors(self, *args):
+        if self.theme_cls.theme_style == 'Dark':
+            self._track_color_normal = get_color_from_hex('FFFFFF')
+            self._track_color_normal[3] = .3
+            self._track_color_active = self._track_color_normal
+            self._track_color_disabled = self._track_color_normal
+            self.thumb_color = get_color_from_hex(colors['Grey']['400'])
+            self.thumb_color_down = get_color_from_hex(
+                colors[self.theme_cls.primary_palette]['200'])
+            self.thumb_color_disabled = get_color_from_hex(
+                colors['Grey']['800'])
+        else:
+            self._track_color_normal = get_color_from_hex('000000')
+            self._track_color_normal[3] = 0.26
+            self._track_color_active = get_color_from_hex('000000')
+            self._track_color_active[3] = 0.38 
+            self._track_color_disabled = get_color_from_hex('000000')
+            self._track_color_disabled[3] = 0.26
+            self.thumb_color_down = self.theme_cls.primary_color
+            
+    def on_value_normalized(self, *args):
+        """ When the value == min set it to "off" state and make slider a ring """
+        self._update_is_off()
+        
+    def on_show_off(self, *args):
+        self._update_is_off()
+        
+    def _update_is_off(self):
+        self._is_off = self.show_off and (self.value_normalized == 0)
+        
+    def on__is_off(self, *args):
+        self._update_offset()
+        
+    def on_active(self, *args):
+        self._update_offset()
+        
+    def _update_offset(self):
+        """ Offset is used to shift the sliders so the background color 
+            shows through the off circle.
+        """
+        d = 2 if self.active else 0
+        self._offset = (dp(11+d), dp(11+d)) if self._is_off else (0, 0)
+    
+    def on_touch_down(self, touch):
+        if super(MDSlider, self).on_touch_down(touch):
+            self.active = True
+            
+    def on_touch_up(self,touch):
+        if super(MDSlider, self).on_touch_up(touch):
+            self.active = False
+#             thumb = self.ids['thumb']
+#             if thumb.collide_point(*touch.pos):
+#                 thumb.on_touch_down(touch)
+#                 thumb.on_touch_up(touch)
+
+if __name__ == '__main__':
+    from kivy.app import App
+    from kivymd.theming import ThemeManager
+    
+    class SliderApp(App):
+        theme_cls = ThemeManager()
+
+        def build(self):
+            return Builder.load_string("""
+BoxLayout:
+    orientation:'vertical'
+    BoxLayout:
+        size_hint_y:None
+        height: '48dp'
+        Label:
+            text:"Toggle disabled"
+            color: [0,0,0,1]
+        CheckBox:
+            on_press: slider.disabled = not slider.disabled
+    BoxLayout:
+        size_hint_y:None
+        height: '48dp'
+        Label:
+            text:"Toggle active"
+            color: [0,0,0,1]
+        CheckBox:
+            on_press: slider.active = not slider.active
+    BoxLayout:
+        size_hint_y:None
+        height: '48dp'
+        Label:
+            text:"Toggle show off"
+            color: [0,0,0,1]
+        CheckBox:
+            on_press: slider.show_off = not slider.show_off
+
+    MDSlider:
+        id:slider
+        min:0
+        max:100
+        value: 40
+    
+    MDSlider:
+        id:slider2
+        orientation:"vertical"
+        min:0
+        max:100
+        value: 40
+        
+""")
+            
+
+    SliderApp().run()