ModernUI Workbench: Difference between revisions

From FreeCAD Documentation
(→‎Install: Add self-contained installation for LInux)
(Addon_Manager -> Std_AddonMgr)
 
(25 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{UnfinishedDocu{{#translation:}}}}
{{UnfinishedDocu{{#translation:}}}}
<translate>
[[Image:ModernUI_workbench_icon.svg|thumb|128px|Modern UI workbench icon]]


<!--T:1-->
==Introduction==
[[Image:ModernUI_workbench_icon.svg|thumb|128px|Modern UI workbench icon]]


</translate>
{{TOCright}}
{{TOCright}}
<translate>


== Introduction == <!--T:2-->
The [[ModernUI Workbench]] is an [[external workbenches|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


<!--T:3-->
==References==
The [[ModernUI_Workbench|ModernUI Workbench]] is an [[External_workbenches|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|Combo View]] are collapsed/expanded upon mouse-over.


== References == <!--T:4-->

<!--T:5-->
* 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 Source code Modern-UI]


==Limitations and Troubleshooting==
== Limitations and Troubleshooting == <!--T:6-->


<!--T:7-->
* If you experience unexpected behavior, always try first to uninstall and then reinstall the ModernUI workbench.
* 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.
* The workbench is primarily tested with English and may exhibit unexpected behavior in other languages.
* Installing more workbenches after installing ModernUI may cause problems.
* Installing more workbenches after installing ModernUI may cause problems.


== Install ==
== Install == <!--T:8-->


<!--T:9-->
Install with the [[Image:AddonManager.svg|24px|link=Addon Manager]] [[Addon Manager]].
Install with the [[Image:Std_AddonMgr.svg|24px|link=Std_AddonMgr]] [[Std_AddonMgr|Addon Manager]].


<!--T:10-->
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.
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 ===
=== Running Modern UI in a self-contained directory === <!--T:11-->


<!--T:12-->
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.
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. {{Version|0.19}}


==== Linux ==== <!--T:13-->
'''Linux'''


<!--T:14-->
For example:
For example:
$ mkdir modernUI # new directory that contains Modern UI
$ cd modernUI
$ HOME="$PWD" FREECAD_USER_HOME="$PWD" FreeCAD_0.19.AppImage


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

<!--T:15-->
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 [[Download#Notes_for_GNU.2FLinux_users|''portable'' FreeCAD version]].
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 [[Download#Notes_for_GNU.2FLinux_users|''portable'' FreeCAD version]].


<!--T:16-->
Instead of using the command line, you can also [[Start_up_and_Configuration#Starting_FreeCAD_from_the_desktop|create a dedicated desktop icon]].
Instead of using the command line, you can also [[Start_up_and_Configuration#Starting_FreeCAD_from_the_desktop|create a dedicated desktop icon]].


==== Windows ==== <!--T:17-->
==Uninstall==


<!--T:18-->
Detailed instructions are found at [https://github.com/HakanSeven12/Modern-UI#uninstallation GitHub].
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 == <!--T:19-->

<!--T:20-->
Detailed instructions can be found on [https://github.com/HakanSeven12/Modern-UI#uninstallation GitHub].

<!--T:21-->
The uninstall sequence is as follows:
The uninstall sequence is as follows:
* 1. Uninstall with the [[Image:AddonManager.svg|24px|link=Addon Manager]] [[Addon Manager]].
# Uninstall with the [[Image:AddonManager.svg|24px|link=Std_AddonMgr]] [[Std_AddonMgr|Addon Manager]].
* 2. Restart FreeCAD
# Restart FreeCAD.
* 3. Create a macro with this code
# Create a macro with this code:
</translate>{{Code|code=
from PySide2 import QtCore, QtGui, QtWidgets
from PySide2 import QtCore, QtGui, QtWidgets
mw = FreeCADGui.getMainWindow()
mw = FreeCADGui.getMainWindow()
mw.menuBar().show()
mw.menuBar().show()
WBList = FreeCADGui.listWorkbenches()
WBList = FreeCADGui.listWorkbenches()
for WB in WBList:
for WB in WBList:
FreeCADGui.activateWorkbench(WB)
FreeCADGui.activateWorkbench(WB)
for tb in mw.findChildren(QtWidgets.QToolBar):
for tb in mw.findChildren(QtWidgets.QToolBar):
tb.show()
tb.show()
}}
* 4. Execute macro
<translate>
* 5. Restart FreeCAD
<!--T:22-->
# Execute the macro.
# Restart FreeCAD.


==Links==
== Links == <!--T:23-->


<!--T:24-->
* Workbench Wiki:
* FreeCAD Wiki:
* FreeCAD Forum: https://forum.freecadweb.org/viewtopic.php?f=34&t=44937
* FreeCAD Forum: https://forum.freecadweb.org/viewtopic.php?f=34&t=44937
* Tutorials:
* Videos:
* Files:
* 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>
{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
[[Category:External_Workbenches{{#translation:}}]]
[[Category:Addons{{#translation:}}]]
[[Category:Addons{{#translation:}}]]
[[Category:External Workbenches{{#translation:}}]]

Latest revision as of 20:16, 3 November 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. 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

Limitations and Troubleshooting

  • 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

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