Python Editing for Blender (Part Two)

Welcome back! If you missed the first installment of Python Editing for Blender, it was mostly about getting set up and adding keyword completion to PyCharm.

Python Editing for Blender (Part One)

Run a Python file through Blender’s interpreter

First up, let’s get something working. Make a directory somewhere and create a file called “”.

Let’s start small. Add these lines to the file:

print("Hello, Blender.  It's awfully big in here")

Save the file, and now we can run it with Blender’s Python.

You could type this:

C:\Projects\BlenderPythonTutorial>"c:\Program Files\Blender Foundation\Blender\blender.exe" --background --python

but that looks terrible. Let’s add Blender to the system path so we don’t have to type so much. We could add it by right-clicking on “Computer”, selecting “Properties”, then “Advanced System Settings”, then finding “Environment Variables” near the bottom of that screen, and so on, but that could be dangerous and is definitely un-user-friendly.

You probably don’t need to run Blender from the command line every day (not yet, anyway), so let’s just make a batch file for updating your path in the terminal. Make another file called initialize.bat and put this in it:

set PATH=%PATH%;"C:\Program Files\Blender Foundation\Blender"

Then just run that in your terminal:


Your output will vary, but you should see the Blender directory at the end. We might put other terminal initialization stuff here later.

Check to see that you don’t have anything weird in your path, like references to malicious-sounding directories you’ve never heard of, and let’s move on.

You can add ‘@’ to the beginning of that line to keep that output from muddying up your terminal. Like so:

@set PATH=%PATH%;"C:\Program Files\Blender Foundation\Blender"

Now you can run this much nicer command-line command:

    C:\Projects\BlenderPythonTutorial>blender --background --python

And you should get output similar to this:

Read new prefs: C:\Users\jkersey\AppData\Roaming\Blender Foundation\Blender\2.68\config\userpref.blend
found bundled python: c:\Program Files\Blender Foundation\Blender\2.68\python
Hello, Blender.  It's awfully big in here

Blender quit

Please note: when you close the terminal, this addition to your path disappears.

So: Blender loads your preferences file, then parses the Python file you just made.

You are now, as they say, “in”.

But what’s in there?

Stay tuned for Python Editing for Blender (Part Three) to find out!

or, check out

BlenderSpriter which is the experiment that inspired this series.

9 Responses to “Python Editing for Blender (Part Two)”

  1. nirenyang Says:

    Hi. I’m comming again. Thanks for your sharing!
    I’ll follow your feet~

  2. James Kersey Says:

    You’re welcome, thanks for coming back! Part 3 is about half-way done, hopefully I can wrap it up this weekend.

  3. Takashi Sakamoto Says:

    When part 3 will be released? Thanx!

  4. James Kersey Says:

    Completely forgot about part 3! Let me check my notes…

  5. Lukas Treyer Says:

    Hey James, how about part 3?

  6. James Kersey Says:

    ok, ok :)

  7. Lukas Treyer Says:

    thank you! :-)

  8. Goffa Says:

    Hi, I just found this, awesome work – thanks!
    any part 3 yet?

  9. James Kersey Says:

    Thanks! I’ve been pretty busy with art projects, is there anything in particular you’d like to see in part 3?

Leave a Reply