ByteSquirrel🐿️

Ein schlankes Tool zum Aufspüren von Speicherfressern

ByteSquirrel🐿️ durchsucht Verzeichnisse blitzschnell und findet die größten Dateien und Ordner – perfekt für Festplatten-Cleanups und Speicheranalysen.

✨ Features

• 🔍 Schnelles Scannen – Durchläuft auch große Verzeichnisbäume effizient
• 📊 Visuelle Darstellung – Balkendiagramme zeigen Speicheranteile auf einen Blick
• 🌳 Baumansicht – Hierarchische Darstellung der Verzeichnisstruktur
• 🖱️ Kontextmenü – Dateien direkt im Explorer öffnen, Eigenschaften anzeigen oder löschen
• 📈 Live-Updates – Echtzeit-Fortschrittsanzeige während des Scans
• 💾 Netzlaufwerke – Unterstützt lokale und gemountete Netzwerkpfade
• 🎯 Zwei Modi – Grafische Oberfläche (GUI) oder Kommandozeile (CLI)
• 🚫 Scan abbrechen – Jederzeit stoppbar mit Teilergebnissen

🚀 Installation

Voraussetzungen

• Python 3.7 oder höher
• Tkinter (für GUI-Modus, meist vorinstalliert)

Setup

# Repository klonen
git clone https://github.com/nightbert/bytesquirrel.git
cd bytesquirrel

# Direkt ausführen (keine zusätzlichen Abhängigkeiten erforderlich)
python bytesquirrel.py --gui

💻 Verwendung

GUI-Modus (empfohlen)

# GUI starten
python bytesquirrel.py --gui

# Oder mit vorausgewähltem Pfad
python bytesquirrel.py /pfad/zum/verzeichnis --gui

GUI-Funktionen:

• Pfad auswählen: Mit "Durchsuchen" oder direkt eingeben
• Top N: Anzahl der größten Einträge festlegen
• Scannen: Analyse starten
• Rechtsklick: Kontextmenü für Dateien/Ordner
  • Im Explorer anzeigen
  • Eigenschaften
  • Löschen (mit Bestätigung)

CLI-Modus

# Aktuelles Verzeichnis scannen (Top 20)
python bytesquirrel.py

# Bestimmtes Verzeichnis scannen
python bytesquirrel.py /pfad/zum/verzeichnis

# Anzahl der größten Einträge anpassen
python bytesquirrel.py /pfad/zum/verzeichnis --top 50

# Windows: UNC-Pfade werden unterstützt
python bytesquirrel.py \\server\share --top 30

📋 Beispielausgabe

Scanne: /home/user/Dokumente

Größte Dateien (Top 20):
  1.    4.25 GB  /home/user/Dokumente/videos/urlaub.mp4
  2.    2.18 GB  /home/user/Dokumente/backup.tar.gz
  3.  856.32 MB  /home/user/Dokumente/projekt.zip
  ...

Größte Verzeichnisse (inkl. Unterordner) (Top 20):
  1.   12.45 GB  /home/user/Dokumente/videos
  2.    8.92 GB  /home/user/Dokumente/projekte
  3.    3.67 GB  /home/user/Dokumente/downloads
  ...

🎨 GUI-Übersicht

Die grafische Oberfläche bietet drei Ansichten:

1. Größte Dateien – Liste der speicherhungrigsten Einzeldateien
2. Größte Verzeichnisse – Ordner sortiert nach Gesamtgröße (inkl. Unterordner)
3. Baum (Verzeichnisse) – Hierarchische Baumstruktur mit Größenangaben

🛠️ Technische Details

• Sprache: Python 3
• GUI-Framework: Tkinter
• Performance: Bottom-up Tree-Walk für korrekte Verzeichnisgrößen
• Plattformen: Windows, macOS, Linux
• Speicher-effizient: Verwendet Heaps für Top-N-Tracking während des Scans

🐛 Bekannte Einschränkungen

• Symlinks werden standardmäßig nicht verfolgt (Schutz vor Endlosschleifen)
• Sehr große Verzeichnisbäume (>1M Dateien) können Speicher beanspruchen
• Windows: Admin-Rechte erforderlich für geschützte Systemordner