Numpy-based Version of the Object Auto Rotate Module for 3D Printing.
Latest commit b1b3d17 Jan 25, 2017 @ChristophSchranz committed on GitHub watching result example
Failed to load latest commit information.
AutoRotate PlugIn
LICENSE update 0.3.6 Jan 21, 2017 watching result example Jan 25, 2017 Update Jan 22, 2017
pyramid.3mf upload demo objects Nov 18, 2016


The Tweaker is an auto-rotate module which finds the STL or 3MF object's optimal orientation on the printing platform to improve the efficiency of 3D printing.

Author: Christoph Schranz, 12.01.2016



python -i demo_object.stl -vb

Make sure you've installed the latest version of numpy:

pip install numpy --upgrade

Extended mode:

This mode yields more reliable results, but needs more time.

python -i death_star.stl -vb -x

Designer Mode:

For many Designs, the smoothness of one side's surface is more important. Therefore, orientations closer than 45 deg to a vector can be weighted. The use of the extended mode -x is also recommeded. Here is an example on how to favour the side x,y,z=0,-1,2.5 with a factor of 3:

python -i demo_object.stl -vb -x -fs "[[0,-1,2.5],3]"

Converting a 3mf object to stl without tweaking:

python -i pyramid.3mf -c

If you want to change the default output representation to ASCII, uncomment/comment the block in as described there. (Search for "ASCII" or "binary")

Just watching the results:

python -i demo_object.stl -r

Find more options:

python -h

Not installed numpy yet?

No Problem, the previous version 2 is completely numpy-less (but slower):


Cura Plugin:

PlugIn for both Cura 15 and Cura 2.3 are supported. Infos are in the descriptions.

Want to build your own application?

This Whitepaper declares how this function works. Additionally, background infos and benchmarks are provided.