Many Blender Python scripts are prepared in a special way, which allows them to appear in the Blender Scripts menu, automatically. Usually such scripts are prepared for the wider audience. A good practice is to maintain an additional directory for your scripts, and point it to Blender. To enable this functionality, you need:

  1. prepare the directory for Blender scripts, you want to appear in the menu (not every script can do that);
  2. place the scripts there;
  3. set this directory as the “user script directory” in the Blender settings;

I strongly suggest to create such subdirectory. Scripts, located there, are independent of Blender upgrades, which is very useful, on the long term.


Prepare directory for Blender scripts

It can be located anywhere on your computer. Inside this directory you should create a subdirectory named bpydata. Inside bpydata – another subdirectory, named config. These two directories are required to enable scripts to preserve their local data (if any of them need to do it).

When the directory is crated, place the scripts, you want to use, there. The content of the script directory can look like this on the Fig. 2.

Change the Blender settings

Open the User Preferences window, and press the toggle File Paths (as on Fig. 1):
Fig. 1. Field for the user's Python scripts directory in the Blender settings.

On the screen, that will appear, there is the field for the Python directory name (second column, at the bottom). Type it there, or use the small “folder” button on the right, to point Blender the directory, you have prepared (like on Fig. 2):

Fig. 2. A user's Python scripts directory

In effect, the name of this folder is placed in the Blender settings as the path to the scripts (Fig. 3):

Fig. 3. The user's Python scripts directory set in Blender's settings

When the Python directory is set, save this setting, using from File=>Save Default Settings command ([Ctrl]-[U]). It will change it in all Blender files (also the existing ones).

Blender searches this directory for script files eligible to be placed in the menu. This search is performed on the start of the program. To force it while Blender is already running, press the second small button, located on the left side of Python directory “folder” button (Fig. 3). This update the Blender’s Scripts menus. You can do it also issuing command Scripts=>Update menus from the Scripts window.

When it finds something eligible, it is immediately visible in the Scripts menu (Fig. 4):

Fig. 4. Script from user's directory, placed in the menu.

This “Handle Panel.py” was just one of the scripts, placed in our Python directory. Now it is available in the Blender menus. You will also find some of these script commands in the 3D View under Object=>Scripts.