Frequently Asked Questions

Why is the URL not http://boxes.py

Boxes.py started its life as a simple command line script named - surprise - boxes.py. The web interface only came much later. Turns out the .py TLD belongs to Paraguay. Getting a domain right there is really hard even for a Paraguayan citizen unless you move down to .com.py and impossible for a foreigner. So the current URL must do.

Why is Boxes.py so complicated?

For one Boxes.py offers more options than any other box generator I know. These options need to be made available somehow.

But the actual reason is a question of philosophy. Boxes.py made the decision to not use fixed values for most things but just make them available in the UI. But it uses sane default values. So you don’t need to touch most settings. As a beginner you can safely keep the edge settings closed. Just put in the general measurements, material thickness and your burn (aka kerf) value.

Can I sell boxes I created with Boxes.py

Yes. Boxes.py is under the GPLv3 license (see https://www.gnu.org/licenses/gpl-3.0.html). This license grants you far reaching rights on what you can do with the software including using it and the drawings it produces to any means. The license also puts some obligations on you. But those are about changing and distributing the software itself. The resulting drawings do not fall under the GPL license.

Can I sell files generated by Boxes.py

Yes, but… The license does allow for that. But selling the plain files that people can get for free is a scam in my eyes and may or may not be fraud. It is a different story completely if you modify the drawing - e.g. add decoration - and tell your customers that the drawing is based on Boxes.py. This way the can see what part of the work they are actually paying for.

Why do my parts not fit together?

Well, this could be a bug in Boxes.py but there are a few more likely causes to check for:

  • The material you use does not have the thickness you think. Measure it with at least a caliper. Even a few hundredth of a millimeter will make the difference between a loose fit, a light or a heavy pressfit or no fit at all.

  • You might have chosen the “burn” value too big. As it compensates for the material cut away by the laser smaller values make a looser fit, bigger values make a tighter fit. The right value may be different for different materials and different thicknesses.

Why is my box a bit too big?

By default all sizes are inner sizes. So on the outside the box is bigger as the walls need to go somewhere. Some generators offer an “outside” param that includes the walls in the measurements. In general you should check the generated parts for plausibility before hitting the start button on your laser cutter.

Why is my box a bit too small?

See above.

Why are my parts in the totally wrong size?

Unfortunately some formats do not save the units of measurement or don’t do so properly. DXF and SVG fall into this category. So different tools may see the same file in different sizes. You can use the “reference” param to get a rectangle of a defined size to check if the size is still right at the end of your tool chain.

Why are there tiny, weird loops in the corners?

These are called dog bones and make sure the corner is completely cut out. As lasers and milling tools are round they can’t cut sharp inner corners. Have a look at burn correction details for details.

I really don’t want those weird, tiny loops?

You can set the inner_corners default setting to corner

What settings were used to generate a drawing?

If you do have a SVG, PostScript or LightBurn file you can look into the meta data of the file. Most document viewers will have a Document properties window. For Light Burn look into the document notes. You can also just open the file with a text editor and find the details at the first few lines or by searching for URL.

Note that you can just use the URL in there to get back to the settings page to change some values. The difference between the settings and the rendered drawing is just render=0 or render=1 at the end of the URL.

For other formats you are currently out of luck. But you can save the URL you downloaded the file from. It contains all settings.