# Addon Installer

The **Addon Installer** is a time-saving tool built into *Textify*, designed specifically for **addon developers** who regularly test and update their scripts inside Blender.

It allows you to **zip, install, and test** your addon with a **single click**, skipping the usual repetitive steps.

<figure><img src="https://1369578556-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDnkuhGf8ejPBS5cgVCH0%2Fuploads%2FTrkTEn8IbFIkUtsG9StO%2Faddon-installer.gif?alt=media&#x26;token=21b629f2-7c61-4742-836a-fd0ef27c69eb" alt=""><figcaption></figcaption></figure>

***

### 📍 Location

* **Text Editor Menu** → `Text → Install Addon`\
  (The menu item will show the **addon name** after detection.)\
  \
  ![](https://1369578556-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDnkuhGf8ejPBS5cgVCH0%2Fuploads%2FzSJ6aSUjWbl5gR2i6SRt%2Fimage.png?alt=media\&token=ffd67b91-b560-4fbb-85bf-43beeda93c1e)\\

* **Popup Shortcut**: Press **`F2`** to open the install popup.\
  \
  ![](https://1369578556-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDnkuhGf8ejPBS5cgVCH0%2Fuploads%2FVImLypW3quxYNmQ4ksxt%2Fimage.png?alt=media\&token=0c762677-70a8-48fe-a6f2-021a80be1036)\\

* **Quick Install**: Press **`Alt + F2`** to install instantly (no popup).

***

### ❓ How to Use

1. **Open a script** that contains either:
   * A valid `bl_info` dictionary (classic addon)
   * A `blender_manifest.toml` file (extension-style addon)
2. Press **`F2`** or select **Text → Install Addon** to open the installer popup.

   The popup shows:

   * **Addon Name**
   * **Version**
   * **Type** (Addon / Extension)
   * **Directory** (Path to the root with `__init__.py` or `blender_manifest.toml`)
3. Configure your options:\
   ![](https://1369578556-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDnkuhGf8ejPBS5cgVCH0%2Fuploads%2FdXNV54eSdwDnVBHJqP7z%2Fimage.png?alt=media\&token=41881a78-d3cc-4907-8b9f-b9ffab604840)
   * **Open Preferences After Install**: Opens addon settings after installation
   * **Repository**: Only shown if the addon is an *extension*
   * **Install Mode**:
     * `Do Nothing` → Just install
     * `Disable and Enable` → Reload the addon cleanly
     * `Uninstall and Enable` → Fully remove and reinstall
4. ✅ Press **OK** to install the addon with your chosen settings.

***

### ⚡ Quick Install

To bypass the popup and immediately install the current script with detected settings:

* Press **`Alt + F2`**
* Or use the **Text → Install Addon** menu directly

***

### ℹ️ Notes

* The tool only works when:
  * The current script has a valid `bl_info` **or**
  * A `blender_manifest.toml` exists in a detected root folder
* If the root folder cannot be automatically located:
  * A button will appear in the panel to **manually select the correct directory**
  * The selected path must contain the main `__init__.py` or manifest

***

## ⚙️ Preferences

<div align="left"><figure><img src="https://1369578556-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDnkuhGf8ejPBS5cgVCH0%2Fuploads%2FmRXVylh6IQXg8p5FO00W%2Fimage.png?alt=media&#x26;token=f2171fc5-00eb-47e5-8cb3-4e95ec341a2d" alt=""><figcaption><p>Preferences UI</p></figcaption></figure></div>

#### **🧩 Zip Name Style**

Choose how the addon’s zip file will be named during installation:

| Option            | Example (for "Command Palette" v1.0.0) |
| ----------------- | -------------------------------------- |
| **Name Only**     | `command_palette.zip`                  |
| **Name\_Version** | `command_palette_v1.0.0.zip`           |
| **Name-Version**  | `command_palette-1.0.0.zip`            |

This affects the filename used when the script is zipped internally before installation.

#### 📏 **Popup Width**

Set the width of the **F2 installer popup** in pixels.

* Default is `380 px`
* You can increase this if your addon names, paths, or UI text require more space.
