---
title: "Ein Plugin aus einer ZIP installieren"
description: "Ein von der KI erstelltes Plugin manuell installieren und in smabar prüfen."
canonical: "https://smabar.com/de/docs/install-plugin-zip/"
lang: de
---

# Ein Plugin aus einer ZIP installieren

> Ein von der KI erstelltes Plugin manuell installieren und in smabar prüfen.

Kanonische HTML-Fassung: https://smabar.com/de/docs/install-plugin-zip/ · Sprache: de · Herausgeber: smabar (https://smabar.com)

---

[Mit ChatGPT oder Claude bauen](https://smabar.com/de/build-my-plugin.md) erklärt, wie deine KI die ZIP erstellt. Lokaler Plugin-Code läuft mit deinen Nutzerrechten. Lies die Dateien vor der Installation.

## Aufbau der ZIP

```text
my-plugin/
  smabar.json
  plugin.py
  views.py             (falls importiert)
  locales/
    en.json
    de.json
  README.md
  LICENSE              (falls wiederverwendeter Code dies erfordert)
  ...weitere importierte Module und benötigte Assets
```

Die `id` im Manifest muss hier `my-plugin` lauten. Das dort angegebene Einstiegsskript muss vorhanden sein. Ein neues Plugin braucht eine eigene ID; nur den Ordner eines mitgelieferten Beispiels umzubenennen ändert weder Manifest noch Kachel-IDs.

## Installation

1. Entpacke die ZIP zunächst in einen temporären Ordner außerhalb von `.smabar`. Prüfe den vollständigen Plugin-Ordner und seine README auf fehlende Dateien, Zugangsdaten, unerwartete Programme oder Verknüpfungen nach außerhalb.
2. Beende smabar, damit die App keinen teilweise kopierten Ordner liest. Öffne das Plugin-Verzeichnis: unter Linux/macOS `~/.smabar/plugins/`, unter Windows `%USERPROFILE%\.smabar\plugins\` im Explorer. Lege `plugins` an, falls es noch fehlt.
3. Prüfe, ob bereits ein Ordner mit derselben ID existiert. Falls ja, stoppe und lass eine neue ID vergeben oder führe bewusst ein Update mit Sicherung durch. Vermische keine entpackten Dateien mit einem bestehenden Plugin.
4. Verschiebe den vollständigen Ordner `my-plugin` ins Plugin-Verzeichnis. Das Manifest muss unter `plugins/my-plugin/smabar.json` liegen, ohne zusätzliche Ebene `my-plugin/my-plugin`.
5. Starte smabar und prüfe das Plugin in den Einstellungen. Warte gegebenenfalls auf die Vorbereitung der Python-Abhängigkeiten. Laufzeit und SDK liefert smabar; zusätzliche lokale Einstellungen stehen in der README des Plugins.

## In der App prüfen

- Kachel und alle vorhandenen Flyouts, Hover-Ansichten oder Popups öffnen: keine abgeschnittenen Texte, rohen Übersetzungsschlüssel, fehlenden Icons oder unbenannten Bedienelemente.
- Aktionen und Einstellungen ausprobieren; Lade-, Leer- und Fehlerzustände prüfen. Provider und externe Dienste müssen auf deinem Betriebssystem funktionieren.
- smabar neu starten und prüfen, ob Einstellungen und vorgesehene Daten erhalten bleiben.
- `~/.smabar/logs/plugin-my-plugin.log` prüfen; unter Windows `%USERPROFILE%\.smabar\logs\plugin-my-plugin.log`. Die [Debugging-Referenz](https://smabar.com/docs/plugin-ref-guide-debugging.md) erklärt Fehler und Markup-Warnungen. Entferne Zugangsdaten und persönliche Informationen vor dem Teilen von Auszügen.

Datei- und Syntaxprüfungen der ZIP belegen noch keine korrekte Darstellung oder Funktion in smabar. Gib deiner KI bei Problemen den tatsächlichen Fehler oder einen Screenshot. Sicherungen gehören außerhalb von `.smabar/plugins/`, damit sie nicht selbst als Plugins entdeckt werden.