Power users hub



This is the place to come if you want to have a deeper insight into FreeCAD. Here you can learn about customizing FreeCAD for your needs.

These pages are in early stage of development. If you can't find the information you are looking for, or have found useful information somewhere we have not linked to, then please leave a comment on the talk page, or, why not? Add some more content here yourself!

One of the nicest features of FreeCAD is that you can script and extend it extremely far without the need to compile anything or touch the source code. All the scripting part is done in python, a very powerful but simple programming language. With simple python scripts, you have total access to about any part of Freecad. For example, you can:
 * Create and modify geometry: There is a kind of special object you need but that's not present in the default FreeCAD installation? You can easily create a new object type, either from scratch eiter from adapting an existing type.
 * Create custom tools and commands: At the moment, FreeCAD already has extensive functionality, but there aren't many convenient tools and commands for the final user yet. But it is already easy to create your own sets of tools.
 * Modify the interface: The FreeCAD user interface is still very basic at this stage. But everything is there for you to extend it to your needs. You can, for example, create toolbars to put your own tools, create special panels for interacting with your tools, etc.
 * Modify the scene representation: FreeCAD has separate processes for building up and computing the geometry and displaying that geometry on your screen. You have full access to the way the scene contents are displayed on screen, therefore you can modify that representation, interact with it, or add all kinds of custom behaviours and screen widgets, like information, draggers, anchors or temporary entities.

Customizing FreeCAD

 * Interface Customization: Starting with the beginnig: Toolbars and shortcuts
 * Working with Macros: Easily record often repeated tasks or python code

Scripting in FreeCAD

 * Scripting homepage: Everything about python scripting in FreeCAD

General
 * Introduction to python
 * FreeCAD Scripting Basics: Well, the basics...
 * Builtin modules: The base tools available to you
 * Mesh Scripting: How to interact with the Mesh Module
 * Gui Command : Adding custom commands to the GUI
 * Using mixed Units in FreeCAD

Using OpenCasCade
 * The Part Module: How OpenCasCade tools and structure is used in FreeCAD
 * Topological data scripting: How to interact with the Part Module
 * pythonOCC: How to unleash the whole OpenCasCade power
 * Mesh to Part: Converting between object types

Accessing the Coin scenegraph
 * The Coin/Inventor scenegraph: How the FreeCAD scene representation works
 * Pivy: How to access and modify the scenegraph

Controlling the Qt interface
 * PyQt: How to access the interface, and modify its contents
 * Using the FreeCAD GUI in another Qt application wity PyQt

Parametric objects
 * Scripted objects: How to make 100% python-scripted objects in FreeCAD
 * Drawing Module: Automating the 3D-to-2D process

Examples
 * Line drawing function: How to build a simple tool to draw lines
 * Dialog creation: How to construct dialogs with Qt designer, and use them in FreeCAD
 * Embedding FreeCAD: How to import FreeCAD as a python module in other applications

API Functions
The complete API description can be found here. Note that it can be incomplete, since we still didn't find a way to include it automatically on this wiki. For more accurate information, browse the modules directly from FreeCAD.

Advanced modification

 * Start up and Configuration: Startup and command line options
 * Install on Windows: Using the windows installer
 * Compiling FreeCAD on Windows and Compiling FreeCAD on Unix
 * Branding: Simple modifications you can do to the source code to change some aspects of FreeCAD

Community projects
On the Community portal, you can find other FreeCAD-based projects run by the FreeCAD users community. If you are starting a new FreeCAD project, be sure to list it there! We also have a page with things you can do if you would like to Help FreeCAD.