Blender addon to create QR code meshes directly
Switch branches/tags
Nothing to show
Clone or download


QR Code Generator for Blender

Blender addon for generating QR code meshes, with no need for an external program or web service.

By Jacob Welsh

License: MIT/X11

Minimum required Blender version: 2.65

Home page:

Blender Addons Catalog page:

General information on addons:


The addon is implemented in pure Python and consists of a single file plus dependencies. So the only build step is the optional creation of a zip file that bundles everything for easy installation into Blender.

The primary dependency is the python-qrcode library. Version 4.0.4 or newer is strongly recommended for correctness; 5.0.1 is recommended for speed. It is linked in deps/python-qrcode as a git submodule. This library requires six; since that's a single file and doesn't use git, it's reproduced in full in deps/ Note that python-qrcode also normally requires pillow, but that's not needed here as the addon doesn't use that part of the code.

Once the dependencies are in place in deps, update the version comments in if necessary, then run ./ which will produce


From the bundled zip file

In Blender, select File > User Preferences, Addons tab, Install from File button. Navigate to and install it. It should now be listed as "Add Mesh: Local QR Code" under the "Add Mesh" category. Click the checkbox on the right to enable it, and "Save User Settings" if you want it enabled every time you run Blender.

Using shared libraries

If your Blender is using a system-wide Python installation (e.g. from a Linux distribution), you can install the dependencies in a standard Python 3 location, then install only in your Blender addons directory as above.


Add a new code through Add > Mesh > QR Code. It will be created in the XY plane, oriented for scanning from the top. Once added, you can control the following from the operator properties box in the tool shelf (the mesh will update immediately):

  • Data: the text to encode; more compact encodings such as number or alphanumeric will be detected automatically
  • Invert: whether to create blocks for the background or foreground
  • Fixed size: whether to scale the code to a fixed size of 2x2, or build it from 1x1 blocks
  • Join blocks: whether to join vertices of adjacent blocks together; you might not want this for stylizations like adding space between each block
  • Border size, in blocks
  • Error correction: higher levels are more resistant to damage, but may be more difficult to scan due to the greater amount of data

Be sure to use a dark-colored foreground on a light background for your final product to be able to scan the code.


Email me:

Report a bug:

If you find this addon helpful, please consider donating bitcoin: 1EAr1XZzd9a1RqSMtKDGDZs214ptT9WHtK

Thanks for downloading, and have a lot of fun!