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 Namentelegram javascript→ Telegram-Repos in JavaScriptprivat→ 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.