Skip to content

A software to create 3D models for key blanks, bumpkeys and regular keys

License

Notifications You must be signed in to change notification settings

choller/autokey3d

Repository files navigation

AutoKey3D

Description

AutoKey3D (formerly known as PhotoBump) is a software to create 3D models for key blanks, bumpkeys and regular keys.

License

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.

About

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

Requirements

  • OpenSCAD (a version > 2014.03 taken from GIT or daily snapshots is recommended)
  • pstoedit
  • Inkscape
  • Python >= 2.7

Example

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.

Profiles

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 (.def) that contains dimensional information about the profile (see profiles/README for more information).

System Definitions

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.

Known Issues

Preview

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.

About

A software to create 3D models for key blanks, bumpkeys and regular keys

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published