# 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="/files/4AAf0g8OaRhPVyBB87a0" alt=""><figcaption></figcaption></figure>

***

### 📍 Location

* **Text Editor Menu** → `Text → Install Addon`\
  (The menu item will show the **addon name** after detection.)\
  \
  ![](/files/Ax62a7I9egfpa9VkIwfB)<br>
* **Popup Shortcut**: Press **`F2`** to open the install popup.\
  \
  ![](/files/VhsxYmTO5LX9uFaUMRoG)<br>
* **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:\
   ![](/files/sVIT1YndNbl6DOAPA4iv)
   * **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="/files/Id6XeQZaDOVESkmyQ4jx" 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://jishnujithu.gitbook.io/textify/tools/addon-installer.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.