ModernUI Workbench: Difference between revisions

From FreeCAD Documentation
No edit summary
mNo edit summary
Line 9: Line 9:
<translate>
<translate>


==Introduction==
== Introduction ==


The [[ModernUI Workbench]] is an [[external workbenches|external workbench]] that replaces the standard user interface with modern features such as:
The [[ModernUI Workbench]] is an [[external workbenches|external workbench]] that replaces the standard user interface with modern features such as:
Line 17: Line 17:
* Panels such as '''Combo View''' are collapsed/expanded upon mouse-over
* Panels such as '''Combo View''' are collapsed/expanded upon mouse-over


==References==
== References ==


* Author: Hakan Seven
* Author: Hakan Seven
* Source code on github: https://github.com/HakanSeven12/Modern-UI
* Source code on github: https://github.com/HakanSeven12/Modern-UI


==Limitations and Troubleshooting==
== Limitations and Troubleshooting ==


* If you experience unexpected behavior, always try first to uninstall and then reinstall the ModernUI workbench.
* If you experience unexpected behavior, always try first to uninstall and then reinstall the ModernUI workbench.
Line 53: Line 53:
There are not dedicated instructions for Windows yet, however, it is very similar to [[Start_up_and_Configuration#Starting_FreeCAD_from_a_portable_USB_medium|creating a portable version of FreeCAD on a USB medium]].
There are not dedicated instructions for Windows yet, however, it is very similar to [[Start_up_and_Configuration#Starting_FreeCAD_from_a_portable_USB_medium|creating a portable version of FreeCAD on a USB medium]].


==Uninstall==
== Uninstall ==


Detailed instructions are found at [https://github.com/HakanSeven12/Modern-UI#uninstallation GitHub].
Detailed instructions are found at [https://github.com/HakanSeven12/Modern-UI#uninstallation GitHub].
Line 73: Line 73:
* 5. Restart FreeCAD
* 5. Restart FreeCAD


==Links==
== Links ==


* Workbench Wiki:
* Workbench Wiki:
Line 83: Line 83:
* Report bugs: https://github.com/HakanSeven12/Modern-UI
* Report bugs: https://github.com/HakanSeven12/Modern-UI
* Patreon (to support the author): https://www.patreon.com/HakanSeven12
* Patreon (to support the author): https://www.patreon.com/HakanSeven12



</translate>
</translate>

Revision as of 15:02, 30 August 2021

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 with modern features such as:

  • each workbench has its ribbon tab
  • Modern UI ribbon tab replaces 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

Limitations and Troubleshooting

  • If you experience unexpected behavior, always try first 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

Install with the Addon Manager.

Note: To uninstall, you will 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

introduced in version 0.19 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.

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 are found at 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 macro
  • 5. Restart FreeCAD

Links