Open source UI framework written in Python, running on Windows, Linux, macOS, Android and iOS
Go to file
Mirko Galimberti c957fee22a
Bump `SDL2` version to `2.28.5` and `SDL_image` to `2.8.0` in build dependencies script and update `kivy_deps.sdl2` on Windows (#8479)
* Bump SDL2 version in build dependencies script

* Use pre-release 2.7.1 for sdl_image

* Link for pre-releases is different

* sdl_image 2.8.0 has now been released

* Update kivy_deps.sdl2 and kivy_deps.sdl2-dev to 0.7.0 (to reflect the same changes made in Linux and macOS build scripts)
2023-12-06 20:41:22 +01:00
.ci Check `$LastExitCode` after `pytest` run, so we can catch Windows fatal errors (#8483) 2023-12-01 18:08:03 +01:00
.github Update Contribution Guidelines, add `FAQ`, `CONTACT` and `CONTRIBUTING` as separate documents, fix links (#8448) 2023-11-23 18:31:19 +01:00
doc Update Contribution Guidelines, add `FAQ`, `CONTACT` and `CONTRIBUTING` as separate documents, fix links (#8448) 2023-11-23 18:31:19 +01:00
examples WindowSDL: Add opacity feature (#8296) 2023-10-16 21:03:31 +02:00
kivy `ColorWheel` and `ColorPicker`: simplify, cleans up and add tests (#8492) 2023-12-02 11:32:17 +01:00
tools Bump `SDL2` version to `2.28.5` and `SDL_image` to `2.8.0` in build dependencies script and update `kivy_deps.sdl2` on Windows (#8479) 2023-12-06 20:41:22 +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 Update Contribution Guidelines, add `FAQ`, `CONTACT` and `CONTRIBUTING` as separate documents, fix links (#8448) 2023-11-23 18:31:19 +01:00
FAQ.md Update Contribution Guidelines, add `FAQ`, `CONTACT` and `CONTRIBUTING` as separate documents, fix links (#8448) 2023-11-23 18:31:19 +01:00
LICENSE Update Copyright and LICENSE dates (#8175) 2023-03-18 11:51:47 +01:00
MANIFEST.in Include pyproject.toml in sdist. 2019-12-27 23:57:37 -05:00
Makefile Remove remaining nosetest settings in favor of pytest (#8129) 2023-02-14 20:59:11 +01:00
README.md Update Contribution Guidelines, add `FAQ`, `CONTACT` and `CONTRIBUTING` as separate documents, fix links (#8448) 2023-11-23 18:31:19 +01:00
pyproject.toml Bump `SDL2` version to `2.28.5` and `SDL_image` to `2.8.0` in build dependencies script and update `kivy_deps.sdl2` on Windows (#8479) 2023-12-06 20:41:22 +01:00
setup.cfg Bump `SDL2` version to `2.28.5` and `SDL_image` to `2.8.0` in build dependencies script and update `kivy_deps.sdl2` on Windows (#8479) 2023-12-06 20:41:22 +01:00
setup.py Update Contribution Guidelines, add `FAQ`, `CONTACT` and `CONTRIBUTING` as separate documents, fix links (#8448) 2023-11-23 18:31:19 +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.

Backers on Open Collective Sponsors on Open Collective Contributor Covenant

PyPI - Version PyPI - Python Version

Windows Unittests Status Ubuntu Unittests Status OSX Unittests Status Coverage Status

Windows wheels Status Manylinux wheels Status Raspberry Pi wheels Status OSX wheels Status

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 dont 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: generic Python packager for Android and iOS.
  • Plyer: platform-independent Python wrapper for platform-dependent APIs.
  • Pyjnius: dynamic access to the Java/Android API from Python.
  • Pyobjus: dynamic access to the Objective-C/iOS API from Python.
  • Python for Android: toolchain for building and packaging Python applications for Android.
  • Kivy iOS: toolchain for building and packaging Kivy applications for iOS.
  • Audiostream: library for direct access to the microphone and speaker.
  • KivEnt: entity-based game engine for Kivy.
  • Garden: widgets and libraries created and maintained by users.
  • Oscpy: a fast and tested python2/3 implementation of OSC.

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.

Contributors

This project exists thanks to all the people who contribute. [Become a contributor].

Backers

Thank you to all our backers! 🙏 [Become a backer]

Sponsors

Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [Become a sponsor]