MAS Blender

Transmedia Workflow Tools for Blender

A growing set of useful tools for Blender that utilizes the full scope of Python 3 beyond just what ships with Blender, by [m a s].
This module conforms to the requirements of Python packaging, and can be installed in Blender, free of dependency issues & user complexity.

External libraries include:

• PySide6/shiboken6
• PyTest (dev only)
• SQLAlchemy
• Web3 (eventually...it's on the "roadmap")

This package is not yet meant for mainstream usage and delivered as-is.
Several scripts are specilized for our custom in-house pipeline(s) (may eventually be made more customizable).
If you have ideas and/or run into issues with the module, please contact me! 😎

Documentation

Documentation generated with readthedocs & Sphinx is deployed on GitHub Pages for this project automatically for every update.*
To view the latest documentation for using MAS Blender, please visit:
👉 themasmedia.github.io/mas-blender 👈

Installation

Windows

1. Install Blender:
   • Microsoft Store (recommended for users on shared machine)
     
   • MSI Installer
2. Install Python 3.x (note: your version may differ from that in the screenshots):
   • Microsoft Store (recommended for users on shared machine)
     
   • Application
3. Install mas-blender module in Blender:
   1. Launch Blender.
      
   2. Open the System Console window (Window > Toggle System Console).
      
   3. Go to the Scripting tab.
      
   4. Open and run the mas_blender_install.py script found in scripts/ directory of the MAS Blender repository.
      
   5. In the System Console window, copy the Windows path in the last line of the output.
      
4. Include User's Python installation directory to list of Blender's site-packages locations:
   • Create PYTHONPATH environment variable for the user, if it doesn't yet exist.
   • Set the value to the Windows path from the System Console window in step 3.5 above.
     
5. Close Blender and relaunch.
   • You will also be able to run import mas_blender directly to access the full MAS Blender Add-On module.
6. Install the MAS Blender Add-On and enable the custom menu:
   1. Open the Preferences window - in the main menu bar, go Edit > Preferences....
      
   2. Switch to the Add-On... section (left panel) and under the top-right drop-down menu (top panel), click the Install from Disk... button.
      
   3. Locate the mas_blender_addon.py script found in scripts/ directory of the MAS Blender repository.
      
   4. Enable the MAS Blender Add-On in the Preferences window. The MAS Blender custom menu will now be accessible via the main menu bar.
      
   
   - Note that some tools are not yet accessible via the custom menu, and will need to be run from the *Scripting* tab by the user.

Installation for Python Development

• Clone from GitHub:
  

  git clone https://github.com/themasmedia/mas-blender.git && cd mas-blender

• As a project dependency:
  

  pip install git+https://github.com/themasmedia/mas-blender.git@main#egg=mas-blender