SourceForge-Uploadmanager Files

===========================================================================
             SOURCEFORGE SFTP AUTO-RESUME UPLOAD MANAGER (GUI)
===========================================================================

Dieses grafische Werkzeug wurde speziell entwickelt, um große Dateien 
(wie fertige Programmordner oder .7z/.zip-Archive) sicher und stabil auf 
die Download-Server (FRS) von SourceForge hochzuladen.

Das Programm verfügt über eine integrierte Abbruch-Absicherung: Bei 
Verbindungsverlusten (z. B. WLAN-Trennung) versucht der Manager alle 10 
Sekunden automatisch eine Wiederverbindung und setzt den Upload exakt an 
der abgebrochenen Stelle fort (Auto-Resume).


---------------------------------------------------------------------------
1. DATEISTRUKTUR & ANFORDERUNGEN
---------------------------------------------------------------------------
Der Upload-Manager besteht aus folgenden Dateien:
- upload_gui_manager.py (Die grafische Benutzeroberfläche)
- upload_logic.py       (Das mathematische Übertragungs- & Resume-System)

Vor dem ersten Start muss die benötigte SFTP-Bibliothek für Python 
installiert werden. Öffnen Sie Ihr Terminal im Ordner und tippen Sie:

pip install paramiko


---------------------------------------------------------------------------
2. WICHTIGER HINWEIS: SSH-AUTHENTIFIZIERUNG (FEHLERBEHEBUNG)
---------------------------------------------------------------------------
SourceForge blockiert aus Sicherheitsgründen automatisierte Passwort-Logins 
über Skripte und meldet den Fehler: ['publickey', 'keyboard-interactive'].

Um den Upload-Manager nutzen zu können, müssen Sie einmalig einen kostenlosen 
SSH-Schlüssel (Public Key) auf Ihrem PC generieren und bei SourceForge hinterlegen:

Schritt A: Schlüssel generieren
1. Öffnen Sie die normale Windows-Eingabeaufforderung (CMD) oder das Terminal.
2. Tippen Sie folgenden Befehl ein und drücken Sie Enter:
   ssh-keygen -t rsa -b 4096
3. Bestätigen Sie alle drei Folgefragen einfach mit Enter (kein Passwort vergeben).

Schritt B: Schlüssel bei SourceForge hinterlegen
1. Navigieren Sie auf Ihrem PC zu folgendem Ordner:
   C:\Users\<IhrBenutzername>\.ssh\
2. Öffnen Sie die Datei "id_rsa.pub" (WICHTIG: Die Datei mit der Endung .pub) 
   mit dem Windows-Editor (Notepad).
3. Kopieren Sie den gesamten Text (eine lange Zeile, die mit ssh-rsa beginnt).
4. Loggen Sie sich auf SourceForge.net ein.
5. Gehen Sie oben rechts auf Ihr Profilbild -> Account Settings -> SSH Keys.
6. Fügen Sie den kopierten Text in das Feld ein und klicken Sie auf "Add Key".

Hinweis: Es kann bis zu 5 Minuten dauern, bis SourceForge den Schlüssel aktiv schaltet.
Danach authentifiziert sich das Skript vollautomatisch und Sie müssen kein Passwort 
mehr in der GUI eintragen!


---------------------------------------------------------------------------
3. BEDIENUNGSANLEITUNG
---------------------------------------------------------------------------
1. Starten Sie das Programm mit dem Befehl:
   python upload_gui_manager.py

2. Tragen Sie Ihre SourceForge-Daten ein:
   - Username: Ihr Login-Name (WICHTIG: komplett kleinschreiben!)
   - Projekt-Kurzname: Der Unix-Name aus Ihrer SourceForge-URL 
     (z. B. "mein-gesichtsvergleich")
   - Passwort: Kann dank des SSH-Schlüssels komplett leer gelassen werden.

3. Wählen Sie Ihr Programm aus:
   - Button "Datei wählen": Lädt ein fertiges Archiv (.7z, .zip) direkt hoch.
   - Button "Ordner wählen": Wählen Sie den unkomprimierten Programmordner. 
     Das Skript packt diesen im Hintergrund automatisch zu einer kompakten 
     ZIP-Datei und löscht das temporäre Archiv nach erfolgreichem Upload wieder.

4. Klicken Sie auf "Upload starten".
   Das Log-Fenster zeigt Ihnen live den Status und die Verbindungsversuche an. 
   Bei einem Netzwerkfehler müssen Sie nichts tun – das Programm pausiert und 
   setzt den Upload selbstständig fort, sobald das Internet wieder da ist.
===========================================================================