6.9 KiB
6.9 KiB
🛠 Git Manager Explorer Pro
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)
- Gehe zu Releases
- Lade die neueste
.exe-Datei herunter - Starte die EXE und folge dem Installations-Assistenten
- App startet automatisch nach Installation
Manuell (Entwickler)
git clone https://github.com/M-Viper/git-manager-gui.git
cd git-manager-gui
npm install
npm start
🚀 Quick Start
1️⃣ Credentials konfigurieren
- Starte die App
- Klicke auf ⚙️ Settings
- Trage ein:
- Gitea URL (z. B.
https://git.example.com) - Gitea Token (von Gitea → Einstellungen → Anwendungen)
- GitHub Token (optional, für GitHub Repos)
- Gitea URL (z. B.
- 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 — 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 — 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:writenötig)
Weitere Lösungen im HANDBUCH.html.
🤝 Beitragen
Fehler gefunden oder Idee für neue Features?
- Erstelle ein Issue mit Beschreibung
- Fork das Repo und erstelle einen Branch:
git checkout -b feature/meine-idee - Commit deine Änderungen:
git commit -m "Add: meine neue Funktion" - Push zum Branch:
git push origin feature/meine-idee - Öffne einen Pull Request
👉 Siehe 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
📜 Lizenz
Dieses Projekt ist unter der MIT-Lizenz lizenziert — siehe LICENSE.
👤 Autor
💬 Support & Kontakt
- 📧 Email: admin@m-viper.de
- 🐛 Issues: GitHub Issues
- 📖 Handbuch: HANDBUCH.html
- 👨💻 Entwicklung: DEV_GUIDE.md
Dieses Projekt ist Open-Source unter der GPL Lizenz.