# 🛠 Git Manager Explorer Pro
[](https://github.com/M-Viper/git-manager-gui/releases)
[](LICENSE)
[](https://github.com/M-Viper/git-manager-gui)
**Eine moderne Desktop-Anwendung für vollständige Git-Repository-Verwaltung mit Gitea & GitHub.**
Verwalte deine Repositories intuitiv ohne Kommandozeile — mit Favoriten, Verlauf, Editor und Batch-Aktionen.
---
## ✨ Features
### 🎯 Repository-Verwaltung
- 📂 **Intelligente Repo-Übersicht** mit Tabs nach Besitzer und Fuzzy-Suche
- 🌐 **Gitea & GitHub Support** — seamless integration mit beiden Plattformen
- 🎯 **Favoriten & Verlauf** — schnelle Navigation zu liebsten Projekten
- 📥 **Ein-Klick Migration** — repositories zwischen Services verschieben
- 🚀 **Batch-Aktionen** — dieselbe Operation auf mehreren Repos gleichzeitig
### 💾 Datei-Verwaltung
- ✏️ **Integrierter Editor** mit Syntax-Highlighting und Auto-Save
- 📁 **Datei-Explorer** — navigiere durch Ordnerstruktur wie im Windows Explorer
- 📤 **Drag & Drop Upload** — ziehe Dateien ins App-Fenster zum hochladen
- 📥 **Drag & Drop Download** — ziehe Repos raus zum herunterladen
- 🔄 **Rename & Move** — Dateien verwalten direkt im Editor
### 📊 Versionscontrol
- 📊 **Commit-History** mit Filter nach Autor und Nachricht
- 🏷️ **Tag-Management** — Tags erstellen, bearbeiten, löschen
- 📦 **Release-Verwaltung** — Releases und Assets verwalten
- 📈 **Aktivitäts-Heatmap** — Commit-Historie visualisiert wie auf GitHub
- 🔁 **Retry-Queue** — fehlgeschlagene Ops automatisch erneut versuchen
### ⚙️ Erweiterte Funktionen
- 🖼️ **Repo-Avatare hochladen** — Custom Projektbilder
- 🏷️ **Auto-Topics** — Repositories mit Tags kategorisieren
- 🔒 **Verschlüsselte Credentials** — alle Tokens AES-256 verschlüsselt
- 🚀 **Auto-Startup** — App optional mit Windows starten
- 🔄 **Auto-Update** — aktuelle Version automatisch verfügbar machen
---
## 📋 Systemvoraussetzungen
| Anforderung | Mindest | Empfohlen |
|-------------|--------|----------|
| **OS** | Windows 10 64-bit | Windows 11 |
| **RAM** | 4 GB | 8 GB |
| **Festplatte** | 200 MB | 1 GB (für Repos) |
| **.NET** | Nicht erforderlich | — |
| **Node.js** | Nicht erforderlich | — |
---
## 📦 Installation
### Über Installer (empfohlen)
1. Gehe zu [Releases](https://github.com/M-Viper/git-manager-gui/releases)
2. Lade die neueste `.exe`-Datei herunter
3. Starte die EXE und folge dem Installations-Assistenten
4. App startet automatisch nach Installation
### Manuell (Entwickler)
```bash
git clone https://github.com/M-Viper/git-manager-gui.git
cd git-manager-gui
npm install
npm start
```
---
## 🚀 Quick Start
### 1️⃣ Credentials konfigurieren
1. Starte die App
2. Klicke auf **⚙️ Settings**
3. Trage ein:
- **Gitea URL** (z. B. `https://git.example.com`)
- **Gitea Token** (von Gitea → Einstellungen → Anwendungen)
- **GitHub Token** (optional, für GitHub Repos)
4. Klicke **Verbindung testen** → grüne Haken = erfolgreich ✓
### 2️⃣ Repositories laden
- Klicke **🌐 Load Gitea** um alle deine Repos zu sehen
- Nutze die **Owner-Tabs** um nach Besitzer zu filtern
- Nutze die **Fuzzy-Suche** um schnell ein Repo zu finden
### 3️⃣ Repository öffnen
- **Klick** auf eine Repository-Karte → Datei-Explorer
- **Rechtsklick** → Kontextmenü mit Optionen (Favorit, Clone-URL, Tags, etc.)
- **Drag & Drop** zum Download/Upload
### 4️⃣ Dateien bearbeiten
- Klick auf eine Textdatei → Editor öffnet sich
- **Ctrl+S** zum Speichern (gepusht automatisch auf Gitea)
- **Ctrl+F** zum Suchen & Ersetzen
---
## 📚 Dokumentation
### Für Benutzer
👉 **[HANDBUCH.html](HANDBUCH.html)** — Vollständiges Benutzerhandbuch
- Alle Features erklärt
- Schritt-für-Schritt Anleitungen
- Screenshots & Mockups
- Häufige Fehler & Lösungen
### Für Entwickler
👉 **[DEV_GUIDE.md](DEV_GUIDE.md)** — Entwicklerhandbuch
- Projektstruktur & Architektur
- Setup für lokale Entwicklung
- API-Integration & neue Features
- Code-Konventionen
- Build & Release-Prozess
---
## 🎮 Tastenkürzel
| Shortcut | Aktion |
|----------|--------|
| Ctrl+K | Repo-Suche fokussieren |
| Ctrl+S | Datei im Editor speichern |
| Ctrl+F | Im Editor suchen |
| Escape | Suche schließen |
| Rechtsklick | Kontextmenü (Repos & Dateien) |
| Drag raus | Datei/Repo herunterladen |
| Drag rein | Datei hochladen |
---
## 🐛 Häufige Probleme
### "401 Unauthorized"
- **Ursache**: Token ungültig oder abgelaufen
- **Lösung**: Neues Token auf Gitea generieren (Einstellungen → Anwendungen) und in Settings eintragen
### "ECONNREFUSED" / Server nicht erreichbar
- **Ursache**: Gitea-URL nicht korrekt oder Server down
- **Lösung**: URL prüfen; bei IPv6: Klammern verwenden `http://[::1]:3000`
### Repositories werden nicht angezeigt
- **Ursache**: Owner-Tab "Meine" ist vorausgewählt (filtert fremde Repos)
- **Lösung**: Tab "Alle" wählen oder nach Name suchen
### Editor speichert nicht
- **Ursache**: Token hat keine Schreibrechte
- **Lösung**: Token-Berechtigungen prüfen (mindestens `repository:write` nötig)
Weitere Lösungen im [HANDBUCH.html](HANDBUCH.html#häufige-fehler--lösungen).
---
## 🤝 Beitragen
Fehler gefunden oder Idee für neue Features?
1. [Erstelle ein Issue](https://github.com/M-Viper/git-manager-gui/issues/new) mit Beschreibung
2. Fork das Repo und erstelle einen Branch: `git checkout -b feature/meine-idee`
3. Commit deine Änderungen: `git commit -m "Add: meine neue Funktion"`
4. Push zum Branch: `git push origin feature/meine-idee`
5. Öffne einen Pull Request
👉 Siehe [DEV_GUIDE.md](DEV_GUIDE.md) für Entwickler-Setup.
---
## 📝 Changelog
### v2.1.3 (13. Mai 2026)
- ✨ Projektname wird korrekt ausgeblendet bei Wechsel zur Übersicht
- 🐛 Bug-Fix: Zurück-Button setzt Gravur korrekt zurück
- 📚 Erweiterte Dokumentation (Benutzer- & Entwicklerhandbuch)
### v2.1.0
- 🎯 Neue Batch-Aktionen
- 📊 Aktivitäts-Heatmap
- 🔄 Verbesserte Fehlerbehandlung
[Vollständiger Changelog →](https://github.com/M-Viper/git-manager-gui/releases)
---
## 📜 Lizenz
Dieses Projekt ist unter der **MIT-Lizenz** lizenziert — siehe [LICENSE](LICENSE).
---
## 👤 Autor
**M_Viper** — [GitHub](https://github.com/M-Viper) | [Website](https://m-viper.de)
---
## 💬 Support & Kontakt
- 📧 **Email**: admin@m-viper.de
- 🐛 **Issues**: [GitHub Issues](https://github.com/M-Viper/git-manager-gui/issues)
- 📖 **Handbuch**: [HANDBUCH.html](HANDBUCH.html)
- 👨💻 **Entwicklung**: [DEV_GUIDE.md](DEV_GUIDE.md)
Dieses Projekt ist Open-Source unter der [GPL Lizenz](LICENSE).