https://github.com/mechanicalflower/bpy_wrapper

Blender API wrapper for easy scripting
https://github.com/mechanicalflower/bpy_wrapper

blender blender-addon blender-python blender3d

Last synced: about 1 month ago
JSON representation

Blender API wrapper for easy scripting

• Host: GitHub
• URL: https://github.com/mechanicalflower/bpy_wrapper
• Owner: MechanicalFlower
• License: gpl-3.0
• Created: 2023-08-21T18:35:27.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-03-17T19:27:01.000Z (about 1 month ago)
• Last Synced: 2025-03-17T20:32:53.553Z (about 1 month ago)
• Topics: blender, blender-addon, blender-python, blender3d
• Language: Python
• Homepage:
• Size: 408 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        


# `bpy_wrapper`

![Blender Version](https://img.shields.io/badge/blender-3.6-fb7d01?logo=blender&logoColor=white)

![Python Version](https://img.shields.io/badge/python-3.10-0a7bbc?logo=python&logoColor=white)

![license](https://img.shields.io/badge/license-GPL_v3.0-green?logo=open-source-initiative&logoColor=white)

Blender API wrapper for easy scripting



## Usage

### Use as package

Some examples are present in the repository, to try it, run :

```shell

python examples/.py

```

### Use as addon

To install the addon, run :

```shell

git clone https://github.com/MechanicalFlower/bpy_wrapper.git

cd bpy_wrapper

pip install poetry

poetry install --only=build

poetry run bpy-addon-build

```

And you can now run :

```shell

blender .blend --python examples/.py

```

## Examples

### Turntable

Use this to create 360 pictures of your model.

Supported extensions: `.3ds`, `.fbx`, `.ply`, `.obj`, `.stl`, `.glb`.

```shell

turntable --model ./t_pose.glb --output render/t_pose/ --test-mode

```

```shell

blender empty.blend --python examples/turntable.py -- --model ./t_pose.glb --output render/t_pose/ --test-mode

```

Output folder will be created if it does not exist.

## References

- [Turntable script](https://github.com/innosoft-pro/blender-turntable) by [innosoft-pro](https://github.com/innosoft-pro)

- [PSX pipeline](https://github.com/DreliasJackCarter/PSXifyBlender2.8) by [DreliasJackCarter](https://github.com/DreliasJackCarter)

- [Blender API wrapper](https://github.com/keunhong/brender) by [keunhong](https://github.com/keunhong)