Installation on Linux¶
Using software packages¶
For installing distribution relative packages .deb/.rpm/...
Ubuntu / Kubuntu / Xubuntu / Lubuntu (Oneirc and above)¶
Add one of the PPAs as you prefer
stable builds: $ sudo add-apt-repository ppa:kivy-team/kivy nightly builds: $ sudo add-apt-repository ppa:kivy-team/kivy-daily - Notice for Lucid users: Support has been dropped in stable PPA as Python 2.7 is needed and Python 2.6 is just provided. You can find Python2.7 in the daily PPA, but manual installation is needed.
- Notice for Oneiric users: Oneiric is supported but uses Python2.6 as the default interpreter. Don’t forget to set python2.7 as your interpreter for your project. “python”, which is linked to “python2.6” won’t work.
- Update your packagelist with your package manager
- Install python-kivy and optionally the examples, found in python-kivy-examples
Debian¶
- Add one of the PPAs into your sources.list in apt manually or via Synaptic
Wheezy:
- Notice: Don’t forget to use the python2.7 interpreter
stable builds: deb http://ppa.launchpad.net/kivy-team/kivy/ubuntu oneiric main nightly builds: deb http://ppa.launchpad.net/kivy-team/kivy-daily/ubuntu oneiric main Sqeeze:
- Update to Wheezy or install Kivy 1.5.1 from stable PPA:
stable builds: deb http://ppa.launchpad.net/kivy-team/kivy/ubuntu oneiric main
Add the GPG key to your apt keyring by
generally: $ sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys A863D2D6
Refresh your package list and install python-kivy and optionally the examples as found in python-kivy-examples
Linux Mint¶
- Find out on which Ubuntu release your installation is based on, using this overview.
- Finally continue as described for Ubuntu above, depending on which version your installation is based on.
Bodhi Linux¶
Find out which version of your distribution you are running and use the table below to find out on which Ubuntu LTS it is based on
Bodhi 1: Ubuntu 10.04 LTS aka Lucid (No packages, just manual install) Bodhi 2: Ubuntu 12.04 LTS aka Precise
- Finally continue as described for Ubuntu above, depending on which version your installation is based on.
OpenSuSE¶
Installing via One-Click-Install
- Use your preferred package-manager to install the examples, as found in python-Kivy-examples
Fedora¶
Adding the repository via terminal:
Fedora 18: $ sudo yum-config-manager --add-repo=http://download.opensuse.org/repositories/home:/thopiekar:/kivy/Fedora_18/home:thopiekar:kivy.repo
Fedora 17: $ sudo yum-config-manager --add-repo=http://download.opensuse.org/repositories/home:/thopiekar:/kivy/Fedora_17/home:thopiekar:kivy.repo
Fedora 16: $ sudo yum-config-manager --add-repo=http://download.opensuse.org/repositories/home:/thopiekar:/kivy/Fedora_16/home:thopiekar:kivy.repo
- Use now your preferred package-manager to refresh your packagelists
- Install python-Kivy and the examples, as found in python-Kivy-examples
Using software bundles ( also known as tarballs )¶
Providing dependencies¶
General¶
The following software is needed, even if your distribution is not listed above:
We prefer to use a package-manager to provide these dependencies.
Ubuntu¶
$ sudo apt-get install python-setuptools python-pygame python-opengl \
python-gst0.10 python-enchant gstreamer0.10-plugins-good python-dev \
build-essential libgl1-mesa-dev libgles2-mesa-dev cython
Upgrade Cython ( <= Oneiric [11.10] )
Using our PPA: | $ sudo add-apt-repository ppa:kivy-team/kivy-daily
$ sudo apt-get update
$ sudo apt-get install cython
|
---|
Using PIP: | $ sudo apt-get install python-pip
$ sudo pip install --upgrade cython
|
---|
Fedora¶
$ sudo yum install python-distutils-extra python-enchant freeglut PyOpenGL \
SDL_ttf-devel SDL_mixer-devel pygame pygame-devel khrplatform-devel \
mesa-libGLES mesa-libGLES-devel gstreamer-plugins-good gstreamer \
gstreamer-python mtdev-devel python-pip
$ sudo pip install --upgrade cython
$ sudo pip instll pygments
OpenSuse¶
$ sudo zypper install python-distutils-extra python-pygame python-opengl \
python-gstreamer-0_10 python-enchant gstreamer-0_10-plugins-good \
python-devel Mesa-devel python-pip
$ zypper install -t pattern devel_C_C++
$ sudo pip install --upgrade cython
$ sudo pip install pygments
Mageia 1 onwards¶
$ su
# urpmi python-setuptools python-pygame python-opengl \
gstreamer0.10-python python-enchant gstreamer0.10-plugins-good \
python-cython lib64python-devel lib64mesagl1-devel lib64mesaegl1-devel \
lib64mesaglesv2_2-devel make gcc
# easy_install pip
# pip install --upgrade cython
# pip install pygments
Installation¶
If you’re installing Kivy for the first time, do:
$ sudo easy_install kivy
If you already installed kivy before, you can upgrade it with:
$ sudo easy_install --upgrade kivy
Start from Command Line¶
We are shipping some examples ready-to-run. However, theses examples are packaged inside the package. That’s mean, you must known first where easy_install have installed your current kivy package, and go to the example directory:
$ python -c "import pkg_resources; print pkg_resources.resource_filename('kivy', '../share/kivy-examples')"
And you should have a path similar to:
/usr/local/lib/python2.6/dist-packages/Kivy-1.0.4_beta-py2.6-linux-x86_64.egg/share/kivy-examples/
Then you can go to the example directory, and run it:
# launch touchtracer
$ cd <path to kivy-examples>
$ cd demo/touchtracer
$ python main.py
# launch pictures
$ cd <path to kivy-examples>
$ cd demo/pictures
$ python main.py
If you don’t know about Unix and symbolic link, you can create a link directly in your home directory, for an easier access. For example:
Get the example path from the command line above
Paste in your console:
$ ln -s <path to kivy-examples> ~/
Then, you can access to kivy-examples directly in your Home directory:
$ cd ~/kivy-examples