ModernUI Workbench

Other languages:

This documentation is not finished. Please help and contribute documentation.

GuiCommand model explains how commands should be documented. Browse Category:UnfinishedDocu to see more incomplete pages like this one. See Category:Command Reference for all commands.

See WikiPages to learn about editing the wiki pages, and go to Help FreeCAD to learn about other ways in which you can contribute.

Modern UI workbench icon

Introduction

The ModernUI Workbench is an external workbench that replaces the standard user interface. It has modern features such as:

References

Limitations and Troubleshooting

Install

Install with the Addon Manager.

Note: To uninstall, you have to create a macro and execute it. If you do not feel confident about this, consider to not install.

Running Modern UI in a self-contained directory

To easily test Modern UI without interfering with your standard configuration, you can contain it in a separate directory. Uninstalling Modern UI is then simply accomplished by deleting the directory. introduced in version 0.19

Linux

For example: 

$ mkdir modernUI  # new directory that contains Modern UI
$ cd modernUI
$ HOME="$PWD" FREECAD_USER_HOME="$PWD" FreeCAD_0.19.AppImage

When starting FreeCAD like this for the first time, you have a new default configuration. Now install (and configure) Modern UI. This is essentially a portable FreeCAD version.

Instead of using the command line, you can also create a dedicated desktop icon.

Windows

There are not dedicated instructions for Windows yet, however, it is very similar to creating a portable version of FreeCAD on a USB medium.

Uninstall

Detailed instructions can be found on GitHub.

The uninstall sequence is as follows:

  1. Uninstall with the Addon Manager.
  2. Restart FreeCAD.
  3. Create a macro with this code:
    from PySide2 import QtCore, QtGui, QtWidgets
mw = FreeCADGui.getMainWindow()
mw.menuBar().show()
 
WBList = FreeCADGui.listWorkbenches()
for WB in WBList:
    FreeCADGui.activateWorkbench(WB)
    for tb in mw.findChildren(QtWidgets.QToolBar):
        tb.show()
  4. Execute the macro.
  5. Restart FreeCAD.

Links


User documentation