Table Of Contents
Installation on Windows¶
For Windows, we provide what we call a ‘portable package’. You don’t have to install anything “system” wide. Just unzip & run:
Download the latest version from http://kivy.org/#download
Unzip the package
In the folder where you unzipped the package, you have a script called kivy.bat. Use this file for launching any kivy application as described below
Start a Kivy Application¶
Send-to method¶
You can launch a .py file with our Python using the Send-to menu:
Copy the kivy.bat file to the Clipboard
Open Windows explorer (File explorer in Windows 8), and to go the address ‘shell:sendto’
You should get the special Windows directory SendTo
Paste the previously copied kivy.bat file as a shortcut
Rename it to Kivy <kivy-version>
You can now execute your application by right clicking on the .py file -> “Send To” -> “Kivy <version>”.
Double-click method¶
There are some simple steps that you need to complete in order to be able to launch Kivy applications by just double-clicking them:
- Right click on the main Python file (.py file extention) of the application you want to launch
- From the context menu that appears, select Open With
- Browse your hard disk drive and find the file kivy.bat from the portable package. Select it.
- Select “Always open the file with...” if you don’t want to repeat this procedure every time you double click a .py file.
- You are done. Open the file.
The next time you double click a .py file, it will be executed with the version of Python that Kivy ships with.
Note
On Windows we have to ship our own version of Python since it’s not installed by default on Windows (unlike Mac OS X and Linux). By following the steps above, you will set Kivy’s version of Python as the default for opening .py files for your user. Normally this should not be harmful as it’s just a normal version of Python with the necessary third party libraries added to the module search path. If you do encounter unexpected problems, please Contact Us.
Start from the Command-line¶
If you just want to use or develop with the latest stable Kivy version, this can be achieved using the console. You will need a minimalist GNU system installed. We recommend msysGit.
When you install msysGit, you must select these options:
- Don’t replace windows shell
- Checkout as-is, commit as-is (no CLRF replacement!)
You’ll have an icon “Git bash” on your desktop. This is the console we want:
- Start “Git bash”
- cd <directory of portable kivy>
- source kivyenv.sh <full directory path of portable kivy> # (don’t use .)
You are now ready to launch Python/Kivy from the command-line! Just do:
python <filename.py>
Also, all other scripts and binaries are available, such as:
- cython
- gcc / make...
- easy_install
- gst-inspect-0.10
Use development Kivy¶
Warning
Using the latest development version can be risky and you might encounter issues during development. If you encounter any bugs, please report them.
If you want to use the latest development version of Kivy, you can follow these steps:
Download and install Kivy for Windows as explained above
Go into the portable Kivy directory. This contains the kivy.bat file and the Python, kivy, Mingw folders etc.
Rename the kivy directory to kivy.stable
Go to github, and download the latest development version of Kivy
Extract the zip into the Kivy portable directory
Rename the directory named “kivy-<some hash>” to just “kivy”
Launch kivy.bat
Go to the Kivy portable directory/kivy
Type:
make force
That’s all, you have a latest development version!
Package Contents¶
The latest Windows package contains:
- Latest stable kivy version
- Python 2.7.1
- Glew 1.5.7
- Pygame 1.9.2
- Cython 0.14
- MinGW
- GStreamer
- Setuptools