Open source UI framework written in Python, running on Windows, Linux, macOS, Android and iOS

android app ios kivy linux macos python starred-kivy-repo starred-repo ui windows

Go to file

Christian Clauss f60bba9dab Use `.items()` instead of extracting the dictionary value via explicit indexing (#8945 )		2024-12-12 22:33:40 +01:00
.ci	Fixes "permission denied" error on `macos-14` runner during osx app build job (#8924 )	2024-11-13 22:06:49 +01:00
.github	Remove Python `3.8` from supported matrix and set minimum supported version to `3.9` (#8935 )	2024-12-01 10:06:59 +01:00
doc	Add `2.x.x` to `3.x.x` migration guide (#8772 )	2024-07-06 10:25:12 +02:00
examples	Move `kivy.core.audio` to `kivy.core.audio_output`, reserve `kivy.core.audio_input` for future use #8579 (#8721 )	2024-07-01 18:27:23 +02:00
kivy	Use `.items()` instead of extracting the dictionary value via explicit indexing (#8945 )	2024-12-12 22:33:40 +01:00
tools	Bump `ANGLE` version to `chromium-6778_rev1` (#8936 )	2024-12-01 10:45:47 +01:00
.gitattributes	Adds recommended line normalization	2012-12-21 13:53:24 -05:00
.gitignore	Make VideoFFPy work with RTSP streams. (#8171 )	2023-03-22 11:53:51 -04:00
.readthedocs.yml	Fix rtd builds. (#6503 )	2019-09-04 23:33:02 -04:00
AUTHORS	add keyweeusr to the core dev list	2017-01-04 23:41:27 +02:00
CODE_OF_CONDUCT.md	Update Contribution Guidelines, add `FAQ`, `CONTACT` and `CONTRIBUTING` as separate documents, fix links (#8448 )	2023-11-23 18:31:19 +01:00
CONTACT.md	Update Contribution Guidelines, add `FAQ`, `CONTACT` and `CONTRIBUTING` as separate documents, fix links (#8448 )	2023-11-23 18:31:19 +01:00
CONTRIBUTING.md	Updated broken links in documentation.	2024-04-02 12:09:17 +05:30
FAQ.md	Fix typo and mistake at FAQ.md (#8544 )	2024-05-01 10:43:59 +02:00
LICENSE	Happy new year! Updated copyright year to 2024 (#8542 )	2024-01-01 12:02:34 +01:00
MANIFEST.in	Include pyproject.toml in sdist.	2019-12-27 23:57:37 -05:00
Makefile	Use PyPA `build` package to perform `bdist` and `kivy-examples`, to take advantage of build isolation (#8690 )	2024-04-21 11:45:53 +02:00
README.md	Make doc structure consistent and up-to-date (#8514 )	2023-12-17 10:42:49 +01:00
pyproject.toml	Add Python 3.13 to both test and support matrix (#8815 )	2024-10-26 15:39:51 +02:00
renovate.json	Add renovate.json (#8688 )	2024-04-21 12:11:23 +02:00
setup.cfg	setup.cfg: The item `option.dependency_links` dropped by `pip` in 2019 (#8942 )	2024-12-08 16:07:22 +01:00
setup.py	Remove Python `3.8` from supported matrix and set minimum supported version to `3.9` (#8935 )	2024-12-01 10:06:59 +01:00

README.md

Kivy

Kivy is an open-source Python framework for developing GUI apps that work cross-platform, including desktop, mobile and embedded platforms.

The aim is to allow for quick and easy interaction design and rapid prototyping whilst making your code reusable and deployable: Innovative user interfaces made easy.

Kivy is written in Python and Cython and is built on OpenGL ES 2.0. It supports various input devices and has an extensive (and extensible) widget library. With the same codebase, you can target Windows, macOS, Linux (including Raspberry Pi OS), Android, and iOS. All Kivy widgets are built with multitouch support.

Kivy is MIT licensed, actively developed by a great community and is supported by many projects managed by the Kivy Organization.

Installation, Documentation and Examples

Extensive installation instructions as well as tutorials and general documentation, including an API reference, can be found at https://www.kivy.org/docs. A PDF version is also available.

Kivy ships with many examples which can be found in the examples folder.

Support

Are you having trouble using the Kivy framework, or any of its related projects? Is there an error you don’t understand? Are you trying to figure out how to use it? We have volunteers who can help!

The best channels to contact us for support are listed in the latest Contact Us document.

Contributing

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

It gives details of the best places online to discuss the development with the core developers and other enthusiasts.

Sibling projects

The Kivy team manager a number of additional projects that support the Kivy eco-system.

Buildozer: a development tool for turning Python applications into binary packages ready for installation on any of a number of platforms, including mobile devices.
Plyer: a platform-independent Python API for accessing hardware features of various platforms (Android, iOS, macOS, Linux and Windows).
PyJNIus: a Python library for accessing Java classes using the Java Native Interface (JNI).
Pyobjus: Python module for accessing Objective-C classes as Python classes using Objective-C runtime reflection.
Python for Android: a development tool that packages Python apps into binaries that can run on Android devices.
Kivy iOS: a toolchain to compile the necessary libraries for iOS to run Kivy applications, and manage the creation of Xcode projects.
Audiostream: library for direct access to the microphone and speaker.
KivEnt: entity-based game engine for Kivy.
Oscpy: a Python implementation of Open Sound Control (OSC) network protocol.
Garden: widgets and libraries created and maintained by users.

Licenses

Kivy is released under the terms of the MIT License. Please refer to the LICENSE file.
The provided fonts Roboto and Roboto Mono are licensed and distributed under the terms of the Apache License, Version 2.0. The DejaVuSans (used for the virtual keyboard) license can be viewed here.
The current UI design has been adapted from Moblintouch theme's SVGs and is licensed under the terms of the LGPLv2.1.

Code of Conduct

In the interest of fostering an open and welcoming community, we as contributors and maintainers need to ensure participation in our project and our sister projects is a harassment-free and positive experience for everyone. It is vital that all interaction is conducted in a manner conveying respect, open-mindedness and gratitude.

Please consult the latest Code of Conduct.