• Public
  • Public/Protected
  • All


A Typescript client for the Ultimaker API

The client has been developed as part of a research programme investigating agent-based manufacturing systems. It currently requires one to disable the authentication on the Ultimaker as well as add CORS if one wishes to use the client within a webapp. Therefore, we strongly recommend using this on a closed local network to avoid people being able to access and send jobs to your printer!

We are looking at implementing digest authentication in the future but primary objective for now is to provide the functionality required for our agent-based manufacturing research program.

It is also an unofficial open-source client for connecting to your Ultimaker. It is isomorphic and able to both in Node.js and the Browser.


Configuring the Ultimaker

To make use of this client, you will need to disable authentication and enable cors on the Ultimaker API.

To start, you will need to enable developer mode on your Ultimaker, which can be achieved through the settings menu on the printer. The screen will display that you're in developer mode and provide the local IP address of the printer.

Ultimaker in Developer Mode

Now you need to ssh into your printer from your machine. The default user and password are root and ultimaker. After successfully connecting to the printer, you should see your terminal look a bit like this:

SSH Ultimaker Terminal

You will want to modify /usr/share/griffin/griffin/interface/http/server.py with the following content. I would recommend copying the file using scp:

scp root@[ULTIMAKER_IP_ADDRESS]:/usr/share/griffin/griffin/interface/http/server.py ./server.py

Make a backup and then edit server.py using your favourite code editor with the following:

# [...find this bit in the file]

def __init__(self, import_name, **kwargs):
if Server._instance is not None:
raise ValueError("Duplicate singleton creation")

# If the constructor is called and there is no instance, set the instance to self.
# This is done because we can't make constructor private
Server._instance = self

# Create the authentication container, this keeps track of sessions and authenticated users.
self._authentication = AuthenticationController()

# [!! add the line below to disable authentication !!]

# [file continues...]

Scroll down in the file and add this line to the end of the __init__ function.

# [...find this bit in the file]
# Disable the default werkzeug logger, this logs all http requests, which spams the logs
logging.getLogger('werkzeug').disabled = True

# [!! add the line below to add CORS support !!]
# [file continues...]

And at the end of the class, add the allow_cors function.

# [...at the bottom of the class add this method to provide open access via CORS]
def allow_cors(response):
response.headers.add('Access-Control-Allow-Origin', '*')
response.headers.add('Access-Control-Allow-Headers', 'Content-Type,Authorization')
response.headers.add('Access-Control-Allow-Methods', 'GET,PUT,POST,DELETE,OPTIONS')
response.headers.add('Access-Control-Allow-Credentials', 'true')
return response

Make sure you make a copy of the original file just in case.

With the edits made, scp the file back to the printer.

scp ./server.py root@[ULTIMAKER_IP_ADDRESS]:/usr/share/griffin/griffin/interface/http/server.py

You can restart the Ultimaker API using systemctl restart griffin.interface.http or simply restarting the machine.

Using ultimaker-client

To install the package, use the following code. I will look to putting up on npm soon.

yarn add @jamesgopsill/ultimaker-client

You can then use in your code via by importing

import { UltimakerClient, ResponseError } from "@jamesgopsill/ultimaker-client"

// Create a new client.
const client = new UltimakerClient("")

// Retrieve the name of your printer.
try {
const name = await client.getSystemName()
} catch (err) { // Promise reject will return the response that resulted in the error.
if (err instanceof ResponseError) {


The docs have been produced using TypeDoc and can be accessed here.


Testing uses jest. We use a range of Ultimakers in the lab and are currently testing with printers using version 6.40 Ultimaker firmware.

To test the functionality, make sure you have an Ultimaker on the network and create a test.config.ts file in the test directory (This is ignore by git via .gitignore). Then add the following export to make sure the tests know the ip address of the printer.

export const ip = "123.456.789.101"


We would love to have additional contributors to the project to help us maintain and add functionality to the project.

Support the Project

The project has been supported by the EPSRC-funded Brokering Additive Manufacturing project (EP/V05113X/1). More details on the project can be found at the Design Manufacturing Futures Lab website.

You can also support the developers directly by sponsoring them.


Generated using TypeDoc