213 lines
6.9 KiB
Markdown
213 lines
6.9 KiB
Markdown
# 🛠 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 |
|
||
|----------|--------|
|
||
| <kbd>Ctrl</kbd>+<kbd>K</kbd> | Repo-Suche fokussieren |
|
||
| <kbd>Ctrl</kbd>+<kbd>S</kbd> | Datei im Editor speichern |
|
||
| <kbd>Ctrl</kbd>+<kbd>F</kbd> | Im Editor suchen |
|
||
| <kbd>Escape</kbd> | Suche schließen |
|
||
| <kbd>Rechtsklick</kbd> | Kontextmenü (Repos & Dateien) |
|
||
| <kbd>Drag</kbd> raus | Datei/Repo herunterladen |
|
||
| <kbd>Drag</kbd> 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).
|