AutoKey3D (formerly known as PhotoBump) is a software to create 3D models for key blanks, bumpkeys and regular keys.
This is an updated fork with the addition of metric measures. For that, some things should be updated on files before the key generation.
- You should have the distance between the shoulder and the first PIN for the aspace variable on the metric.scad file
- You shoud have the key length for the kl variable on the metric.scad file
- You should have the space between each pin for the variable pinspace on the metric.scad file
- You should have the height of each PIN from the key base
- You can now generate the key by using the command like this
python3 AutoKey.py --key 6.7,6.3,7.8,6.6,6.7 --profile profiles/metric.svg --definition definitions/metric.scad - You should to update the metric.scg file by te profile that you ant to use.
Note: The original author of the tool created a web site with that tool but the metric is not still implemented. A pull request is open to add that feature to avoid having all the dependencies installed on a computer (https://autokey.own-hero.net)
Please note that AutoKey3D is released under a non-commercial license (CC BY-NC-SA 4.0).
See the LICENSE file for the exact license text.
Written by Christian Holler (:decoder). For questions, send an email to:
decoder -at- own-hero -dot- net
The software was first presented and demonstrated at LockCon 2014, Sneek, NL.
The recorded talk is available here: https://www.youtube.com/watch?v=3pSa0pslxpU
- OpenSCAD (a version > 2014.03 taken from GIT or daily snapshots is recommended)
- pstoedit
- Inkscape
- Python >= 2.7
In order to create the 3D model for the bump key that was used in my video, you can run the following command:
python AutoKey.py --bumpkey --profile profiles/AB-AB95.svg --definition definitions/AB-E20.scad
Once OpenSCAD has started, you can Preview/Render/Export the STL as desired.
Instead of using the --bumpkey parameter, you can also specify --blank for
creating a blank instead, or use --key 1,2,3,4,5,6 to create a key with
the specified combination.
In the profiles/ subdirectory, you can find SVG traces created from photos for certain locks. You can add your own SVG data there if you wish to create a model for a profile not supported yet by the software. In addition to the SVG, there is always a profile definition file (.scad) that contains dimensional information about the profile (see profiles/README for more information).
The definitions/ subdirectory contains system definitions for certain locks. Such a definition typically contains information such as the key length, the pin/shoulder distances, key cut heights and angles. For bump keys, it is possible to deviate from the regular system definitions for better results.
Also see definitions/README for a more detailed documentation.
Using "Preview" in OpenSCAD will most likely give you a glitched model. To check the model, use "Render" (which takes longer, but should produce a glitch-free view). For faster rendering, you can lower the $fn value in key.scad to 50 or 10, but make sure to set it back to 100 before doing final model rendering. Otherwise accuracy of the rendered model might be insufficient.