pyUpload (TKinter-Version)

⚠️ Projektstatus: Eingefroren – Nur noch Bugfixes

Diese Version von pyUpload wird nicht weiterentwickelt und erhält nur noch Fehlerbehebungen.
Die neue Version mit Flask-Backend wird bald verfügbar sein unter:

🔗 https://github.com/realAscot/pyUpload2

---

📑 Inhalt der Readme

• pyUpload (TKinter-Version)
  • ⚠️ Projektstatus: Eingefroren – Nur noch Bugfixes
  • 📑 Inhalt der Readme
  • pyUpload – Sicherer Datei-Upload-Server über HTTPS (lokal & offline)
  • 🛠 Features
  • 🚀 Schnellstart
    • ▶️ Für Windows
    • 🐧 Für Linux / macOS
  • 🧩 Kommandozeilenoptionen
  • 🌐 Zugriff im Browser
  • 📁 Logs & Uploads
  • 🔐 Hinweis zur SSL-Zertifikatswarnung
  • 💡 Ideen für zukünftige Entwicklungen
  • 🐛 Bekannte Bugs
  • 🤖 Autor und Beteiligte
  • ☕ Support
  • 📝 Lizenz

---

pyUpload – Sicherer Datei-Upload-Server über HTTPS (lokal & offline)

Diese Version basiert auf Tkinter (GUI + QR) sowie einer optionalen reinen CLI-Nutzung.
Sie ist vollständig lokal lauffähig – ganz ohne Installation von externen Tools oder komplexen Abhängigkeiten.

🔝

---

🛠 Features

• HTTPS-gesicherter Datei-Upload
• Selbstsigniertes SSL-Zertifikat bei Bedarf
• QR-Code-basierte Verbindung für Smartphones
• Client-spezifische Verzeichnisse und Logs
• GUI und Konsolen-Modus verfügbar
• automatische Einrichtung von .venv und Abhängigkeiten
• kein Installationsskript mehr nötig – alles passiert beim Start von main.py

🔝

---

🚀 Schnellstart

▶️ Für Windows

1. Lade das Projekt herunter oder klone es:

   
   git clone https://github.com/realAscot/pyUpload
   

   Alternativ einfach eine bereinigte .zip bei den Releases auf GitHub herrunterladen. Diese enthält kein .git-Archiv und nur das Allernötigste für den Betrieb des Programms.

