01 Erste Schritte
+ ++ Git Manager Explorer Pro ist eine Desktop-Anwendung auf Basis von Electron, + die dir eine grafische Oberfläche für deine Gitea- und GitHub-Repositories gibt. + Du kannst Dateien direkt im integrierten Editor bearbeiten, Commits einsehen, Releases anlegen, + Repositories migrieren und vieles mehr – alles ohne Kommandozeile. +
+ +| Voraussetzung | Mindest | Empfohlen |
|---|---|---|
| Windows | Windows 10 (64-bit) | Windows 11 |
| RAM | 4 GB | 8 GB |
| Netzwerk | Zugang zu Gitea/GitHub-URL | Stabile Verbindung |
| Gitea API | ≥ 1.17 | 1.21+ |
Die App startet mit npm start im Projektordner oder über die bereitgestellte .exe-Datei.
+ Beim ersten Start sind noch keine Credentials gespeichert — öffne zuerst die Settings.
02 Gitea-Verbindung konfigurieren
+ +Alle Verbindungsdaten werden verschlüsselt (AES-256) lokal gespeichert. Öffne die Settings über + ⚙️ Settings in der Toolbar.
+ +-
+
- GitHub Token – Optional. Nur benötigt wenn du auch GitHub-Repos laden willst. Erstelle ihn unter github.com → Settings → Developer settings → Personal access tokens. +
- Gitea Token – Pflichtfeld. Erstelle unter Gitea → Einstellungen → Anwendungen → Token generieren. Berechtigungen:
repository,user,issue.
+ - Gitea URL – Die Basis-URL deines Servers (z. B.
https://git.example.com). IPv6 mit Klammern:http://[::1]:3000.
+ - Verbindung testen drücken — der Verbindungsstatus zeigt grüne Haken wenn alles stimmt. +
- Speichern — beim nächsten App-Start werden die Repos automatisch geladen. +
Wenn du ein Repository öffnest, wird der Projektname in der Gravy-Leiste (unter der Toolbar) angezeigt. + Beim Wechsel zurück zur Repository-Übersicht wird der Name automatisch ausgeblendet. + Das gilt für beide Navigationswege:
+-
+
- ⬅️ Zurück-Button klicken +
- 🌐 Load Gitea / 📂 Open Local klicken +
03 Repositories laden & filtern
+ +Klicke auf 🌐 Load Gitea um alle Repositories deines Tokens zu laden — inklusive privater Repos.
+ +Die Tabs über dem Repository-Grid sortieren nach Besitzer. Der aktive Tab wird hervorgehoben. Beim App-Start ist immer Meine vorausgewählt.
+| Tab | Beschreibung |
|---|---|
| Meine | Nur Repositories deren Owner-Login mit deinem Gitea-Konto übereinstimmt |
| Alle | Alle geladenen Repositories ohne Einschränkung |
| Gruppenname | Nur Repositories dieser Organisation / dieses Nutzers |
Das Suchfeld über dem Grid filtert in Echtzeit nach Name, Owner, Sprache und Topics. + Mehrere Wörter werden als AND-Verknüpfung behandelt.
+Beispiele:
+-
+
stream kotlin→ zeigt alle Kotlin-Repos mit "stream" im Namen
+ telegram javascript→ Telegram-Repos in JavaScript
+ privat→ Repos mit "privat" in Beschreibung oder Name
+
-
+
- ⭐ Stern-Button (oben rechts auf Karte) — Favorit hinzufügen/entfernen +
- 🔒 Privat-Badge — Repo ist als private markiert +
- Projekt-Bild — wird angezeigt wenn ein Repo-Avatar hinterlegt ist +
- Drag & Drop — Karte rausziehen zum Herunterladen; Datei reinklicken zum Hochladen +
04 Favoriten & Verlauf
+ +Die linke Seitenleiste zeigt deine Favoriten und deinen Verlauf als durchsuchbare Schnell-Navigation.
+ +Favoriten
+Klicke den Stern auf einer Karte oder im Rechtsklick-Menü. Favoriten bleiben auch nach App-Neustart erhalten. Reihenfolge per Drag & Drop anpassbar.
+Verlauf
+Jedes geöffnete Repository wird automatisch im Verlauf gespeichert (max. 20). Zeit seit dem letzten Öffnen wird als "vor X Minuten/Stunden" angezeigt.
+Rechtsklick in Sidebar
+Rechtsklick auf einen Sidebar-Eintrag öffnet ein Kontextmenü mit Öffnen, Favorit entfernen, Sichtbarkeit umschalten und Tags bearbeiten.
+Drag & Drop Sortierung
+Favoriten können per Drag & Drop innerhalb der Sidebar umsortiert werden. Die neue Reihenfolge wird automatisch gespeichert.
+05 Repository-Aktionen (Rechtsklick)
+ +Rechtsklick auf eine Repository-Karte öffnet ein vollständiges Kontextmenü mit allen Aktionen.
+ +| Aktion | Beschreibung |
|---|---|
| 📂 Öffnen | Wechselt in den Datei-Explorer des Repositories |
| 🌐 Im Browser öffnen | Öffnet das Repository auf der Gitea-Webseite |
| 📋 Clone-URL kopieren | Kopiert die HTTPS-Clone-URL in die Zwischenablage |
| ⭐ Favorit | Fügt zu Favoriten hinzu oder entfernt es |
| 🔒 Privat/Öffentlich | Schaltet Sichtbarkeit des Repos auf Gitea um — benötigt Token mit Schreibrecht |
| 🖼️ Projektbild | Lädt ein eigenes Logo/Bild für das Repository hoch (max. empfohlen 512 × 512 px) |
| 🏷️ Tags bearbeiten | Öffnet den Tag-Editor (s. unten) |
| 🗑️ Löschen | Löscht das Repository permanent auf Gitea — es erscheint eine Bestätigungsabfrage |
+ Tags helfen Repositories zu kategorisieren. Der Editor zeigt vorhandene Tags als Chips und + lädt automatisch alle bereits genutzten Topics von deiner Gitea-Instanz als Vorschläge. +
+-
+
- Rechtsklick auf Repo → 🏷️ Tags bearbeiten +
- Im Eingabefeld beginnen zu tippen — Vorschläge aus Gitea erscheinen automatisch +
- Vorschlag anklicken oder eigenen Tag mit Enter bestätigen +
- Bestehende Tags durch Klick auf ✕ entfernen +
- Speichern drücken +
-
+
- Rechtsklick auf Repo → 🖼️ Projektbild hochladen +
- Bilddatei auswählen (JPG, PNG, GIF — empfohlen quadratisch) +
- Das Bild wird sofort über die Gitea API hochgeladen +
- Nach Reload erscheint das Bild auf der Repository-Karte +
06 Datei-Explorer & Editor
+ +Klicke auf eine Repository-Karte um den Datei-Explorer zu öffnen. Hier navigierst du durch Ordner, + öffnest Dateien und bearbeitest Code direkt in der App.
+ +Ordner-Navigation
+Klick auf Ordner navigiert in die Tiefe. Der ⬅️ Zurück-Button erscheint automatisch in der Toolbar. Breadcrumb-Pfad oben sichtbar.
+Datei-Editor
+Klick auf eine Textdatei öffnet den integrierten Editor mit Syntax-Highlighting, Suchen & Ersetzen und Auto-Save-Funktion.
+Drag & Drop Upload
+Dateien oder Ordner aus dem Windows Explorer direkt in das Grid ziehen um sie hochzuladen. Fortschritt wird als Progressbar angezeigt.
+Download per Drag
+Eine Datei/Ordner-Karte aus dem Grid herausziehen lädt das Element auf den lokalen Rechner. Temporäre Dateien werden nach 20 s bereinigt.
+Umbenennen & Verschieben
+Rechtsklick auf eine Datei → Umbenennen. Ziel-Pfad eingeben um Dateien gleichzeitig zu verschieben.
+Löschen
+Einzelne Dateien oder ganze Ordner löschen. Der Explorer zeigt eine Bestätigungsabfrage als Toast inklusive Zähler der betroffenen Dateien.
++ 2
+ 3 A powerful Electron-based Git management GUI
+ 4 supported by **Gitea** and **GitHub** APIs. +
| Shortcut | Aktion |
|---|---|
| Ctrl+S | Datei speichern (pusht auf Gitea) |
| Ctrl+F | Suchleiste öffnen |
| Escape | Suche schließen |
07 Repository erstellen
+ +Klicke auf 🚀 New Repo in der Toolbar um ein neues Repository direkt auf Gitea anzulegen.
+ +-
+
- Repository-Name wählen (nur Buchstaben, Zahlen, Bindestriche — der Name wird live on the fly validiert). +
- Optionale Beschreibung eintragen und Branch-Name bestätigen. +
- Plattform: Gitea oder GitHub auswählen (je nach Aktiv-Auswahl in der Toolbar). +
- "Auto-init mit README" ist standardmäßig aktiv — dadurch hat das Repo sofort einen initialen Commit. +
- Erstellen drücken – bei Erfolg erscheint eine Erfolgsmeldung und die Repo-Liste wird aktualisiert. +
08 Migration (GitHub → Gitea)
+ +Klicke auf 📥 Migrieren um ein Repository vollständig von GitHub, GitLab oder einer + anderen Quelle auf deine Gitea-Instanz zu migrieren (inkl. Commit-History).
+ +-
+
- Quell-URL eingeben – unterstützt HTTPS und SSH-Clone-URLs von GitHub, GitLab, BitBucket und anderen Git-Diensten. +
- Repository-Name wird aus der URL automatisch vorausgefüllt (anpassbar). +
- Falls das Quell-Repo privat ist: Auth Username und Token des Quell-Dienstes eintragen. +
- "Privates Repository" anhaken wenn das migrierte Repo auf Gitea ebenfalls privat bleiben soll. +
- 📥 Migration starten drücken. Der Fortschritt wird als Status angezeigt. +
09 Batch-Aktionen
+ +Klicke auf 🧩 Batch um dieselbe Aktion gleichzeitig auf eine Liste von Repositories anzuwenden.
+ ++ M_Viper/git-manager-gui
+ W-Web/website +
| Aktion | Was passiert |
|---|---|
| 🔄 Aktualisieren | Lädt Metadaten aller eingetragenen Repos neu (kein Code-Push) |
| 📥 Klonen | Klont alle Repos in einen gewählten lokalen Zielordner |
| 🏷️ Tag erstellen | Erstellt auf allen angegebenen Repos denselben Git-Tag |
| 📦 Release erstellen | Legt auf allen Repos ein Release mit Tag, Name und Beschreibung an |
owner/repo eingetragen, eines pro Zeile. Beim Klonen wird auf doppelte Zielordner geprüft und gewarnt.
+ 10 Commit-History & Diffs
+ +Wenn du ein Repository geöffnet hast, erscheint in der Toolbar der Button 📊 Commits. + Klicke ihn um die vollständige Commit-History zu laden.
+ +Commit-Liste
+Zeigt Commits mit Message, Autor, Datum und verkürztem SHA. Branch-Selector oben wechselt den Branch.
+Commit-Suche
+Filtert die Commit-Liste nach Message oder Autor in Echtzeit ohne neue API-Anfrage.
+Diff-Ansicht
+Klick auf einen Commit zeigt das vollständige Diff (Added/Removed/Changed) aller betroffenen Dateien.
+Aktivitäts-Heatmap
+Zeigt deine Gitea-Commit-Aktivität der letzten 20 Monate als farbige Kacheln — ähnlich GitHub.
+11 Releases verwalten
+ +In der Repo-Ansicht erscheint der Button 📦 Releases. Damit öffnest du die Release-Verwaltung.
+ +| Funktion | Beschreibung |
|---|---|
| Release-Liste | Alle vorhandenen Releases mit Datum, Tag und Beschreibung |
| Release erstellen | Tag, Name, Beschreibung und Pre-Release-Flag wählbar |
| Release bearbeiten | Name und Beschreibung nachträglich anpassen |
| Release löschen | Release permanent entfernen (mit Bestätigung) |
| Asset hochladen | Binärdateien (z. B. .zip, .exe) an ein Release anhängen |
| Asset löschen | Einzelne Anhänge aus einem Release entfernen |
| Release-Archiv herunterladen | Den Quellcode-Snapshot als ZIP/TAR herunterladen |
12 Retry-Queue & Activity-Log
+ +Retry-Queue
+Fehlgeschlagene Schreiboperationen (z. B. Datei-Upload bei Netzwerkausfall) werden automatisch in die Queue eingereiht und alle 15 Sekunden erneut versucht. Die Queue-Größe steht im Toolbar-Button 🔁 Queue (0).
+Activity-Log
+Öffne über 📝 Activity das vollständige Protokoll aller App-Aktionen gefiltert nach Info/Warn/Fehler. Der Log kann komplett geleert werden.
+-
+
- Klicke auf 🔁 Queue (N) in der Toolbar um alle ausstehenden Aufgaben sofort zu verarbeiten. +
- Im Activity-Log siehst du das Ergebnis: X erfolgreich, Y verworfen. +
13 Einstellungen im Detail
+ +In den Settings kannst du ein Profilbild hinterlegen, das auf Gitea gesetzt wird.
+-
+
- In den Settings auf das Avatar-Kreisfeld klicken → Bild aus Datei wählen. +
- Das Bild wird lokal gespeichert und beim nächsten Speichern automatisch auf Gitea hochgeladen. +
- Alternativ: 📤 Auf Gitea aktualisieren sofort ohne Speichern auslösen. +
| Einstellung | Standard | Beschreibung |
|---|---|---|
| ⭐ Favoriten anzeigen | An | Zeigt/versteckt die Favoriten-Sidebar und Stern-Buttons |
| 🕐 Zuletzt geöffnet | An | Verlaufs-Sidebar ein-/ausblenden |
| ⊞ Kompakt-Modus | Aus | Verdichtete Darstellung für kleinere Bildschirme |
| 🎨 Farbige Datei-Icons | An | Unterschiedliche Farben je Dateityp im Explorer |
| 🚀 Mit Windows starten | Aus | App miniert im System-Tray beim Windows-Login starten |
Klicke auf 🔄 Nach Updates suchen in den Settings. Die App vergleicht die lokale Version + mit dem GitHub-Release-Server und lädt eine neue Version direkt herunter falls verfügbar.
+Tastenkürzel-Übersicht
+| Shortcut | Funktion |
|---|---|
| Ctrl+K | Fuzzy-Suche im Repository-Grid fokussieren |
| Ctrl+S | Aktive Datei im Editor speichern |
| Ctrl+F | Suchleiste im Editor öffnen |
| Escape | Suchleiste im Editor schließen |
| Rechtsklick | Kontextmenü auf Repository-Karte oder Sidebar-Eintrag |
| Drag raus | Datei/Ordner/Repo herunterladen |
| Drag rein | Datei/Ordner in aktuelles Verzeichnis hochladen |
Häufige Fehler & Lösungen
+| Fehlermeldung | Ursache | Lösung |
|---|---|---|
| "missing-token-or-url" | +Kein Token oder keine URL eingetragen | +Settings öffnen und Gitea Token + URL eintragen | +
| "401 Unauthorized" | +Token ungültig oder abgelaufen | +Neues Token auf Gitea generieren und in Settings eintragen | +
| "403 Forbidden" | +Token hat nicht die benötigten Rechte | +Token-Berechtigungen prüfen: repository, user sind Pflicht |
+
| "ECONNREFUSED" | +Gitea-Server nicht erreichbar | +URL prüfen; bei IPv6 eckige Klammern: http://[::1]:3000 |
+
| "Timeout" | +Netzwerkproblem oder Server überlastet | +Netzwerkverbindung prüfen; ggf. VPN deaktivieren | +
| Repo erscheint nicht | +Owner-Tab auf "Meine" filtert fremde Repos raus | +"Alle" Tab wählen oder nach Name suchen | +
| Bilder werden nicht geladen | +Gitea CORS-Policy oder ungültige Avatar-URL | +Gitea-Server-Einstellungen prüfen; Repo-Avatar neu hochladen | +
Gitea-Token einrichten (Schritt für Schritt)
+-
+
- Anmelden auf deiner Gitea-Instanz. +
- Rechts oben Avatar-Icon → Einstellungen. +
- Links in der Navigation: Anwendungen. +
- Unter "Token generieren" einen Namen eingeben (z. B. "Git Manager GUI"). +
- Berechtigungen aktivieren:
Repositories (Read & Write),User (Read),Issue (optional).
+ - Token generieren und sofort kopieren — er wird nur einmal angezeigt! +
- Token in die Settings der App unter Gitea Token einfügen. +