.. badge:: Quick Start
   :color: green
.. badge:: Full Course
   :color: blue

Installing EM Tools: yEd and the Blender Add-on
===============================================

.. raw:: html

   <!-- Replace VIDEO_ID with the actual YouTube video ID for 12_em_install_tools -->
   <div style="position:relative;padding-bottom:56.25%;height:0;overflow:hidden;max-width:100%;">
   <iframe src="https://www.youtube.com/embed/VIDEO_ID_12_em_install_tools"
           style="position:absolute;top:0;left:0;width:100%;height:100%;"
           frameborder="0" allowfullscreen></iframe>
   </div>
   <p><em>▶ Installing EM Tools: yEd and the Blender Add-on (~~5 min)</em></p>

| **Clip:** 12  |  **Duration:** ~5 min  |  **Recording segment:** 57:29 → ~1:03:00

----

Prerequisites
-------------

Blender 3.x, yEd Graph Editor (free download from yworks.com).

Overview
--------

Step-by-step installation: download the EM add-on from GitHub releases, install it in Blender via Edit → Preferences → Add-ons, enable it, then import the EM palette into yEd via Edit → Manage Palette → Import New Section. Both tools are now ready to create and visualise Extended Matrices.

.. figure:: /_static/screenshots/clip_12/0001_extendedmatrix_org_home.jpg
   :alt: The ExtendedMatrix.org homepage — the central hub for downloads and documentation.
   :width: 90%

   The ExtendedMatrix.org homepage — the central hub for downloads and documentation.

Key Concepts
------------

- Download the OS-specific build from the GitHub Releases page.
- Blender: install from disk, enable via checkbox — no restart required.
- yEd: the EM palette appears in the right panel after import.
- Both tools read/write the same GraphML file format.

Screenshots
-----------

.. figure:: /_static/screenshots/clip_12/0002_download_page_requirements.jpg
   :alt: Download page listing software requirements (Blender version, yEd version).
   :width: 90%

   Download page listing software requirements (Blender version, yEd version).

.. figure:: /_static/screenshots/clip_12/0004_blender_addon_install.jpg
   :alt: Blender: Add-ons preferences with 'Install from Disk' highlighted.
   :width: 90%

   Blender: Add-ons preferences with 'Install from Disk' highlighted.

.. figure:: /_static/screenshots/clip_12/0005_blender_addon_enabled.jpg
   :alt: The EM add-on enabled in Blender preferences (checkbox checked).
   :width: 90%

   The EM add-on enabled in Blender preferences (checkbox checked).

.. figure:: /_static/screenshots/clip_12/0006_yed_manage_palette.jpg
   :alt: yEd: Edit → Manage Palette → Import New Section dialog.
   :width: 90%

   yEd: Edit → Manage Palette → Import New Section dialog.

.. figure:: /_static/screenshots/clip_12/0007_yed_palette_visible.jpg
   :alt: The EM palette visible in the yEd right-hand panel after import.
   :width: 90%

   The EM palette visible in the yEd right-hand panel after import.

Try It Yourself
---------------

Install the add-on and confirm the EM panel appears in Blender's sidebar (N key) and the EM palette is visible in yEd.

.. note::

   A video walkthrough for this tutorial will be available on the Extended Matrix YouTube channel.

.. seealso::

   :doc:`Introduction: What Is Extended Matrix? <em-doc:learn-em/tutorials/01-introduction>`