🚀 TheGeekFreaks Ingest-Tool

Ein modernes und effizientes Dateimanagement-Tool für professionelle Dateiübertragungen zwischen Laufwerken.

Optimiert für Fotografen, Videografen und Content Creator.

📑 Inhaltsverzeichnis

• ✨ Hauptfunktionen
• 🎯 Anwendungsfälle
• 💻 Installation
• 🛠️ Konfiguration
• 🎮 Bedienung
• ⚡ Performance
• 🗺️ Roadmap
• 🔧 Fehlerbehebung
• 📄 Lizenz

⭐ Highlights

Intelligentes Mapping

Echtzeit-Monitoring

Schnelle Transfers

✨ Hauptfunktionen

📁 Moderne Benutzeroberfläche

• Drag & Drop Support: Einfaches Ziehen und Ablegen von Dateien
• Dark/Light Mode: Augenschonende Themes für Tag und Nacht
• Responsive Design: Dynamische Anpassung an Fenstergrößen
• Intuitive Bedienung: Klare und übersichtliche Benutzerführung
• Multi-Monitor Support: Optimiert für mehrere Bildschirme
• Customizable Layout: Anpassbare Arbeitsbereiche
• Schnellzugriff-Leiste: Häufig genutzte Funktionen direkt erreichbar
• Kontextmenüs: Rechtskick-Optionen für schnelle Aktionen

🔄 Intelligentes Dateimanagement

• Automatische Laufwerkserkennung: Sofortige Erkennung von:
  • USB-Sticks und externe Festplatten
  • SD-Karten und Speichermedien
  • Netzwerklaufwerke (SMB/NFS)
  • Cloud-Speicher Integration
• Smart-Sorting: Automatische Sortierung nach:
  • Dateityp und -format
  • Aufnahmedatum (EXIF)
  • Projektstruktur
  • Benutzerdefinierten Regeln
• Echtzeit-Überwachung:
  • Live-Vorschau der Dateien
  • Automatische Verarbeitung
  • Änderungserkennung
  • Fehlerbenachrichtigungen
• Duplikaterkennung:
  • MD5/SHA Prüfsummen
  • Intelligente Namensgebung
  • Versionskontrolle
  • Konfliktlösung

🚀 Leistungsstarke Übertragung

• Hochgeschwindigkeits-Transfer:
  • Parallele Übertragungen
  • Gepufferte Schreibvorgänge
  • Optimierte Chunk-Größen
  • SSD-optimierte Transfers
• Sicherheitsfunktionen:
  • Automatische Backups
  • Checksummen-Verifikation
  • Wiederaufnahme nach Abbruch
  • Verschlüsselte Übertragung
• Fortschrittsüberwachung:
  • Detaillierte Statistiken
  • Geschwindigkeitsanzeige
  • Restzeit-Berechnung
  • Transfer-Logs

🛠️ Profi-Werkzeuge

• Batch-Verarbeitung:
  • Massenumbenennungen
  • Metadaten-Bearbeitung
  • Format-Konvertierung
  • Filter und Sortierung
• Workflow-Automation:
  • Benutzerdefinierte Regeln
  • Zeitgesteuerte Aufgaben
  • Event-basierte Aktionen
• Datei-Analyse:
  • EXIF-Daten Auswertung
  • Dateityp-Erkennung
  • Größenanalyse
  • Integritätsprüfung
• Reporting:
  • Transfer-Berichte
  • Fehlerprotokolle
  • Nutzungsstatistiken
  • Export-Funktionen

⚡ Performance

Optimierte Dateiübertragung

• Parallele Verarbeitung für große Dateimengen
• Intelligentes Chunk-Management
• Fortgeschrittene Fehlerbehandlung
• Automatische Wiederaufnahme bei Unterbrechungen

Ressourcennutzung

• Dynamische Speicherverwaltung
• Effiziente CPU-Nutzung
• Optimierte I/O-Operationen

Operation	Geschwindigkeit
Kopieren (SSD → SSD)	~500 MB/s
Kopieren (HDD → SSD)	~120 MB/s
Kopieren (NVMe → NVMe)	~2000 MB/s
Dateianalyse	~10.000 Dateien/s

🚀 Installation

Windows Installer

⬇️ Neueste Version herunterladen

Manuelle Installation

# Repository klonen
git clone https://github.com/The-Geek-Freaks/Ingest-Tool.git

# Ins Verzeichnis wechseln
cd Ingest-Tool

# Abhängigkeiten installieren
pip install -r requirements.txt

5. Anwendung starten:

   python ingest_tool.py

Development Setup

Für Entwickler empfehlen wir zusätzlich:

pip install -r requirements-dev.txt

Dies installiert:

• pytest für Unit Tests
• black für Code-Formatierung
• mypy für statische Typ-Überprüfung

🛠️ Konfiguration

Umgebungsvariablen

Erstellen Sie eine .env Datei im Root-Verzeichnis:

DEBUG=False
LOG_LEVEL=INFO
THEME=dark

Logging

Logs werden standardmäßig in ./logs gespeichert. Das Log-Level kann in der .env Datei konfiguriert werden.

🔧 Fehlerbehebung

Bekannte Probleme

• UI kann bei sehr großen Dateimengen (>100GB) verzögert reagieren
• Netzwerkverbindungen können bei instabiler Verbindung neu aufgebaut werden müssen

Debugging

1. Debug-Modus aktivieren in .env:

   DEBUG=True
   LOG_LEVEL=DEBUG

2. Log-Dateien prüfen unter ./logs
3. Bei Bedarf Issue auf GitHub erstellen

🗺️ Roadmap

• Basis-Funktionalität
• Drag & Drop Support
• Intelligente Dateizuordnung
• Fortschrittsanzeige
• Profi-Funktionen
  • Erweiterte Filteroptionen
  • Backup-Strategien
  • Automatisierte Workflows
• Crossplattform
  • Linux Support
  • macOS Support
• Rechtsklickintegration
• API für Entwickler

👥 Community

• 🤝 Wie du beitragen kannst
• 💬 Community-Richtlinien
• 🌟 Hall of Fame

🔧 Fehlerbehebung

Bekannte Probleme

• Submenü funktionslos: Einige Submenüpunkte noch nicht implementiert
• Themewahl: Themeauswahl noch nicht implementiert
• Sprachwahl: Sprachwahl noch nicht funktionsfähig

Support

• GitHub Issues: Bug-Reports und Feature-Requests
• E-Mail: support@thegeekfreaks.de
• Discord: TheGeekFreaks Community

Logs

• Programm-Logs: logs/ingest.log
• Error-Logs: logs/error.log
• Transfer-Logs: logs/transfer.log

📄 Lizenz

Dieses Projekt ist unter der GNU General Public License v3.0 (GPLv3) lizenziert - siehe LICENSE für Details.

Diese Lizenz garantiert Ihnen folgende Freiheiten:

• Die Software für jeden Zweck auszuführen
• Die Software zu studieren und zu modifizieren
• Kopien der Software weiterzugeben
• Modifizierte Versionen der Software zu verbreiten

Unter der Bedingung, dass:

• Der Quellcode aller abgeleiteten Werke unter der GPLv3 veröffentlicht wird
• Alle Änderungen dokumentiert werden
• Die vollständige Lizenz und Copyright-Hinweise beibehalten werden

Für die vollständige Lizenz siehe: GNU GPLv3

📝 Changelog

Eine detaillierte Liste aller Änderungen finden Sie in der CHANGELOG.md Datei.

---

Entwickelt mit ❤️ von TheGeekFreaks

Copyright © 2025 TheGeekFreaks. Alle Rechte vorbehalten.