Skip to content
A performant auto-rotate module for objects in 3D Printing.
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
AutoRotate PlugIn plugIn bugfix Dec 8, 2016
__pycache__ binary STL output Jan 16, 2017
3DBenchy2.stl updated to V3.8 Oct 1, 2017 Merge remote-tracking branch 'origin/master' Mar 15, 2019
LICENSE Initial commit Nov 18, 2016 Merge remote-tracking branch 'origin/master' Mar 15, 2019 improved description May 18, 2019 Removed redundant or unused imports and added exception handling. Ref… Oct 2, 2018 make api plain Mar 16, 2019
all.stl updated to V3.8 Oct 1, 2017
death_star.stl prefilter mesh, changed plugin md Nov 21, 2016
demo_object.stl upload demo objects Nov 18, 2016
mobius_strip.stl updated to V3.7 Sep 25, 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.

Auto-rotation of a model Author: Christoph Schranz, 12.01.2016

Salzburg Research


python -i demo_object.stl -vb

Extended mode:

This mode yields the most reliable results, but needs more computation time.

python -i death_star.stl -vb -x

Minimise the necessary support material:

If you want to optimise the print in terms of minimal support material volume, add the flag -vol. The extended mode is suggested for this operation.

python -i demo_object.stl -vol -x

Convert a 3mf object to stl without tweaking:

python -i pyramid.3mf -c

Choose the output type of the STL format:

python -i pyramid.3mf -t asciistl

You can choose the output types "asciistl" and "binarystl" (default). "3mf" is not supported yet.

Just see the results:

python -i demo_object.stl -r

Show the progress of tweaking:

python -i demo_object.stl -x -p

Designer Mode:

In some cases the smoothness of one side's surface may be more important. Therefore, orientations closer than 45 degrees to a vector can be weighted. The use of the extended mode -x is also recommeded. Here is an example of 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]"

Find Help:

python -h


python -v

Cura Plugin:

Cura 15 and Cura 2.3 are supported. Installation infos are in the PlugIn folder, or you can also download the PlugIn from Cura 2.7 PlugIn Browser.

Interested in how the algorithm works?

This Whitepaper declares this program. Additionally, background infos and benchmarks are provided.


Most of this code was developed in my spare time to provide a performant auto-rotation module to the open-source 3D printing community. If you like this project or it helps you to reduce time to develop, I would be very thankful about a cup of coffee :)

More coffee, more code

You can’t perform that action at this time.