This is the manual of Studio 1.1.0, an earlier version. The manual of the latest version

System requirements

What a computer needs to run Twinwright Studio, and what the 3D view needs from its graphics.

Windows

64-bit Windows 10 or Windows 11 (x64). The installer stops on other versions.
Nothing else to install: Studio is one program file and uses only the libraries that come with Windows.

Linux

Linux on x86-64 with glibc 2.38 or later: Ubuntu 24.04, Debian 13, Fedora 39 and newer, and the distributions built on them.
A desktop with X11 or Wayland.
For the AppImage: FUSE 2 (on Ubuntu, the package libfuse2t64). Without it, use the .tar.gz.
For online activation and trials: libcurl (on Ubuntu, the package libcurl4t64; desktops usually have it). Without it, Studio activates offline.
For the AI services' keys: the desktop's keyring (Secret Service: GNOME Keyring or KWallet). Without one, Studio keeps the keys in a file only you can read.

Graphics

The 3D view uses Direct3D 11, on any graphics card or built-in graphics that has it (feature level 10.0 or higher). Without one, Studio draws with Windows' software renderer (WARP): it works, but the view is slower (at most 30 frames a second) and there is no tool close-up.

Help > About shows which one Studio uses under Display.

When the 3D view cannot start

The rest of the window works without the 3D view. If the view stays empty or shows that it is not available:

Open Tools > Settings… > Files.
Tick Software rendering (when the graphics card has trouble; at the next start).
Close Studio and start it again.

Updating the graphics card's driver often fixes the cause.

Linux

On Linux, the 3D view uses OpenGL 4.1 or later: the Mesa drivers have it for the graphics of the last ten years. Without a graphics driver, Mesa's software renderer draws the view, more slowly; to try it, start Studio from a terminal with LIBGL_ALWAYS_SOFTWARE=1 before the program's name.

Memory and disk

Memory: 8 GB or more.
Disk: about 62 MB for the program and its manual, and room for your data. Your data grows with use: the audit log is kept for 180 days and up to 2 GB by default (Tools > Settings… > Log), and every program version and report is kept (see Your data and backups).

Screens and scaling

At least 1280 × 720; Studio is laid out for 1600 × 1000 and more.
Any display scale. Studio follows each screen's scale, and moving the window to another screen rescales it.

A real machine

In 1.0, connecting to a real machine is a preview, from the command line (see A real machine): a serial port (USB) at 115 200 baud, or a controller on the network.

Studio uses the network as follows:

G-code senders connect to the twin on this computer, port 2323;
the browser view uses port 8765, on this computer;
AI clients that take an address use port 8766, on this computer, when you turn it on;
online activation and renewal go to the licence server.

Studio's ports listen on this computer only: other computers cannot reach them.

On Linux, the serial port belongs to the dialout group: add your account to it once (sudo usermod -aG dialout $USER) and log in again.