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

207 lines
4.3 KiB
Markdown

# 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+