ModernUI Workbench
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.
Introduction[edit | edit source]
The ModernUI Workbench is an external workbench that replaces the standard user interface. It has modern features such as:
- Each workbench has its ribbon tab.
- Modern UI ribbon tab replaces the top-level menu.
- Activating a workbench's ribbon tab shows groups of the workbench's tools.
- Panels such as Combo View are collapsed/expanded upon mouse-over.
References[edit | edit source]
- Author: Hakan Seven
- Source code on github: Source code Modern-UI
Limitations and Troubleshooting[edit | edit source]
- If you experience unexpected behavior, always first try to uninstall and then reinstall the ModernUI workbench.
- The workbench is primarily tested with English and may exhibit unexpected behavior in other languages.
- Installing more workbenches after installing ModernUI may cause problems.
Install[edit | edit source]
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[edit | edit source]
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 0.19
Linux[edit | edit source]
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[edit | edit source]
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[edit | edit source]
Detailed instructions can be found on GitHub.
The uninstall sequence is as follows:
- Uninstall with the
Addon Manager.
- Restart FreeCAD.
- 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()
- Execute the macro.
- Restart FreeCAD.
Links[edit | edit source]
- FreeCAD Forum: https://forum.freecad.org/viewtopic.php?f=34&t=44937
- Report bugs: https://github.com/HakanSeven12/Modern-UI
- Patreon (to support the author): https://www.patreon.com/HakanSeven12
- Getting started
- Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
- Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate
- Help: Tutorials, Video tutorials
- Workbenches: Std Base, Assembly, BIM, CAM, Draft, FEM, Inspection, Material, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Surface, TechDraw, Test Framework
- Hubs: User hub, Power users hub, Developer hub