diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3f651be
--- /dev/null
+++ b/README.md
@@ -0,0 +1,24 @@
+# ViewIT
+
+<img src="addon/resources/logo.png" alt="ViewIT Logo" width="220" />
+
+ViewIT ist ein Kodi‑Addon zum Durchsuchen und Abspielen von Inhalten der unterstützten Anbieter.
+
+## Projektstruktur
+- `addon/` Kodi‑Addon Quellcode
+- `scripts/` Build‑Scripts (arbeiten mit `addon/` + `dist/`)
+- `dist/` Build‑Ausgaben (ZIPs)
+- `docs/`, `tests/`
+
+## Build & Release
+- Addon‑Ordner bauen: `./scripts/build_install_addon.sh` → `dist/<addon_id>/`
+- Kodi‑ZIP bauen: `./scripts/build_kodi_zip.sh` → `dist/<addon_id>-<version>.zip`
+- Addon‑Version in `addon/addon.xml`
+
+## Entwicklung (kurz)
+- Hauptlogik: `addon/default.py`
+- Plugins: `addon/plugins/*_plugin.py`
+- Einstellungen: `addon/resources/settings.xml`
+
+## Dokumentation
+Siehe `docs/`.