FreeCAD: add EasyAlias Macro

[last updated: 2025-09-13]
Disclaimers
Spreadsheet workbench
(link to:) FreeCAD: Macros
----------

• The official, proper way to add macros is with the AddOn Manager (FreeCAD documentation)
  However I could not get it to work with my version of FC 1.0.2
• So this is the "manual" way of doing it, which should BTW work with any macro.

• First you need your macro code:
  You can get this code is several ways:
  • record it while executing the steps:
    see: FreeCAD: Macros link above
  • manually create it in a text editor:
    see: FreeCAD: Macros link above for tips and links for writing your own python macro code.
  • download it from some online source:
    This is the method I used for the EasyAlias macro. Its code is available here: select and copy the code from the text block
    Or: EasyAlias from FreeCAD site, with usage instructions, and scroll down for link to download the code
• Once you have the code, it must be in a plain text file, with the extension ".FCMacro"
  Place it in the proper folder under the user's FreeCAD directory.
  In my case, using FC 1.0.2 with executable AppImage, the proper folder was:
      /home/ [username] /.local/share/FreeCAD/Macro
• Install it into your FreeCAD:
  • Macro --> Macros (top menu bar)
    Your macro should be listed
  • Click to select it
    Click Toolbar (right menu bar)
    A dialog box will open. Fill out any fields desired.
    Click Add --> Close
  • Dialog pg2 will open
    If there is no toolbar listed in the right pane, click New to create one.
    Enter desired toolbar name, or accept default offered, and press OK
    click to select your desired macro in the left pane, and click Rt-arrow.
    Your macro should now be listed in the right pane. Click Close, then Close.
    Your macro should be listed in a new toolbar at the top of your page.

-----------------------------------------

eof