CleanSamples - Sample Video Cleanup Tool

Automatisches Tool zum Löschen von Sample-Videos in Verzeichnissen und Unterordnern.

📋 Überblick

Dieses Tool sucht rekursiv nach Video-Dateien, die "sample" im Dateinamen enthalten, und bietet die Möglichkeit, diese automatisch zu löschen. Ideal für das Aufräumen von Download-Verzeichnissen mit Serien, Filmen und anderen Video-Releases.

Unterstützte Video-Formate: .mp4, .avi, .mkv, .mov, .wmv, .flv, .m4v, .mpg, .mpeg, .webm, .ts

🚀 Features

• ✅ Rekursive Suche in allen Unterordnern
• ✅ Case-insensitive Erkennung ("sample", "Sample", "SAMPLE")
• ✅ Dry-Run Modus zum sicheren Testen
• ✅ Größenfilter (min/max MB)
• ✅ Farbige Ausgabe
• ✅ Bestätigungs-Prompt (optional deaktivierbar)
• ✅ Detaillierte Zusammenfassung
• ✅ Cross-platform (PowerShell + Python)

📦 Verfügbare Scripts

Script	Platform	Beschreibung
Delete-SampleVideos.ps1	Windows (PowerShell)	Empfohlen für Windows-Nutzer
delete_sample_videos.py	Cross-platform (Python 3)	Plattformunabhängig
delete_sample_videos.py2	Cross-platform (Python 2)	Legacy-Support für ältere Systeme

🔧 Installation

Windows (PowerShell)

# Keine Installation nötig - einfach ausführen
.\Delete-SampleVideos.ps1 --help

Linux/NAS (Python)

# Python 3
chmod +x delete_sample_videos.py
./delete_sample_videos.py --help

# Python 2 (Legacy)
chmod +x delete_sample_videos.py2
python delete_sample_videos.py2 --help

# Optional: Systemweit verfügbar machen
sudo ln -s $(pwd)/delete_sample_videos.py /usr/local/bin/clean-samples

📖 Verwendung

PowerShell

# Testlauf - zeigt nur, was gelöscht würde
.\Delete-SampleVideos.ps1 -DryRun

# Mit Bestätigung löschen
.\Delete-SampleVideos.ps1

# Ohne Bestätigung löschen
.\Delete-SampleVideos.ps1 -Force

# Bestimmtes Verzeichnis durchsuchen
.\Delete-SampleVideos.ps1 -Path "C:\Downloads\Complete"

Parameter:

• -Path: Pfad zum Durchsuchen (Standard: aktuelles Verzeichnis)
• -Force: Löscht ohne Bestätigung
• -DryRun: Zeigt nur an, welche Dateien gelöscht würden

Python

# Testlauf
python delete_sample_videos.py --dry-run

# Mit Bestätigung löschen
python delete_sample_videos.py

# Ohne Bestätigung löschen
python delete_sample_videos.py --force

# Bestimmtes Verzeichnis durchsuchen
python delete_sample_videos.py "/path/to/downloads"

# Nur Sample-Videos bis 100 MB löschen
python delete_sample_videos.py --max-size 100

# Sample-Videos zwischen 10 und 100 MB
python delete_sample_videos.py --min-size 10 --max-size 100

Parameter:

• path: Optionaler Pfad zum Durchsuchen (Standard: aktuelles Verzeichnis)
• --force: Löscht ohne Bestätigung
• --dry-run: Zeigt nur an, welche Dateien gelöscht würden
• --min-size MB: Minimale Dateigröße in MB
• --max-size MB: Maximale Dateigröße in MB

📊 Ausgabebeispiel

========================================
  Sample Video Löschtool
========================================

Durchsuche Verzeichnis: /downloads/complete
Suche nach Sample-Videos...

Gefundene Sample-Videos (3):
----------------------------------------
  ├─ sample-biohackers.mp4
  │  Pfad: /downloads/complete/Series.S01E01
  │  Größe: 45.23 MB
  │
  ├─ test_sample.mkv
  │  Pfad: /downloads/complete/Series.S02E03
  │  Größe: 38.91 MB
  │
  └─ quality-sample.avi
     Pfad: /downloads/complete/Movie.2021
     Größe: 52.18 MB

  Gesamt: 136.32 MB

Möchten Sie diese 3 Sample-Videos wirklich löschen? (J/N):

⚠️ Sicherheitshinweise

1. Erst testen: Verwende immer zuerst -DryRun (PowerShell) oder --dry-run (Python), um zu sehen, welche Dateien gelöscht würden.

2. Backup: Stelle sicher, dass du ein Backup hast, falls du versehentlich wichtige Dateien löschst.

3. Bestätigung: Ohne -Force / --force wirst du immer um Bestätigung gebeten.

4. Keine Wiederherstellung: Gelöschte Dateien landen nicht im Papierkorb und können nicht einfach wiederhergestellt werden!

🔍 Identifikationskriterien

Eine Datei wird als Sample-Video erkannt, wenn:

• Sie eine der unterstützten Video-Dateierweiterungen hat
• Der Dateiname "sample" enthält (case-insensitive)

Beispiele:

• ✅ sample.mp4
• ✅ Sample-Video.mkv
• ✅ movie-SAMPLE.avi
• ✅ test_sample_quality.mp4
• ❌ movie.mp4 (kein "sample" im Namen)

🛠️ Systemanforderungen

PowerShell Script

• Windows 10/11 oder Windows Server
• PowerShell 5.1 oder höher (PowerShell 7+ empfohlen)

Python Scripts

• Python 3: Python 3.6 oder höher
• Python 2: Python 2.7 (Legacy-Support)
• Keine externen Dependencies

🤝 Beitragen

Contributions sind willkommen! Bitte erstelle einen Pull Request oder öffne ein Issue.

📝 Lizenz

Dieses Projekt ist frei verwendbar. Keine Garantie für Schäden durch fehlerhafte Verwendung.

👤 Autor

Entwickelt für die effiziente Verwaltung von Video-Archiven und Download-Verzeichnissen.

---

⚠️ Wichtig: Dieses Tool löscht Dateien permanent. Verwende es mit Vorsicht und teste immer zuerst mit --dry-run / -DryRun!