Changing the background color of a Button in Kivy

Each Answer to this Q is separated by one/two green lines.

I’m new to Kivy and having trouble specifying the background color of a Button. Here’s my simple example:


from import App
from kivy.uix.widget import Widget

class MyWidget(Widget):

class CustomButtonApp(App):
    def build(self):
        return MyWidget()

if __name__ == '__main__':

And the accompanying kv file custombutton.kv:

#:kivy 1.7.2

            rgb: (0.93, 0.93, 0.93)
            pos: self.pos
            size: self.size

        font_size: 14
        height: 28
        background_color: (1.0, 0.0, 0.0, 1.0)
        text: "I'm a Button"

I’m sure I’m missing something obvious, but I’ve been messing with this for over an hour now and getting nowhere. The button seems to get colored a hint of very dark red:

enter image description here

Is this not the way to specify the background color for a Button in Kivy?


Ah, this is a common confusion. The problem is that Button.background_color really works as a kind of tint, not just a block colour. Since the default background is a grey image (the one you normally see if you make an unstyled button), what you end up seeing is a red tint to that grey image – which comes out as the dark red you observe.

You can get the behaviour you want by replacing the background image to just one that’s plain white (it doesn’t have to be more than a few pixels), or by otherwise playing with the background_normal and background_down properties. When your background_color tints the new pure white image, you get the pure red you’re after.

I guess this isn’t so clear in the docs, I’ll try to improve it.

It’s been a while since this was first posted so maybe with updates they came up with a better solution:

    background_normal: ''
    background_color: 1, .3, .4, .85

Since the Button has a default grey, adding background color will only tint the button. By setting background_normal to ” that resets the default to white. From the white canvas the background_color works as you would expect.



The answers/resolutions are collected from stackoverflow, are licensed under cc by-sa 2.5 , cc by-sa 3.0 and cc by-sa 4.0 .