Open source UI framework written in Python, running on Windows, Linux, macOS, Android and iOS
Go to file
Mathieu Virbel adc44cc66d Makefile: remove build_factory for build/mesabuild
+ add clean pyc/pyo in kivy package
2011-01-30 14:59:02 +01:00
doc Add missing file 2011-01-30 13:57:58 +01:00
examples little canvas stress: 2011-01-29 17:13:05 +01:00
kivy shader: fixes for correctly check if the shader have been successfully compiled or not (thanks hansent) 2011-01-30 14:23:13 +01:00
.gitignore remove config.pxi + include config.pxi / config.h in gitignore 2011-01-25 17:41:50 +01:00
AUTHORS kivy: first import 2010-11-03 17:05:03 -04:00
COPYING kivy: first import 2010-11-03 17:05:03 -04:00
Makefile Makefile: remove build_factory for build/mesabuild 2011-01-30 14:59:02 +01:00
README activate nosetests + reactivate coverage (ready for buildbot !) 2011-01-21 00:02:29 +01:00
setup.cfg remove inclusive cover, or nosetest will failed. 2011-01-21 00:06:02 +01:00
setup.py deactivate opengl_debug in setup.py + fixes for compiling kivy with glew on windows (working !) 2011-01-25 19:55:48 +01:00

README

Kivy - A Gestural Toolkit living in GPU
=======================================

Website: http://kivy.org/

Kivy is the toolkit derivated from PyMT.


About 1.0 alpha
---------------

This is alpha, so keep in mind that it might not work as intended at all times.
You can post bug reports and feature requests on our Google Project page :

  http://code.google.com/p/kivy/issues/list

If you need more help, you can discuss on mailing list :

  * Google Group : http://groups.google.com/group/kivy-dev
  * Email        : kivy-dev@googlegroups.com

We also have an IRC channel :

  * Server  : irc.freenode.net
  * Channel : #kivy


Introduction
------------

Kivy is a python module for developing multi-touch enabled media rich
applications. Currently the aim is to allow for quick and easy interaction
design and rapid prototype development.

Kivy is written in python, based on OpenGL and supports different input methods
like Mouse, Dual Mouse, TUIO, WiiMote, WM_TOUCH, HIDtouch etc.

Kivy is actively being developed by a community and free to use. It operates on
all major platforms (Linux, OSX, Windows).


Installation
------------

Depending on your operating system you can follow one of the following guides
to install Kivy and the dependencies:

 * http://kivy.org/wiki/DevGuide/InstallKivyUbuntu
 * http://kivy.org/wiki/DevGuide/InstallKivyMacOSX
 * http://kivy.org/wiki/DevGuide/InstallKivyWindows

If you chose to install all the dependencies (see below) yourself, you can invoke
the setup script as follows to install kivy systemwide for python:

  python setup.py install


Dependencies
------------

Since we abstract from the libraries that we use, some dependencies are
optional and may be used instead of others. A list of dependencies and what
we use them for is http://kivy.org/wiki/Devel/FeaturesByLibraries

Here is what works best:

  * python (>= 2.6, < 3.0) - http://python.org
  * PyOpenGL >= 3.0.1
  * Pygame
  * PIL
  * GST + PyGST
  * Cython
  * nosetests >= 0.11 (for unittest)
  * coverage >= 0.34 (for coverage)


Dcoumentation, Examples & Tutorials
-----------------------------------

There is an API reference included in doc. Check the doc/README about how
to build the documentation. It's also available online at :

	http://kivy.org/docs/

There is some simple example apps in the examples folder that should get
you started for now. Additionally you may want to take a look at our wiki
at :

	http://kivy.org/wiki/


Other Python/MT resources
-------------------------

pymt.eu
^^^^^^^

Experimental toolkit in python for multitouch interaction.
Now deprecated in favour of Kivy.

movid.org
^^^^^^^^^

Another image tracker we are working on.

nuigroup.com
^^^^^^^^^^^^

THE resource and research community for open source multi touch and other
natural user interfaces.