Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Interactive Design and Fabrication of Wood Joints

This is the repository related to a paper presented at UIST 2020. It is an interface where you can model a joint geometry in a voxelized design space, and export milling paths for fabrication with a 3-axis CNC-machine.

This software is free for personal use and non-commercial research conducted within non-commercial organizations. If you want to use it for commercial purposes, please contact Kaoru Shigeta (


It is recommended to use a virtual environment, for example venv.

The following command will install the packages at once.

$ pip install -r requirements.txt

Run Program

After installing the necessary packages, run the application by the following commands.

$ cd setup
$ python


Open a joint by double-clicking anywhere or by pressing the SPACE bar. Edit the joint geometry by pushing and pulling on the faces. Change the orientation and position of the wood components by dragging them. Other properties can be edited in the control panel to the left. Editable properties are summarized in the figure below.

The system performs geometric evaluations in real time and provides graphical feedback accordingly (see a-h below).

In case of an invalid joint, the system also gives suggestions (on the right side). The suggestions consists of up to four valid joint geometries within one edit distance from the current design.

For more details, see the User Interface Wiki (coming soon).

File format *.tsu

*.tsu is a unique file format for this application. This file my_joint.tsu is provided as an example. You can save and open *.tsu files from the menu bar in the interface.


Set machine origin at the center of the top side of the joint. Insert wood bar a) vertically if the sliding/fabrication is aligned with the timber axis, and b) horizontally if it is perpendicular to the timber axis.

For more details, see the Fabrication Wiki (coming soon).


Please note that this is a research prototype and not a consumer-ready product. We cannot provide technical support and we are not responsible for any damage to your fabrication equipment.


Maria Larsson, Hironori Yoshida, Nobuyuki Umetani, and Takeo Igarashi. 2020. Tsugite: Interactive Design and Fabrication of Wood Joints. In Proceedings of the 32nd Annual ACM Symposium on User Interface Software and Technology (UIST '20). Association for Computing Machinery, Virtual Event, USA.

ACM link:

Project page:

Paper PDF:


This is the repository of a Tsugite. It is a research prototype of an interactive software that supports the design and fabrication of wood joints.








No releases published


No packages published