2. Starte die App mit:

   start.cmd
   

   Alternativ in PowerShell:

   cmd /c start.cmd
   

   ⚠️ Alternative 2 falls die Ausführung per Doppelklick auf .bat oder .cmd gesperrt ist:

   Doppelklick auf start.pyw oder im Terminal mit:

   python start.pyw`
   

   Es ist möglich, dass beim ersten Mal gefragt wird, womit das Programm gestartet werden soll. Einfach die Python-Installation suchen und python.exe wählen.

   Ich empfehle, eine Verknüpfung der start.pyw z. B. auf dem Desktop zu erstellen

🐧 Für Linux / macOS

1. Stelle sicher, dass Python 3.8+ installiert ist:

   python3 --version
   

   Stelle sicher, dass die nötigen Systempakete vorhanden sind:

   sudo apt install python3-venv python3-tk
   

   Bei neueren Systemen mit z. B. Python 3.12:

   sudo apt install python3.12-venv python3.12-tk
   

   Dies trifft nicht bei allen Systemen zu, bei Ubuntu z.B muss TKinter händisch leider nachinstalliert werden.

2. Mache das Startscript ausführbar:

   chmod +x start.sh
   

3. Starte die App:

   ./start.sh
   

---

Beim ersten Start wird automatisch:

• eine virtuelle Umgebung .venv/ im app/-Verzeichnis erzeugt
• requirements.txt installiert
• das Programm danach neu aus der Umgebung gestartet

🔝

---

🧩 Kommandozeilenoptionen

Du musst Dich im Verzeichnis ./app befinden:

python main.py -h oder --h  # Hilfe
python main.py --nogui      # Start ohne GUI / QR
python main.py --port 9999  # Custom-Port verwenden

oder für Verknüpfungen die start.pyw verwenden:

pythonw.exe start.pyw -h oder --h   # Hilfe
pythonw.exe start.pyw --nogui       # Start ohne GUI / QR
pythonw.exe start.pyw --port 9999   # Custom-Port verwenden

Wenn Du die Dateierweiterung .pyw mit pythonw.exe verknüpfst, klappt es auch ohne mit Doppelklick im Explorer :-)

🔝

---

🌐 Zugriff im Browser

Sobald gestartet:

https://<lokale-IP>:4443 (oder Port, der mit der option `--port` gestartet wurde)

Alternativ QR-Code scannen (GUI-Modus).
Dateien werden im upload/<Client-IP>/ gespeichert.

Wichtig dabei ist es darauf zu achten, das tatsächlich auch https verwendet wird, falls man die Adresse händisch eingibt statt mit QR-Code! Man könnte noch zusätzlich einen http-server in der App laufen lassen, der dann automatisch umleitet, aber wir möchten das Programm so klein wie möglich halten.

🔝

---

📁 Logs & Uploads

• Uploads: im Ordner upload/ nach Client-IP
• Zentrale Logs: logs/pyupload.log
• Pro-Client Logs: logs/<Client-IP>.log

🔝

---

🔐 Hinweis zur SSL-Zertifikatswarnung

⚠️ Beim ersten Aufruf im Browser erscheint möglicherweise eine Warnung wegen eines selbstsignierten SSL-Zertifikats. Das ist normal.

• Über „Erweitert“ > „Trotzdem fortfahren“ den Zugriff manuell freigeben
• Eigene Zertifikate in den Dateien cert.pem und key.pem hinterlegen

Damit dein Browser diese Warnung dauerhaft vermeidet, müssen die Zertifikate zu deiner verwendeten Domain passen. Da das in lokalen oder testnahen Umgebungen in der Regel nicht der Fall ist, lässt sich diese Warnung meist nicht vermeiden.

Wichtig zu wissen:
Die Verbindung ist trotzdem Ende-zu-Ende verschlüsselt. Die Schlüssel werden bei jedem Start lokal neu generiert – direkt auf deinem Rechner. Technisch ist die Verbindung also sicher. Dein Browser vertraut dem Zertifikat lediglich nicht, weil es nicht von einer offiziellen Zertifizierungsstelle stammt, sondern lokal erzeugt wurde.

TKinter unter Linux:

Hinweis für Linux-Benutzer:
Falls die GUI nicht erscheint und stattdessen eine Warnung, wie ModuleNotFoundError: No module named 'tkinter', liegt das daran, dass tkinter unter Linux separat installiert werden muss.
Siehe Abschnitt 🐧 Für Linux / macOS für Details.

🔝

---

💡 Ideen für zukünftige Entwicklungen

Hier sind einige Vorschläge für zukünftige Erweiterungen. Dies ist eine offene Liste von Ideen für zukünftige Features oder Verbesserungen. Beiträge willkommen!

• Link zum Server auf der GUI zum Testen klickbar.
• _____________________________________________________
• _____________________________________________________

🔝

---

🐛 Bekannte Bugs

• Frontend: wenn im Browser der Button Hochladen gewählt wird, OHNE das Dateien ausgewählt wurden, kommt es zu einem Error response - Error code: 400 im Browser. Lösungsansatz wäre den Button über JS zu sperren solange keine Datei ausgewählt ist. Lässt sich schnell im template erledigen.

Wenn jemand Lust und Zeit hat sich diesem anzunehmen, nur zu. Ich danke im Voraus!

🔝

---

🤖 Autor und Beteiligte

• Adam Skotarczak
  Kontakt: adam@skotarczak.net
  GitHub: realAscot

• Du?

🔝

---

☕ Support

Wenn dir dieses Projekt gefällt, kannst du mich hier unterstützen:
☕ paypal.me/AdamSkotarczak

---

📝 Lizenz

MIT LICENSE – frei verwendbar in eigenen Projekten bei Namensnennung.