Preferences

Open the preferences with Window ▸ Preferences…. Changes take effect at once, except where noted, and are kept for the next time you start Terrafold. The browser version doesn't keep preferences between visits.

The preferences have seven sections: General, Drawing, Language, Template, Graphics, Files and Shortcuts.

General

Setting	Default	What it does
Autosave unsaved work every … min	on, 2 minutes	saves a recovery copy of a model with unsaved changes; the interval can be 1 to 120 minutes. Autosaved work is offered again when Terrafold did not close normally.
Keep a backup when saving over a file	on	keeps the previous version next to the file as `<name>.backup.tfo`
Check models for problems when they open	on	checks each model you open and reports problems in the status bar
Show the Welcome window at startup	on	shows the Welcome window when Terrafold starts
Toolbar style	Ribbon	Ribbon groups every command in tabs; Classic toolbars shows the Getting Started and Sandbox toolbars instead, which you toggle in View ▸ Toolbars

Drawing

The Line tool takes points by:

Either (detect clicks and drags), the default.
Click, drag and release: press at the start point and release at the end point.
Click, move and click: click the start point, then click the end point.

Continue drawing from the end of each line (on by default) starts the next line where the last one ended. A chain of lines always ends when it closes a face or when you press Escape.

Language

Choose System language, which follows your computer's language, or one of:

English
Nederlands (Dutch)
Français (French)

The interface changes language at once. Your model data, file names and messages from the modelling engine stay as they are. If your system language isn't one of these, Terrafold uses English. Some panels and messages are not translated yet.

Template

Setting	What it does
Units of new models	As in the template, or mm, cm, m, in or ft
New models start from	An empty model, or one of your templates

Make a template with File ▸ Save As Template….

Graphics

Setting	What it does
Draw the viewport on the graphics card	on by default; turn it off to draw on the processor, for example if your graphics driver causes problems. If no graphics card is available, the processor is always used.
Smooth edges (anti-aliasing)	smooths jagged edges in the viewport
Largest texture size	What the graphics card allows, or a limit from 512 to 16384 pixels; a lower limit saves graphics memory

Anti-aliasing and the texture size take effect the next time Terrafold starts.

Files

Setting	Default	What it does
Open and save in	the system's default folder	the folder the open and save dialogs start in
Templates folder	`templates` in Terrafold's data folder	where templates are saved and found
Knowledge Center address	this documentation	the page Help ▸ Knowledge Center opens; leave it empty to use the pages built into Terrafold
Releases page	the Download page	the page Help ▸ Check for Update opens

Addresses open in your web browser only when you choose the menu item.

Shortcuts

Every command with its shortcut. You can search, assign, remove and reset shortcuts, and import or export them. See Keyboard shortcuts.

Where Terrafold keeps its files

Data folder

Terrafold keeps recovery files, templates and extensions in its data folder:

Platform	Data folder
Linux, FreeBSD	`~/.local/share/terrafold` (or `$XDG_DATA_HOME/terrafold`)
macOS	`~/Library/Application Support/Terrafold`
Windows	`%LOCALAPPDATA%\Terrafold`

It contains:

recovery: autosaved and crash recovery copies of unsaved models.
templates: your templates, unless you chose another folder in Preferences ▸ Files.
extensions: installed extensions (see Extensions).

To use another data folder, set the environment variable TERRAFOLD_DATA_DIR before starting Terrafold. Log files then go to its logs folder.

Preferences

Your preferences, shortcuts, trays and ribbon layout are stored by the application under the id be.appmire.terrafold, in your system's per-user application data location. On Linux that is usually ~/.local/share/be.appmire.terrafold.

Components library

The Local Library of the Components panel uses ~/Terrafold/Components by default.

Log files

Terrafold writes a log file, terrafold.log. The logs of the two previous runs are kept as terrafold.1.log and terrafold.2.log.

Platform	Log folder
Linux, FreeBSD	`~/.local/state/terrafold/logs` (or `$XDG_STATE_HOME/terrafold/logs`)
macOS	`~/Library/Logs/Terrafold`
Windows	`%LOCALAPPDATA%\Terrafold\logs`

If you report a problem, include the log file and, if you can, a model that shows the problem.

Moving from an earlier version

If you used Terrafold before it got its current name, your data folder and preferences are moved to the new locations the first time you start the new version.