-
-
-Git Manager Explorer Pro – Benutzerhandbuch
-
-
-
-
-
-
-
🛠
-
Git Manager Explorer Pro
-
Vollständiges Benutzerhandbuch · Version 2.1.3
-
-
-
Version2.1.3
-
PlattformWindows (Electron)
-
ErstellerM_Viper
-
StandMai 2026
-
-
-
-
01
Erste Schritte & Einrichtung
-
02
Gitea-Verbindung konfigurieren
-
03
Repositories laden & filtern
-
04
Favoriten & Verlauf
-
05
Repository-Aktionen (Rechtsklick)
-
06
Datei-Explorer & Editor
-
07
Repository erstellen
-
08
Migration (GitHub → Gitea)
-
09
Batch-Aktionen
-
10
Commit-History & Diffs
-
11
Releases verwalten
-
12
Retry-Queue & Activity-Log
-
-
-
-
-
-
-
-
-
TEIL A
-
Einrichtung & erste Schritte
-
App starten, Gitea verbinden und mit der Übersicht vertraut machen.
-
-
-
-
-
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.
-
-
-
-
-
-
-
- Git Manager Explorer Pro — Hauptfenster
-
-
-
- 🛠 Git Manager Explorer Pro
-
-
🚀 New Repo
-
📥 Migrieren
-
⬆️ Push
-
⚙️ Settings
-
🧩 Batch
-
-
-
📂 Open Local
-
🌐 Load Gitea
-
Gitea ●
-
GitHub
-
-
-
Meine 8
-
Alle 24
-
W-Web 12
-
rusher2510 4
-
-
🔍 Fuzzy-Suche: Name, Owner, Sprache, Topics…
-
-
📦 git-manager-gui
JavaScript • 3,2 MB
-
📦 streamflixPrivat
Kotlin • 8,1 MB
-
📦 yt-coockie-adblock
JavaScript • 0,4 MB
-
-
-
-
-
-
🖥 Systemvoraussetzungen
-
-
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.
-
-
-
-
-
-
- ⚙️ Einstellungen — Zugangsdaten
-
-
-
-
-
-
-
ghp_••••••••••••••••
-
-
-
-
••••••••••••••••••
-
-
-
-
https://git.example.com
-
-
-
🔌 Verbindung testen
-
-
-
-
-
Verbindungsstatus
-
-
URLGültig
-
APIErreichbar
-
AuthOK
-
Latenz32 ms
-
Server1.22.0
-
-
-
-
-
-
-
-
-
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 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.
-
-
-
- Auto-Login: Sind Credentials gespeichert wird beim Start automatisch Load Gitea ausgeführt. Die letzten Projekte erscheinen sofort ohne manuellen Klick.
-
-
-
-
🎯 Projektname in der Übersicht
-
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
-
-
- ✓ Projektname wird immer korrekt synchronisiert und verschwindet in der Übersicht.
-
-
-
-
-
-
-
TEIL B
-
Repository-Übersicht
-
Repositories laden, filtern, suchen und mit Tabs nach Besitzern sortieren.
-
-
-
-
-
03 Repositories laden & filtern
-
-
Klicke auf 🌐 Load Gitea um alle Repositories deines Tokens zu laden — inklusive privater Repos.
-
-
-
📂 Owner-Tabs
-
Die Tabs über dem Repository-Grid sortieren nach Besitzer. Der aktive Tab wird hervorgehoben. Beim App-Start ist immer Meine vorausgewählt.
-
-
-
-
Meine 8
-
Alle 24
-
W-Web 12
-
rusher2510 4
-
-
- → Klick auf "Alle" zeigt sämtliche geladenen Repositories unabhängig vom Besitzer.
-
-
-
-
-
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
-
-
-
-
-
🔍 Fuzzy-Suche TIPP
-
Das Suchfeld über dem Grid filtert in Echtzeit nach Name, Owner, Sprache und Topics.
- Mehrere Wörter werden als AND-Verknüpfung behandelt.
-
- Shortcut: Ctrl + K fokussiert das Suchfeld von überall in der Repository-Ansicht.
-
-
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
-
-
-
-
-
📋 Repository-Karte
-
-
-
-
-
- ⭐
-
📦 streamflixPrivat
-
Kotlin • 8,1 MB
-
- android · kotlin · leanback · streaming
-
-
-
-
-
📦 git-manager-gui
-
JavaScript • 3,2 MB
-
-
-
📦 tg-group-moderation
-
kein Sprachmarker
-
-
-
-
-
-
⭐ 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 & Verlauf — Sidebar
-
-
-
-
-
-
⭐ Favoriten (3)
-
🕐 Verlauf (8)
-
-
streamflix
rusher2510
-
git-manager-gui
M_Viper
-
awesome-german-piracy
rusher2510
-
-
-
-
📦 git-manager-gui
JavaScript
-
📦 streamflix
Kotlin
-
-
-
-
-
-
-
-
-
⭐
-
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.
-
-
-
-
- Sidebar ein-/ausblenden: Du kannst Favoriten und Verlauf einzeln in den Settings (Darstellung) deaktivieren.
-
-
-
-
-
-
TEIL C
-
Repository-Aktionen
-
Kontextmenü, Datei-Explorer, Editor und alle Repo-Verwaltungsfunktionen.
-
-
-
-
-
05 Repository-Aktionen (Rechtsklick)
-
-
Rechtsklick auf eine Repository-Karte öffnet ein vollständiges Kontextmenü mit allen Aktionen.
-
-
-
-
-
Kontextmenü — Repository
-
-
📂 Öffnen
-
🌐 Im Browser öffnen
-
📋 Clone-URL kopieren
-
⭐ Zu Favoriten hinzufügen
-
🔒 Auf Privat schalten
-
🖼️ Projektbild hochladen
-
🏷️ Tags bearbeiten
-
🗑️ Löschen
-
-
-
-
Kontextmenü — Favorit/Verlauf
-
-
📂 Öffnen
-
⭐ Aus Favoriten entfernen
-
🔒 Auf Privat schalten
-
🏷️ Tags bearbeiten
-
🗑️ Aus Verlauf entfernen
-
-
-
-
-
-
-
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 (Topics) bearbeiten
-
- 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
-
-
- Tags müssen Gitea-kompatibel sein: nur Kleinbuchstaben, Zahlen und Bindestriche. Leerzeichen werden automatisch durch Bindestriche ersetzt.
-
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.
-
-
-
-
-
✏️ Editor-Funktionen
-
-
-
-
-
- Editor — README.md
-
-
-
-
🔍 Suchen (Ctrl+F)
-
💾 Speichern
-
✕ Schließen
-
- README.md · Zeile 12
-
-
- 1# Git Manager Explorer Pro
- 2
- 3A 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
-
-
- Mehrere Tabs: Der Editor unterstützt mehrere geöffnete Dateien gleichzeitig. Ungespeicherte Dateien werden mit einem Punkt im Tab-Namen markiert.
-
-
-
-
-
-
-
TEIL D
-
Repository-Verwaltung
-
Erstellen, migrieren, pushen und Batch-Aktionen auf vielen Repos gleichzeitig.
-
-
-
-
-
07 Repository erstellen
-
-
Klicke auf 🚀 New Repo in der Toolbar um ein neues Repository direkt auf Gitea anzulegen.
-
-
-
-
-
-
- 🚀 Neues Repository erstellen
-
-
-
-
-
-
-
mein-neues-projekt
-
-
-
-
main
-
-
-
-
Optionale Beschreibung…
-
-
-
-
-
-
-
Gitea ✓
-
GitHub
-
-
-
-
✓
- Auto-init mit README.md
-
-
-
- Privates Repository
-
-
-
-
-
Erstellen
-
Abbrechen
-
-
-
-
-
-
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.
-
-
-
- Repository-Namen müssen eindeutig sein. Der Validator prüft direkt gegen Gitea und meldet Konflikte schon während der Eingabe.
-
-
-
-
-
-
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).
-
-
-
-
-
-
- 📥 Repository migrieren
-
-
-
-
-
https://github.com/benutzer/mein-repo.git
-
-
-
-
-
mein-repo
-
-
-
-
Migriertes Repo von GitHub
-
-
-
-
github-username
-
-
-
-
ghp_••••••••
-
-
-
- ✅ "mein-repo" wurde erfolgreich migriert!
-
-
-
-
-
-
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.
-
-
-
- Gitea klont das Repo inklusive aller Branches, Tags und Commit-Historie direkt auf dem Server.
- Die Migration kann je nach Repo-Größe einige Sekunden bis Minuten dauern.
-
-
-
-
-
-
09 Batch-Aktionen
-
-
Klicke auf 🧩 Batch um dieselbe Aktion gleichzeitig auf eine Liste von Repositories anzuwenden.
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
-
-
-
- Repos werden im Format owner/repo eingetragen, eines pro Zeile. Beim Klonen wird auf doppelte Zielordner geprüft und gewarnt.
-
-
-
-
-
-
TEIL E
-
Commits, Releases & Protokoll
-
Commit-History einsehen, Releases verwalten und die Activity-Log nutzen.
-
-
-
-
-
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.
-
-
-
-
- Lokale Commits: Auch für lokal geöffnete Ordner (Open Local) kann die Commit-History des lokalen Git-Repos angezeigt werden.
-
-
-
-
-
-
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.
-
-
-
-
- Retry-Limit: Nach 8 erfolglosen Versuchen wird ein Queue-Eintrag verworfen und als Fehler im Activity-Log eingetragen. Dann bitte Verbindung und Token prüfen.
-
-
-
-
🔁 Queue manuell verarbeiten
-
-
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.
-
-
-
-
-
-
-
TEIL F
-
Einstellungen & System
-
Alle Settings, Profilbild, Darstellung und Auto-Update.
-
-
-
-
13 Einstellungen im Detail
-
-
-
👤 Profilbild / Avatar
-
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
-
-
-
-
🔄 App-Update
-
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.
-
- Die App prüft beim Start automatisch auf Updates im Hintergrund und meldet sich ohne Unterbrechung.
-
-
-
-
-
-
-
ANHANG
-
Referenz & Problemlösung
-
Shortcuts, häufige Fehler und Token-Einrichtung auf einen Blick.
-
-
-
-
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.
App starten, Gitea verbinden und mit der Übersicht vertraut machen.
+
+
+
+
+
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.
+
+
+
+
+
+
+
+ Git Manager Explorer Pro — Hauptfenster
+
+
+
+ 🛠 Git Manager Explorer Pro
+
+
🚀 New Repo
+
📥 Migrieren
+
⬆️ Push
+
⚙️ Settings
+
🧩 Batch
+
+
+
📂 Open Local
+
🌐 Load Gitea
+
Gitea ●
+
GitHub
+
+
+
Meine 8
+
Alle 24
+
W-Web 12
+
rusher2510 4
+
+
🔍 Fuzzy-Suche: Name, Owner, Sprache, Topics…
+
+
📦 git-manager-gui
JavaScript • 3,2 MB
+
📦 streamflixPrivat
Kotlin • 8,1 MB
+
📦 yt-coockie-adblock
JavaScript • 0,4 MB
+
+
+
+
+
+
🖥 Systemvoraussetzungen
+
+
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.
+
+
+
+
+
+
+ ⚙️ Einstellungen — Zugangsdaten
+
+
+
+
+
+
+
ghp_••••••••••••••••
+
+
+
+
••••••••••••••••••
+
+
+
+
https://git.example.com
+
+
+
🔌 Verbindung testen
+
+
+
+
+
Verbindungsstatus
+
+
URLGültig
+
APIErreichbar
+
AuthOK
+
Latenz32 ms
+
Server1.22.0
+
+
+
+
+
+
+
+
+
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 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.
+
+
+
+ Auto-Login: Sind Credentials gespeichert wird beim Start automatisch Load Gitea ausgeführt. Die letzten Projekte erscheinen sofort ohne manuellen Klick.
+
+
+
+
🎯 Projektname in der Übersicht
+
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
+
+
+ ✓ Projektname wird immer korrekt synchronisiert und verschwindet in der Übersicht.
+
+
+
+
+
+
+
TEIL B
+
Repository-Übersicht
+
Repositories laden, filtern, suchen und mit Tabs nach Besitzern sortieren.
+
+
+
+
+
03 Repositories laden & filtern
+
+
Klicke auf 🌐 Load Gitea um alle Repositories deines Tokens zu laden — inklusive privater Repos.
+
+
+
📂 Owner-Tabs
+
Die Tabs über dem Repository-Grid sortieren nach Besitzer. Der aktive Tab wird hervorgehoben. Beim App-Start ist immer Meine vorausgewählt.
+
+
+
+
Meine 8
+
Alle 24
+
W-Web 12
+
rusher2510 4
+
+
+ → Klick auf "Alle" zeigt sämtliche geladenen Repositories unabhängig vom Besitzer.
+
+
+
+
+
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
+
+
+
+
+
🔍 Fuzzy-Suche TIPP
+
Das Suchfeld über dem Grid filtert in Echtzeit nach Name, Owner, Sprache und Topics.
+ Mehrere Wörter werden als AND-Verknüpfung behandelt.
+
+ Shortcut: Ctrl + K fokussiert das Suchfeld von überall in der Repository-Ansicht.
+
+
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
+
+
+
+
+
📋 Repository-Karte
+
+
+
+
+
+ ⭐
+
📦 streamflixPrivat
+
Kotlin • 8,1 MB
+
+ android · kotlin · leanback · streaming
+
+
+
+
+
📦 git-manager-gui
+
JavaScript • 3,2 MB
+
+
+
📦 tg-group-moderation
+
kein Sprachmarker
+
+
+
+
+
+
⭐ 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 & Verlauf — Sidebar
+
+
+
+
+
+
⭐ Favoriten (3)
+
🕐 Verlauf (8)
+
+
streamflix
rusher2510
+
git-manager-gui
M_Viper
+
awesome-german-piracy
rusher2510
+
+
+
+
📦 git-manager-gui
JavaScript
+
📦 streamflix
Kotlin
+
+
+
+
+
+
+
+
+
⭐
+
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.
+
+
+
+
+ Sidebar ein-/ausblenden: Du kannst Favoriten und Verlauf einzeln in den Settings (Darstellung) deaktivieren.
+
+
+
+
+
+
TEIL C
+
Repository-Aktionen
+
Kontextmenü, Datei-Explorer, Editor und alle Repo-Verwaltungsfunktionen.
+
+
+
+
+
05 Repository-Aktionen (Rechtsklick)
+
+
Rechtsklick auf eine Repository-Karte öffnet ein vollständiges Kontextmenü mit allen Aktionen.
+
+
+
+
+
Kontextmenü — Repository
+
+
📂 Öffnen
+
🌐 Im Browser öffnen
+
📋 Clone-URL kopieren
+
⭐ Zu Favoriten hinzufügen
+
🔒 Auf Privat schalten
+
🖼️ Projektbild hochladen
+
🏷️ Tags bearbeiten
+
🗑️ Löschen
+
+
+
+
Kontextmenü — Favorit/Verlauf
+
+
📂 Öffnen
+
⭐ Aus Favoriten entfernen
+
🔒 Auf Privat schalten
+
🏷️ Tags bearbeiten
+
🗑️ Aus Verlauf entfernen
+
+
+
+
+
+
+
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 (Topics) bearbeiten
+
+ 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
+
+
+ Tags müssen Gitea-kompatibel sein: nur Kleinbuchstaben, Zahlen und Bindestriche. Leerzeichen werden automatisch durch Bindestriche ersetzt.
+
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.
+
+
+
+
+
✏️ Editor-Funktionen
+
+
+
+
+
+ Editor — README.md
+
+
+
+
🔍 Suchen (Ctrl+F)
+
💾 Speichern
+
✕ Schließen
+
+ README.md · Zeile 12
+
+
+ 1# Git Manager Explorer Pro
+ 2
+ 3A 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
+
+
+ Mehrere Tabs: Der Editor unterstützt mehrere geöffnete Dateien gleichzeitig. Ungespeicherte Dateien werden mit einem Punkt im Tab-Namen markiert.
+
+
+
+
+
+
+
TEIL D
+
Repository-Verwaltung
+
Erstellen, migrieren, pushen und Batch-Aktionen auf vielen Repos gleichzeitig.
+
+
+
+
+
07 Repository erstellen
+
+
Klicke auf 🚀 New Repo in der Toolbar um ein neues Repository direkt auf Gitea anzulegen.
+
+
+
+
+
+
+ 🚀 Neues Repository erstellen
+
+
+
+
+
+
+
mein-neues-projekt
+
+
+
+
main
+
+
+
+
Optionale Beschreibung…
+
+
+
+
+
+
+
Gitea ✓
+
GitHub
+
+
+
+
✓
+ Auto-init mit README.md
+
+
+
+ Privates Repository
+
+
+
+
+
Erstellen
+
Abbrechen
+
+
+
+
+
+
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.
+
+
+
+ Repository-Namen müssen eindeutig sein. Der Validator prüft direkt gegen Gitea und meldet Konflikte schon während der Eingabe.
+
+
+
+
+
+
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).
+
+
+
+
+
+
+ 📥 Repository migrieren
+
+
+
+
+
https://github.com/benutzer/mein-repo.git
+
+
+
+
+
mein-repo
+
+
+
+
Migriertes Repo von GitHub
+
+
+
+
github-username
+
+
+
+
ghp_••••••••
+
+
+
+ ✅ "mein-repo" wurde erfolgreich migriert!
+
+
+
+
+
+
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.
+
+
+
+ Gitea klont das Repo inklusive aller Branches, Tags und Commit-Historie direkt auf dem Server.
+ Die Migration kann je nach Repo-Größe einige Sekunden bis Minuten dauern.
+
+
+
+
+
+
09 Batch-Aktionen
+
+
Klicke auf 🧩 Batch um dieselbe Aktion gleichzeitig auf eine Liste von Repositories anzuwenden.
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
+
+
+
+ Repos werden im Format owner/repo eingetragen, eines pro Zeile. Beim Klonen wird auf doppelte Zielordner geprüft und gewarnt.
+
+
+
+
+
+
TEIL E
+
Commits, Releases & Protokoll
+
Commit-History einsehen, Releases verwalten und die Activity-Log nutzen.
+
+
+
+
+
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.
+
+
+
+
+ Lokale Commits: Auch für lokal geöffnete Ordner (Open Local) kann die Commit-History des lokalen Git-Repos angezeigt werden.
+
+
+
+
+
+
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.
+
+
+
+
+ Retry-Limit: Nach 8 erfolglosen Versuchen wird ein Queue-Eintrag verworfen und als Fehler im Activity-Log eingetragen. Dann bitte Verbindung und Token prüfen.
+
+
+
+
🔁 Queue manuell verarbeiten
+
+
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.
+
+
+
+
+
+
+
TEIL F
+
Einstellungen & System
+
Alle Settings, Profilbild, Darstellung und Auto-Update.
+
+
+
+
13 Einstellungen im Detail
+
+
+
👤 Profilbild / Avatar
+
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
+
+
+
+
🔄 App-Update
+
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.
+
+ Die App prüft beim Start automatisch auf Updates im Hintergrund und meldet sich ohne Unterbrechung.
+
+
+
+
+
+
+
ANHANG
+
Referenz & Problemlösung
+
Shortcuts, häufige Fehler und Token-Einrichtung auf einen Blick.
+
+
+
+
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.