WARNING: This project is at an unstable alpha stage and is not yet suitable for general use. Contributions are welcome.

Kivy Designer is Kivy's tool for designing graphical user interfaces (GUIs) from Kivy Widgets. You can compose and customize widgets, and test them. It is completely written in Python using Kivy.

• Kivy >= 1.9.1
• The following Python modules (available via pip):
  • watchdog
  • pygments
  • docutils
  • jedi
  • gitpython
  • six
  • kivy-garden
• The FileBrowser widget from the Kivy garden

To install the prerequisites, enter a console (on Windows use kivy.bat in the kivy folder):

pip install -U watchdog pygments docutils jedi gitpython six kivy-garden

or simple run:

pip install -Ur requirements.txt

To install the FileBrowser, enter a console (on Windows use kivy.bat in the kivy folder):

garden install filebrowser

With the prerequisites installed, you can use the designer:

git clone http://github.com/kivy/kivy-designer/

or download it manually from https://github.com/kivy/kivy-designer/archive/master.zip and extract to kivy-designer, and then run:

cd kivy-designer
python -m designer

On OS X you might need to use the kivy command instead of python if you are using our portable package.

If you're successful, you'll see something like this:

If you need assistance, you can ask for help on our mailing list:

• User Group : https://groups.google.com/group/kivy-users
• Email : [email protected]

We also have an IRC channel:

• Server : irc.freenode.net
• Port : 6667, 6697 (SSL only)
• Channel : #kivy

We love pull requests and discussing novel ideas. Check out our contribution guide and feel free to improve Kivy Designer.

The following mailing list and IRC channel are used exclusively for discussions about developing the Kivy framework and its sister projects:

• Dev Group : https://groups.google.com/group/kivy-dev
• Email : [email protected]

IRC channel:

• Server : irc.freenode.net
• Port : 6667, 6697 (SSL only)
• Channel : #kivy-dev

Kivy Designer is released under the terms of the MIT License. Please refer to the LICENSE file.