Skip to content

Renders Keyboard Layout Editor JSON by manipulating photos of keys

License

Notifications You must be signed in to change notification settings

NeuralSpaz/kle_render

 
 

Repository files navigation

KLE-Render

Get prettier images of Keyboard Layout Editor designs

This project uses Pillow (Python Image Library), Flask, and Flask-RESTPlus to serve up 'renders' of keyboards from their keyboard layout editor JSON, by stretching, tinting, and tiling base images of a 1u keycap.

Check it out at kle-render.herokuapp.com.

You can also see a sample render of Nantucket Selectric here.

Frequently Asked Questions

I've also answered many common questions on the reddit post. If you have a simple question not answered here, try messaging me on reddit.

What keycap profiles are supported?

KLE-Render technically only supports SA and GMK keycap profiles, but most layouts for DSA, DCS, OEM, or even beamspring profiles should still look pretty close. Keycap row profiles (like SA R1) are not supported - everything key is assumed to be uniform row 3.

Why am I getting an internal server error when I try to render a layout?

It's quite possible the server is overloaded, but also possible that something in your layout is causing the server to crash. If you're uploading JSON, make sure it is downloaded via the button. If as far as you can tell everything is inputted correctly, please contact me with the gist link or JSON that is causing the error and I will try to fix the problem.

Can I render from a different angle? What if I need to render with a case, or rare profiles, or translucent keycaps?

This tool can generate relatively realistic renders of arbitrary keyboard layout editor layouts, but because it works by stretching and tinting grayscale images there are many limitations on what can be shown, compared to 3D renders. If you're looking for photorealistic visualizations on a limited number of keyboards kbrenders.com can be a useful resource. For certain custom work, however you may still have to do post-processing in photoshop, or commission a professional like thesiscamper to create real 3D renders of your set design.

I've made a great looking set design that I think could be a popular group buy. How do I turn it into a reality?

If you're looking for help with creating a keycap set for a group buy livingspeedbump has a nice guide on keychatter.

Templates

The following templates have their legend sizes and keycap profiles pre-configured for accurate rendering using kle-render. Use them as a starting point for your own designs!

Sample Image

Sample Render

About

Renders Keyboard Layout Editor JSON by manipulating photos of keys

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 83.4%
  • HTML 16.6%