Open source UI framework written in Python, running on Windows, Linux, macOS, Android and iOS
Go to file
jfishzon d69693256d
Fix linux dependencies build instructions (#8324)
* fix linux venv & build_kivy_deps.sh creation in docs as per issue 8305

change from:
python -m virtualenv kivy_venv
to:
python -m venv kivy_venv

change from:
curl -O https://raw.githubusercontent.com/kivy/kivy/master/tools/build_linux_dependencies.sh -o build_kivy_deps.sh

to:
curl https://raw.githubusercontent.com/kivy/kivy/master/tools/build_linux_dependencies.sh -o build_kivy_deps.sh

* Update installation.rst

change from:
https://virtualenv.pypa.io/en/latest/
to:
https://docs.python.org/3/library/venv.html
2023-07-23 18:23:02 +02:00
.ci Perform RPi builds on `balenalib/raspberrypi3-*` images and skip `DISPMANX` API usage if can't be used (#8223) 2023-05-01 15:40:02 +02:00
.github macOS dependencies: Build libpng16 for freetype, so can render colored emoji 2023-07-15 16:23:53 +05:30
doc Fix linux dependencies build instructions (#8324) 2023-07-23 18:23:02 +02:00
examples core-providers (audio): removes deprecated `status` property (#8298) 2023-07-03 19:15:22 +02:00
kivy Docs: Fix double word typos (#8323) 2023-07-22 09:43:33 +02:00
tools Linux dependencies: Build libpng16 for freetype, so can render colored emoji (#8313) 2023-07-16 15:53:30 +02: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 Create CODE_OF_CONDUCT.md 2018-03-12 19:33:02 +02: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 README.md (#7757) 2022-01-19 21:03:43 +01:00
pyproject.toml distutils module is deprecated and slated for removal in 3.12 (#8070) 2023-03-23 20:35:33 +01:00
setup.cfg Pin `Pillow` version to `9.5.0` (#8310) 2023-07-02 19:02:52 +02:00
setup.py Perform RPi builds on `balenalib/raspberrypi3-*` images and skip `DISPMANX` API usage if can't be used (#8223) 2023-05-01 15:40:02 +02:00

README.md

Kivy

Innovative user interfaces made easy.

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, based on OpenGL ES 2, supports various input devices and has an extensive widget library. With the same codebase, you can target Windows, macOS, Linux, 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.

Bountysource Backers on Open Collective Sponsors on Open Collective

Coverage Status Windows Unittests Status Ubuntu Unittests Status OSX Unittests 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://kivy.org/docs. A PDF version is also available.

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

Support

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

We also have a Discord channel:

Contributing

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

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

Discord channel:

Sister projects

  • 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. [Contribute].

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]