.. _installation_macosx:
Installation on MacOSX
======================
.. note::
This method has only been tested on Mac OSX 10.6 Snow Leopard 64-bit.
For versions prior to 10.6 or 10.6 32-bit, you have to install the
components yourself. We suggest using
`homebrew `_ to do that.
For Mac OS X 10.6 and later, we provide a Kivy.app with all dependencies
bundled. Download it from our `Download Page `_.
It comes as a .dmg
file that contains:
* Kivy.app
* Readme.txt
* An Examples folder
* A script to install a `kivy` command for shell usage
To install Kivy, you must:
1. Download the latest version from http://kivy.org/#download
2. Double-click to open it
3. Drag the Kivy.app into your Applications folder
4. Make sure to read the Readme.txt
Installing the dev version
--------------------------
Step 1. Follow the procedure mentioned above to install kivy stable.
step 2 Open a terminal and type the following commands into it::
cd /Applications/Kivy.app/Contents/Resources/
mv kivy kivy_stable
git clone http://github.com/kivy/kivy
cd kivy
make
That's it. You now have the latest kivy from github.
Start any Kivy Application
----------------------------
You can run any Kivy application by simply dragging the application's main file
onto the Kivy.app icon. Just try this with any python file in the examples folder.
.. _macosx-run-app:
Start from the Command Line
---------------------------
If you want to use Kivy from the command line, double-click the ``Make Symlinks`` script
after you have dragged the Kivy.app into the Applications folder. To test if it worked:
#. Open Terminal.app and enter::
$ kivy
You should get a Python prompt.
#. In there, type::
$ import kivy
If it just goes to the next line without errors, it worked.
#. Running any Kivy application from the command line is now simply a matter
of executing a command like the following::
$ kivy yourapplication.py