carta
freecad(1)

freecad1

Extensible open source cax program

Usage

freecad [options] files

freecadcmd [options] files

Overview

FreeCAD is an Open Source CAx RAD based on OpenCasCade, Qt and Python. It features some key concepts like macro recording, workbenches, ability to run as a server and dynamically loadable application extensions and it is designed to be platform independent.

Usage

freecad starts with a GUI while freecadcmd is only a pure command line version that starts a Python interpreter.

Options

These programs follow the usual GNU command line syntax, with long options starting with two dashes (`-'). A summary of the options supported by freecad is included below.

Generic options

-c, --console

Starts in console mode.

--dump-config

Dumps configuration.

--get-config arg

Prints the value of the requested configuration key.

-h, --help

Prints help message.

--response-file arg

Can be specified with '@name', too.

-v, --version

Prints version string.

Configuration

-l, --write-log

Writes a log file to $HOME/.FreeCAD/FreeCAD.log

--log-file arg

Unlike --write-log this allows logging to an arbitrary file.

-M, --module-path arg

Additional module paths.

-P, --python-path arg

Additional Python paths.

-s, --system-cfg arg

System config file to load/save system settings.

--single-instance

Allow one to run a single instance of the application.

-t, --run-test arg

Test case - or 0 for all.

-u, --user-cfg arg

User config file to load/save user settings.

History

  • Debian 13 (Trixie): the text shown here
  • Debian 12 (Bookworm) to Debian 11 (Bullseye)
  • Debian 10 (Buster) to Debian 6.0 (Squeeze)

--dump-config since Debian 11 (Bullseye); --get-config since Debian 11 (Bullseye); --log-file since Debian 11 (Bullseye); --single-instance since Debian 11 (Bullseye); --system-cfg since Debian 11 (Bullseye); --user-cfg since Debian 11 (Bullseye); -s since Debian 11 (Bullseye); -u since Debian 11 (Bullseye).

Bugs

To report a bug, please visit https://github.com/FreeCAD/FreeCAD/issue

Author

This manual page was written by Werner Mayer and Salman Mohammadi <[email protected]>.

From freecad-common 1.0.0+dfsg-8+deb13u3 in Debian 13 (Trixie). Parsed by carta from the page's man source.