b-rad-c / bl-app-grapher

Blender App Template Sample - App Grapher

A sample Blender App Template that graphs math functions.

Tested on Blender 3.6 with Python 3.10

known issues

1. The app crashes when using METAL GPU w Apple silicon when using any of the UI buttons. To use with apple silicon, open Blender normally (without the app template) and switch from METAL to OpenGL, then quit and launch the app template.
2. The distributed .zip file does not work due to dependencies not being copied into zip file.

Use template

You can use the app without downloading this repo and setting up a development environment.

Download zip file in ./dist folder and install and run like a normal blender app template

Dev usage

To setup a local dev environment and run from source:

git clone https://github.com/b-rad-c/bl-app-grapher.git
cd bl-app-grapher
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt -r requirements-dev.txt

An included shell script helps with setting up and running the code.

Note that you may need to update variables in this script because this example app is setup for OSX with Blender3.6 and a python3.10 local venv

# this links the code to your blender install's app template folder
./dev.sh link

# run the app template
./dev.sh start

You will need to quit and re-run the start command to load code changes.

To unlink the code from your blender install:

./dev.sh unlink

To package into a zip for distributing:

./dev.sh package