axion1337.chat-gitops/docs/setup/README-Element-Setup.md

# Element Desktop Setup Scripts

Automatische Konfiguration und Installation von Element Desktop mit Custom Themes für aXion1337.Chat

## 📋 Systemanforderungen

- **Windows 10/11**
- **macOS 10.13+**
- **Linux** (Ubuntu, Debian, Fedora, Arch, openSUSE, etc.)

---

## 🪟 Windows

### Installation

1. **Lade die Datei herunter**: `element-setup-windows.cmd`
2. **Doppelklick** auf die Datei
3. Das Skript wird automatisch:
   - ✅ Die config.json erstellen
   - ✅ Element Desktop installieren (falls nötig)
   - ✅ Element starten

**Oder manuell:**
```cmd
element-setup-windows.cmd
```

### Voraussetzungen

Das Skript versucht automatisch, Element zu installieren über:
- Windows Store (Microsoft Store)
- WinGet (Windows Package Manager)
- Chocolatey

Falls nichts davon vorhanden ist, installiere Element manuell:
https://element.io/download

---

## 🍎 macOS

### Installation

1. **Lade die Datei herunter**: `element-setup-macos.command`
2. **Doppelklick** im Finder
3. Das Skript wird automatisch:
   - ✅ Die config.json erstellen
   - ✅ Element Desktop installieren (über Homebrew falls nötig)
   - ✅ Element starten

**Oder im Terminal:**
```bash
chmod +x element-setup-macos.command
./element-setup-macos.command
```

### Voraussetzungen

Das Skript nutzt **Homebrew** (falls vorhanden):
```bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```

Oder installiere Element manuell:
https://element.io/download

---

## 🐧 Linux

### Installation

1. **Lade die Datei herunter**: `element-setup-linux.sh`
2. **Im Terminal:**
   ```bash
   chmod +x element-setup-linux.sh
   ./element-setup-linux.sh
   ```

3. Das Skript wird automatisch:
   - ✅ Die config.json erstellen
   - ✅ Element Desktop installieren (über apt/dnf/pacman/zypper)
   - ✅ Element starten

### Unterstützte Distributionen

- **Ubuntu/Debian**: `apt`
- **Fedora/RHEL**: `dnf`
- **Arch Linux**: `pacman`
- **openSUSE**: `zypper`

---

## ✅ Was die Skripte machen

Alle Skripte führen diese Schritte aus:

1. **config.json erstellen** im richtigen Verzeichnis:
   - **Windows**: `%APPDATA%\Element\config.json`
   - **macOS**: `~/Library/Application Support/Element/config.json`
   - **Linux**: `~/.config/Element/config.json`

2. **Automatische Konfiguration**:
   ```json
   {
     "configUrl": "https://axion1337.chat/config.json",
     "brand": "aXion1337.Chat",
     "default_theme": "aXion1337 Dark",
     "show_labs_settings": true,
     "features": {
       "feature_qr_code_login": true
     }
   }
   ```

3. **Element Desktop installieren** (falls nicht vorhanden)

4. **Element starten** und deine Custom Themes laden

---

## 🎨 Themes nach Setup

Nach dem Setup hat dein Element Desktop:

1. **Automatisch geladene Themes** von: `https://axion1337.chat/config.json`
2. **Standard Theme**: aXion1337 Dark
3. **Verfügbare Themes**:
   - aXion1337 Dark
   - Deep Purple
   - Discord Dark
   - Electric Blue
   - Everforest dark hard
   - Gruvbox Dark
   - Wal

---

## ⚙️ Manuelle Konfiguration (falls Skript nicht funktioniert)

Falls die Skripte nicht funktionieren, erstelle manuell die config.json:

### Windows
```
%APPDATA%\Element\config.json
```

### macOS
```
~/Library/Application Support/Element/config.json
```

### Linux
```
~/.config/Element/config.json
```

**Inhalt** (copy-paste):
```json
{
  "configUrl": "https://axion1337.chat/config.json",
  "brand": "aXion1337.Chat",
  "default_theme": "aXion1337 Dark",
  "show_labs_settings": true,
  "features": {
    "feature_qr_code_login": true
  },
  "setting_defaults": {
    "custom_themes": []
  }
}
```

---

## 🆘 Troubleshooting

### Element startet nicht
- Stelle sicher, dass Element Desktop installiert ist
- Überprüfe den Installationspfad
- Starten manuell: `element` (Terminal/CMD)

### config.json wird nicht geladen
- Überprüfe, dass die Datei im richtigen Verzeichnis ist
- Beende Element vollständig (auch in der Taskbar)
- Starte Element neu

### Themes nicht sichtbar
- Überprüfe Internetverbindung
- `https://axion1337.chat/config.json` sollte erreichbar sein
- Öffne Settings > Appearance > Theme und wähle manuell

---

## 📞 Support

Bei Fragen oder Problemen:
- https://element.io/help
- https://axion1337.chat

---

**Version**: 1.0  
**Letztes Update**: 2026-04-23  
**Kompatibilität**: Element Desktop 1.11+