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.
12a Uploads: Abbrechen, Wiederholen & Verlauf
Abbrechen
Während eines Uploads, Ordner-Downloads oder Batch-Clones erscheint im Fortschrittsbalken oben der Knopf Abbrechen (Esc). Du kannst auch einfach Esc drücken, solange kein Dialog offen ist.
Fortschritt
Der Balken zeigt Dateien, übertragene MB und eine geschätzte Restzeit, zum Beispiel Upload: 48/120 Dateien · 19,2 MB / 48,0 MB · noch ca. 5 Sek. Die Restzeit ist eine Hochrechnung und erscheint erst nach einigen Sekunden.
Nur Fehlgeschlagene wiederholen
Schlagen bei einem Upload einzelne Dateien fehl, fragt die App nach und sendet nur diese erneut (bis zu dreimal). Bereits hochgeladene Dateien bleiben unberührt.
Pausieren und Fortsetzen
Neben Abbrechen im Fortschrittsbalken gibt es Pausieren. Die Übertragung hält zwischen den Schritten an (ein laufender Clone, Push oder ein Paket wird noch fertig) und läuft mit Fortsetzen weiter. Das geht auch über das Tray-Menü.
Upload-Verlauf
Über 🕘 Verlauf in der Toolbar siehst du die letzten 100 Uploads mit Datum, Repo, Dateizahl, Dauer und Ergebnis. Filtere nach Erfolgreich, Abgebrochen oder Fehler und suche nach einem Repo-Namen. Ein Klick auf einen Eintrag öffnet das Repo, CSV exportieren speichert die gefilterte Liste für Excel.
Zugangsdaten-Sperre
Dateien wie credentials.json, .env, private Schlüssel oder Keystores werden auf allen Upload-Wegen ausgelassen, auch wenn du sie in der Vorschau nicht abgewählt hast. Die App meldet, welche Dateien fehlen. Vorlagen wie .env.example bleiben erlaubt. Unter Einstellungen → Uploads lässt sich die Sperre abschalten, bei öffentlichen Repos solltest du sie aktiv lassen.
Windows-Meldung
Endet ein Upload, während die App im Tray versteckt, minimiert oder nicht im Vordergrund ist, meldet Windows das Ergebnis. Ein Klick auf die Meldung öffnet die App. Abgebrochene Uploads melden nichts. Unter Einstellungen → Uploads lässt es sich abschalten.
Der Updater liest die Releases des Repos M_Viper/Git-Manager-Gui auf Gitea. So veröffentlichst du eine neue Version:
- Baue den Installer mit
npm run build. Dabei entstehenGit-Manager-GUI-Setup-X.Y.Z.exeund die Prüfsummen-Datei.sha256indist/. - Öffne in der Repo-Ansicht 🚀 Releases und lege ein neues Release an. Wähle bei Release Asset den Installer.
- Die App berechnet die SHA-256-Prüfsumme, gleicht sie mit der
.sha256-Datei ab und füllt Tag und Name aus dem Dateinamen vor. Stimmen die Prüfsummen nicht überein, wird nichts veröffentlicht. - Beim Erstellen prüft die App, dass der Tag eine Version wie
v2.2.1ist, es ihn noch nicht gibt und er neuer ist als das letzte Release, sonst würde der Updater ihn nicht anbieten. - Die Prüfsumme wird im Format, das der Updater liest, in den Release-Text geschrieben, und Installer und
.sha256werden hochgeladen.
- Öffne ein Repository und klicke in der Repo-Leiste auf 📄 .gitignore.
- Wähle die Vorlagen: Node.js, .NET, Electron, Python, Java, PHP, Unity. Der allgemeine Teil (Betriebssystem, Editor,
.env, Logs) ist immer dabei. - Mit Anlegen wird die Datei ins Repo geschrieben. Existiert schon eine, fragt die App vor dem Ersetzen nach.
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 |
| ✨ Startanimation | An | Beim Öffnen dreht sich das Logo, danach baut sich das Fenster von der Mitte aus auf. Beim Start mit Windows im Tray gibt es sie nie |
| 🚀 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 · laufenden Upload/Download abbrechen (wenn kein Dialog offen ist) |
| 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.