How to use a python script?

This page describes how to use python scripts in Blender 2.6. For information on how to use python scripts in Blender 2.4 visit this page.


Most pythons scripts for Blender 2.6 are written as Add-Ons. This makes them very easy to use. Nearly all necessary steps can be done in the Add-Ons panel inside Blender (see image below). This panel is located in the User Preferences window, which can be accessed via the file menu, pressing Ctrl+Alt+U or changing a visible window's type.

Step by step explanation

  1. Download the script to a convenient location at your computer.
  2. Start Blender and go to the Add-Ons panel.
  3. Install the Add-On by pressing the install button (number 1 in the image above)
  4. Enable the Add-On by pressing the toggle button (number 2 in the image above)

In more detail

If the list of Add-Ons is very long it can be a bit difficult to find the Add-On you just installed. You can easily filter the long by pressing one of the categories in the left-hand column of the panel, or by searching for the name of the Add-On. You can also search by author-name (Crouch, in my case).

To get more information on an available Add-On press the triangular button at the left of the entry. More information will be displayed like for example a description and version number. Perhaps the most useful information is location, which tells you where you can find the results of the script (where you can use it).  For most scripts you'll also find a link to a wiki-page with more information and a possibility to report bugs.

If you're very happy with a certain Add-On and would want it to be enabled every time you start Blender, you have to save it to the default .blend file. Simply press the button (number 3 in the image above) and you're done. Note that this saves the current state of Blender to the default .blend file, including any meshes etc. you might have in your scene.

Further information on Add-Ons can be found at the Blender wiki.