# Blender: Running Python Scripts

## Summary

**Published**: Feb 08 2024 by [mana vortex](https://app.gitbook.com/u/NfZBoxGegfUqB33J9HXuCs6PVaC3 "mention")\
**Last documented edit**: Feb 08 2024 by [mana vortex](https://app.gitbook.com/u/NfZBoxGegfUqB33J9HXuCs6PVaC3 "mention")

This page will show you how to run Python scripts in Blender. It's not strictly speaking part of the Blender plugin, but I had to put this somewhere, and it's least out of place here.

## The Scripting perspective

To run scripts, you need to switch to the scripting perspective. Click the corresponding entry on the perspective toolbar at the very top:

<figure><img src="https://1427525421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4gzcGtLrr90pVjAWVdTc%2Fuploads%2Fgit-blob-78cdc6c03847423dca0aa8ba5bfa04c03c06c134%2Fblender_scripting_perspective.png?alt=media" alt=""><figcaption></figcaption></figure>

The script panel looks like this:

<figure><img src="https://1427525421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4gzcGtLrr90pVjAWVdTc%2Fuploads%2Fgit-blob-510c2ced655c8eb495a2ee798111f4394bd2acbc%2Fblender_script_panel_overview.png?alt=media" alt=""><figcaption></figcaption></figure>

## Running a script

1. Click on the "New Text" button to create a new document: ![](https://1427525421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4gzcGtLrr90pVjAWVdTc%2Fuploads%2Fgit-blob-767e182af3d24d736f387208f3ca81345aaf1bf0%2Fblender_new_button?alt=media)
2. Click into the `Text Editor` panel directly below it
3. **Paste** the contents of whatever script you want to run (Hotkey: `Ctrl+V`)
4. Hit the Play button above the editor panel to run the script (Hotkey: `Alt+P`)
5. **Optional:** Look at the Python Console below the 3d viewport to see feedback

## Troubleshooting

If your script doesn't work, Blender will have generated an [**exception**](#user-content-fn-1)[^1]. To look at it, toggle Blender's System Console:

<figure><img src="https://1427525421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4gzcGtLrr90pVjAWVdTc%2Fuploads%2Fgit-blob-a12fea454dd23e7bea134e8c9acee1590533c169%2Fblender_show_system_console.png?alt=media" alt=""><figcaption></figcaption></figure>

Copy the contents of the console window, or pull it as big as your screen allows and take a screenshot. Give this information to the Netrunner who told you to run the script and watch as they fix it.

If you don't have a Netrunner (or if you *are* that person), this is where you hit up Google or [ChatGPT](https://rollbar.com/blog/how-to-debug-code-using-chatgpt/) (you can skip the steps 1-5 in the linked guide).

{% hint style="danger" %}
While you have text selected in the Blender System console, your Blender will be completely unresponsive.
{% endhint %}

[^1]: The technical term for "thing go brr". Give it to a Netrunner and he can use it to fix things.