- Installation on Linux¶
- Installation components¶
- Installing Python¶
- Ubuntu¶
- Fedora¶
- Source installation Dependencies¶
- Ubuntu¶
- Fedora¶
- Using software packages (PPA etc.)¶
- Ubuntu / Kubuntu / Xubuntu / Lubuntu (Saucy and above)¶
- Debian (Jessie or newer)¶
- Linux Mint¶
- Bodhi Linux¶
- OpenSuSE¶
- Gentoo¶
- Device permissions¶
- Installation on Linux¶
- Installation components¶
- Installing Python¶
- Ubuntu¶
- Fedora¶
- Source installation Dependencies¶
- Ubuntu¶
- Fedora¶
- Using software packages (PPA etc.)¶
- Ubuntu / Kubuntu / Xubuntu / Lubuntu (Saucy and above)¶
- Debian (Jessie or newer)¶
- Linux Mint¶
- Bodhi Linux¶
- OpenSuSE¶
- Gentoo¶
- Device permissions¶
Installation on Linux¶
To install Kivy on Linux using pip , please follow the main installation guide . Otherwise, continue to the PPA instructions below .
Installation components¶
Following, are additional information linked to from some of the steps in the main pip installation guide , specific to Linux.
Installing Python¶
Python and python-pip must be installed from the package manager:
Ubuntu¶
sudo apt-get install -y \ python3-pip \ build-essential \ git \ python3 \ python3-dev \
Fedora¶
You will likely need to do this preliminary step which installs the rpmfusion-free repository unless you have some other 3rd-party repo installed which has the required packages. See rpmfusion.org for complete installation instructions, but only the rpmfusion-free repo is needed for acquiring kivy dependencies (though rpmfusion-nonfree is recommended by rpm fusion installation instructions) as shown in this step.
sudo dnf install -y https://download1.rpmfusion.org/free/fedora/rpmfusion-free-release-$(rpm -E %fedora).noarch.rpm
After you ensure that a 3rd-party repository containing any packages that dnf is otherwise unable to find, continue installing dependencies:
sudo dnf install -y python3-devel
Source installation Dependencies¶
To install Kivy from source, please follow the installation guide until you reach the Kivy install step and then install the dependencies below before continuing. Additionally, if you’d like to be able to use the x11 window backend do:
Ubuntu¶
# Install necessary system packages sudo apt-get install -y \ libsdl2-dev \ libsdl2-image-dev \ libsdl2-mixer-dev \ libsdl2-ttf-dev \ libportmidi-dev \ libswscale-dev \ libavformat-dev \ libavcodec-dev \ zlib1g-dev # Install gstreamer for audio, video (optional) sudo apt-get install -y \ libgstreamer1.0 \ gstreamer1.0-plugins-base \ gstreamer1.0-plugins-good
Fedora¶
# Install necessary system packages sudo dnf install -y ffmpeg-libs SDL2-devel SDL2_image-devel SDL2_mixer-devel \ SDL2_ttf-devel portmidi-devel libavdevice libavc1394-devel zlibrary-devel ccache \ mesa-libGL mesa-libGL-devel # Install xclip in case you run a kivy app using your computer, and the app requires a CutBuffer provider: sudo dnf install -y xclip # # In case you get the following error preventing kivy install: # annobin: _event.c: Error: plugin built for compiler version (8.0.1) but run with compiler version (8.1.1) # cc1: error: fail to initialize plugin /usr/lib/gcc/86_64-redhat-linux/8/plugin/annobin.so # This has been resolved in later updates after the on-disk release of Fedora 28, so upgrade your packages: # sudo dnf -y upgrade
Using software packages (PPA etc.)¶
Ubuntu / Kubuntu / Xubuntu / Lubuntu (Saucy and above)¶
stable builds $ sudo add-apt-repository ppa:kivy-team/kivy nightly builds $ sudo add-apt-repository ppa:kivy-team/kivy-daily
Python3 — python3-kivy $ sudo apt-get install python3-kivy optionally the gallery of Examples — kivy-examples $ sudo apt-get install kivy-examples
Debian (Jessie or newer)¶
stable builds deb http://ppa.launchpad.net/kivy-team/kivy/ubuntu xenial main daily builds deb http://ppa.launchpad.net/kivy-team/kivy-daily/ubuntu xenial main Notice: Wheezy is not supported — You’ll need to upgrade to Jessie at least!
as user: sudo apt-key adv —keyserver keyserver.ubuntu.com —recv-keys A863D2D6 as root: apt-key adv —keyserver keyserver.ubuntu.com —recv-keys A863D2D6
Linux Mint¶
- Find out on which Ubuntu release your installation is based on, using this overview.
- Continue as described for Ubuntu above, depending on which version your installation is based on.
Bodhi Linux¶
- Find out which version of the distribution you are running and use the table below to find out on which Ubuntu LTS it is based.
Bodhi 1 Ubuntu 10.04 LTS aka Lucid (No packages, just manual install) Bodhi 2 Ubuntu 12.04 LTS aka Precise Bodhi 3 Ubuntu 14.04 LTS aka Trusty Bodhi 4 Ubuntu 16.04 LTS aka Xenial
- Continue as described for Ubuntu above, depending on which version your installation is based on.
OpenSuSE¶
- To install kivy go to http://software.opensuse.org/package/python-Kivy and use the “1 Click Install” for your openSuse version. You might need to make the latest kivy version appear in the list by clicking on “Show unstable packages”. We prefer to use packages by ” devel:languages:python”.
- If you would like access to the examples, please select python-Kivy-examples in the upcoming installation wizard.
Gentoo¶
- There is a kivy ebuild (kivy stable version) emerge Kivy
- available USE-flags are: cairo: Standard flag, let kivy use cairo graphical libraries. camera: Install libraries needed to support camera. doc: Standard flag, will make you build the documentation locally. examples: Standard flag, will give you kivy examples programs. garden: Install garden tool to manage user maintained widgets. gstreamer: Standard flag, kivy will be able to use audio/video streaming libraries. spell: Standard flag, provide enchant to use spelling in kivy apps.
Device permissions¶
When you app starts, Kivy uses Mtdev to scan for available multi-touch devices to use for input. Access to these devices is typically restricted to users or groups with the appropriate permissions.
If you do not have access to these devices, Kivy will log an error or warning specifying these devices, normally something like:
Permission denied:'/dev/input/eventX'
In order to use these devices, you can add your user to a group that has the required permissions. For example, in Ubuntu, you can add the user to the ‘input’ group:
Note that you need to log out then back in again for these permissions to be applied.
Installation on Linux¶
To install Kivy on Linux using pip , please follow the main installation guide . Otherwise, continue to the PPA instructions below .
Installation components¶
Following, are additional information linked to from some of the steps in the main pip installation guide , specific to Linux.
Installing Python¶
Python and pip are already installed on most Linux distributions. If you don’t have Python installed, you can install it using your distribution’s package manager.
Ubuntu¶
sudo apt-get update sudo apt-get install -y \ python3-pip \ python3
Fedora¶
You will likely need to do this preliminary step which installs the rpmfusion-free repository unless you have some other 3rd-party repo installed which has the required packages. See rpmfusion.org for complete installation instructions, but only the rpmfusion-free repo is needed for acquiring kivy dependencies (though rpmfusion-nonfree is recommended by rpm fusion installation instructions) as shown in this step.
sudo dnf install -y https://download1.rpmfusion.org/free/fedora/rpmfusion-free-release-$(rpm -E %fedora).noarch.rpm
After you ensure that a 3rd-party repository containing any packages that dnf is otherwise unable to find, continue installing dependencies:
sudo dnf install -y python3-devel
Source installation Dependencies¶
To install Kivy from source, please follow the installation guide until you reach the Kivy install step and then install the dependencies below before continuing. Additionally, if you’d like to be able to use the x11 window backend do:
Ubuntu¶
sudo apt-get update # Install build tools, and dependencies to perform a full build (including SDL2 dependencies) sudo apt-get -y install python3-dev build-essential git make autoconf automake libtool \ pkg-config cmake ninja-build libasound2-dev libpulse-dev libaudio-dev \ libjack-dev libsndio-dev libsamplerate0-dev libx11-dev libxext-dev \ libxrandr-dev libxcursor-dev libxfixes-dev libxi-dev libxss-dev libwayland-dev \ libxkbcommon-dev libdrm-dev libgbm-dev libgl1-mesa-dev libgles2-mesa-dev \ libegl1-mesa-dev libdbus-1-dev libibus-1.0-dev libudev-dev fcitx-libs-dev
Fedora¶
sudo dnf install epel-release # Install build tools, and dependencies to perform a full build (including SDL2 dependencies) yum -y install autoconf automake cmake gcc gcc-c++ git make pkgconfig \ ninja-build alsa-lib-devel pulseaudio-libs-devel \ libX11-devel libXext-devel libXrandr-devel libXcursor-devel libXfixes-devel \ libXi-devel libXScrnSaver-devel dbus-devel ibus-devel fcitx-devel \ systemd-devel mesa-libGL-devel libxkbcommon-devel mesa-libGLES-devel \ mesa-libEGL-devel wayland-devel wayland-protocols-devel \ libdrm-devel mesa-libgbm-devel libsamplerate-devel # Install xclip in case you run a kivy app using your computer, and the app requires a CutBuffer provider: sudo dnf install -y xclip # # In case you get the following error preventing kivy install: # annobin: _event.c: Error: plugin built for compiler version (8.0.1) but run with compiler version (8.1.1) # cc1: error: fail to initialize plugin /usr/lib/gcc/86_64-redhat-linux/8/plugin/annobin.so # This has been resolved in later updates after the on-disk release of Fedora 28, so upgrade your packages: # sudo dnf -y upgrade
Using software packages (PPA etc.)¶
Ubuntu / Kubuntu / Xubuntu / Lubuntu (Saucy and above)¶
stable builds : $ sudo add-apt-repository ppa:kivy-team/kivy nightly builds : $ sudo add-apt-repository ppa:kivy-team/kivy-daily
Python3 — python3-kivy : $ sudo apt-get install python3-kivy optionally the gallery of Examples — kivy-examples : $ sudo apt-get install kivy-examples
Debian (Jessie or newer)¶
stable builds : deb http://ppa.launchpad.net/kivy-team/kivy/ubuntu xenial main daily builds : deb http://ppa.launchpad.net/kivy-team/kivy-daily/ubuntu xenial main Notice: Wheezy is not supported — You’ll need to upgrade to Jessie at least!
as user: sudo apt-key adv —keyserver keyserver.ubuntu.com —recv-keys A863D2D6 as root: apt-key adv —keyserver keyserver.ubuntu.com —recv-keys A863D2D6
Linux Mint¶
- Find out on which Ubuntu release your installation is based on, using this overview.
- Continue as described for Ubuntu above, depending on which version your installation is based on.
Bodhi Linux¶
- Find out which version of the distribution you are running and use the table below to find out on which Ubuntu LTS it is based.
Bodhi 1 : Ubuntu 10.04 LTS aka Lucid (No packages, just manual install) Bodhi 2 : Ubuntu 12.04 LTS aka Precise Bodhi 3 : Ubuntu 14.04 LTS aka Trusty Bodhi 4 : Ubuntu 16.04 LTS aka Xenial
- Continue as described for Ubuntu above, depending on which version your installation is based on.
OpenSuSE¶
- To install kivy go to http://software.opensuse.org/package/python-Kivy and use the “1 Click Install” for your openSuse version. You might need to make the latest kivy version appear in the list by clicking on “Show unstable packages”. We prefer to use packages by “ devel:languages:python”.
- If you would like access to the examples, please select python-Kivy-examples in the upcoming installation wizard.
Gentoo¶
eselect repository enable raiagent
emerge --ask --autounmask Kivy kivymd buildozer python-for-android
equery u Kivy kivymd buildozer python-for-android
Device permissions¶
When you app starts, Kivy uses Mtdev to scan for available multi-touch devices to use for input. Access to these devices is typically restricted to users or groups with the appropriate permissions.
If you do not have access to these devices, Kivy will log an error or warning specifying these devices, normally something like:
Permission denied:'/dev/input/eventX'
In order to use these devices, you can add your user to a group that has the required permissions. For example, in Ubuntu, you can add the user to the ‘input’ group:
Note that you need to log out then back in again for these permissions to be applied.
© Copyright 2010, The Kivy Authors Revision bd041aea .
Versions master latest Downloads pdf html epub On Read the Docs Project Home Builds Free document hosting provided by Read the Docs.