folder-flattening · diff
v1.0.0 to v1.0.0
52 added, 55 removed. Audit A to A.
---
name: folder-flattening
version: 1.0.0
type: tool
author: Lukas Geiger
created: 2026-03-12
updated: 2026-03-12
description: Restructure nested folder hierarchies into flat, machine-readable layouts. Bash-based with intelligent merge logic.
standalone: true
anthropic_compatible: true
bach_compatible: false
bach_origin: true
category: utilities
tags: [folder, flattening, filesystem, bash, reorganization, cleanup]
language: de
status: active
visibility: public
dependencies: {'tools': [], 'services': [], 'protocols': [], 'python': []}
provenance: {'origin': 'bach', 'origin_path': 'system/skills/workflows/ordner-flattening.md', 'origin_version': '1.0.0', 'origin_repo': 'github.com/ellmos-ai/bach', 'last_sync_from_origin': '2026-03-12', 'last_sync_to_origin': None, 'local_changes_since_sync': True}
---
-
<img src="banner.png" width="100%" alt="folder-flattening banner">
- > **Deutsch** — Offizielle Deutsch-Version / Documento Oficial en Deutsch.
-
-
- # Workflow: Folder Flattening (Deutsch)
+ # Workflow: Ordner-Flattening
- Goal: Convert nested folder structures into a flat, machine-readable structure.
- Advantage: No more clicking through directories — search via database (Verzeichnis.db) instead.
- Duplicates are allowed when thematically meaningful.
+ Ziel: Verschachtelte Ordnerstrukturen in eine flache, maschinenlesbare Struktur ueberfuehren.
+ Vorteil: Nicht mehr durchklicken, sondern per Datenbank (Verzeichnis.db) suchen.
+ Duplikate sind erlaubt wenn thematisch sinnvoll.
---
- ## Phase Overview
+ ## Uebersicht der Phasen
- | Phase | What Happens | Script Section |
- |-------|-------------|----------------|
- | 1 | Flatten: Pull all subfolders to one level | `phase_flatten` |
- | 2 | Shorten: Truncate long path names to last segment, merge on conflicts | `phase_shorten` |
- | 3 | Clean up: Resolve multiple underscores (`___`), remove trailing `_` | `phase_cleanup_underscores` |
- | 4 | Group: Number folders, CD folders, short names into collection folders | `phase_group_problematic` |
- | 5 | Triplet analysis: Sliding groups of 3, shortest name as merge target | `phase_tripel_merge` |
- | 6 | Media format merge: Consolidate folders by file type (template) | `phase_media_merge` |
- | 7 | Clean up: Delete empty folders | `phase_cleanup_empty` |
+ | Phase | Was passiert | Script-Abschnitt |
+ |-------|-------------|-----------------|
+ | 1 | Flatten: Alle Unterordner auf eine Ebene ziehen | `phase_flatten` |
+ | 2 | Kuerzen: Lange Pfad-Namen auf letztes Segment kuerzen, mergen bei Konflikten | `phase_shorten` |
+ | 3 | Bereinigen: Mehrfach-Unterstriche (`___`) aufloesen, trailing `_` entfernen | `phase_cleanup_underscores` |
+ | 4 | Gruppieren: Zahlen-Ordner, CD-Ordner, kurze Namen in Sammelordner | `phase_group_problematic` |
+ | 5 | Tripel-Analyse: Gleitende 3er-Gruppen, kuerzester Name als Merge-Ziel | `phase_tripel_merge` |
+ | 6 | Medienformat-Merge: Ordner nach Dateityp zusammenfassen (Template) | `phase_media_merge` |
+ | 7 | Aufraeumen: Leere Ordner loeschen | `phase_cleanup_empty` |
---
- ## Important Rules
+ ## Wichtige Regeln
- ### Triplet Analysis Matching
- - **Substring**: `Education` in `EducationalBrochures` -> merge into `Education`
- - **Plural/Umlaut**: `Room` = `Rooms`, `Part` = `Parts`, `Book` = `Books`
- - **First word**: `Autism ADHD` matches `Autism Career` (same beginning)
+ ### Tripel-Analyse Matching
+ - **Substring**: `Aufklaerung` in `Aufklaerungsbroschueren` -> merge in `Aufklaerung`
+ - **Plural/Umlaut**: `Raum` = `Raeume`, `Teil` = `Teile`, `Buch` = `Buecher`
+ - **Erstes-Wort**: `Autismus ADHS` matcht `Autismus Beruf` (gleicher Anfang)
- ### Minimum Length
- - Single-word name without spaces: **at least 8 characters** (prevents `Hand`, `House`, `Form`)
- - With spaces (e.g., `ICF Catalog`): **from 3 characters OK**
- - This keeps `ICF`, `ASD Women` etc. permitted
+ ### Mindestlaenge
+ - Einwort-Name ohne Leerzeichen: **mindestens 8 Zeichen** (verhindert `Hand`, `Haus`, `Form`)
+ - Mit Leerzeichen (z.B. `ICF Katalog`): **ab 3 Zeichen OK**
+ - Damit bleiben `ICF`, `ASS Frauen` etc. erlaubt
- ### Restart After Merge
- After each merge, the folder list is reloaded and restarted at the merge target.
- This way, e.g., `Autism` collects all extensions before moving on.
+ ### Neustart nach Merge
+ Nach jedem Merge wird die Ordnerliste neu geladen und beim Merge-Ziel neu gestartet.
+ So sammelt z.B. `Autismus` alle Erweiterungen ein bevor es weitergeht.
---
- ## Media Format Merge (Template System)
+ ## Medienformat-Merge (Template-System)
- Phase 6 uses a template array `MEDIA_TYPES`. Each entry defines:
- - Target folder (with `_` prefix)
- - File extensions belonging to this type
+ Phase 6 nutzt ein Template-Array `MEDIA_TYPES`. Jeder Eintrag definiert:
+ - Zielordner (mit `_` Prefix)
+ - Dateiendungen die zu diesem Typ gehoeren
```bash
MEDIA_TYPES=(
"_Audio|mp3|m4a|wav|flac|ogg|wma|aac|opus|aiff"
"_Video|mp4|avi|mkv|mov|wmv|flv|webm|m4v|mpg|mpeg|3gp"
- "_Images|jpg|jpeg|png|gif|bmp|tiff|tif|webp|svg|ico|heic|heif|raw|cr2|nef"
- # Extensible:
- # "_Spreadsheets|xlsx|xls|csv|ods"
- # "_Presentations|pptx|ppt|odp"
+ "_Bilder|jpg|jpeg|png|gif|bmp|tiff|tif|webp|svg|ico|heic|heif|raw|cr2|nef"
+ # Erweiterbar:
+ # "_Tabellen|xlsx|xls|csv|ods"
+ # "_Prasentationen|pptx|ppt|odp"
# "_Code|py|js|ts|sh|bat|ps1"
# "_CAD|dwg|dxf|step|stl"
# "_3D|obj|fbx|blend|gltf|glb"
# "_Fonts|ttf|otf|woff|woff2"
)
```
- Only folders containing **exclusively** files of one type are moved.
- Folders with subfolders are skipped.
+ Nur Ordner die **ausschliesslich** Dateien eines Typs enthalten werden verschoben.
+ Ordner mit Unterordnern werden uebersprungen.
- ### Adding a New Media Type
+ ### Neuen Medientyp hinzufuegen
- Simply add a new line to the `MEDIA_TYPES` array:
+ Einfach neue Zeile im `MEDIA_TYPES` Array ergaenzen:
```bash
- "_TargetFolder|ext1|ext2|ext3"
+ "_Zielordner|ext1|ext2|ext3"
```
---
- ## Execution
+ ## Ausfuehrung
```bash
- # Complete run: (Deutsch)
- cd /path/to/target/directory
+ # Kompletter Durchlauf:
+ cd /pfad/zum/zielverzeichnis
bash ordner_flattening_komplett.sh
- # Or individual phases: (Deutsch)
+ # Oder einzelne Phasen:
bash ordner_flattening_komplett.sh --phase flatten
bash ordner_flattening_komplett.sh --phase tripel
bash ordner_flattening_komplett.sh --phase media
bash ordner_flattening_komplett.sh --phase cleanup
```
---
- ## Experience Values (Session 2026-01-26)
+ ## Erfahrungswerte Session 26.01.2026
- - Start: 206 folders + 252 loose files, ~5600 nested subfolders
- - After flatten: ~2200 folders on one level
- - After shorten + clean up: ~2005 folders
- - After grouping (numbers, CDs): ~2005 -> collection folders created
- - After triplet v1: ~1561 folders
- - After triplet v2 (8-character rule): further reduction
- - Media format phase: Audio/video/image folders consolidated
+ - Start: 206 Ordner + 252 lose Dateien, ~5600 verschachtelte Unterordner
+ - Nach Flatten: ~2200 Ordner auf einer Ebene
+ - Nach Kuerzen + Bereinigen: ~2005 Ordner
+ - Nach Gruppieren (Zahlen, CDs): ~2005 -> Sammelordner erstellt
+ - Nach Tripel v1: ~1561 Ordner
+ - Nach Tripel v2 (8-Zeichen-Regel): weitere Reduktion
+ - Medienformat-Phase: Audio/Video/Bilder-Ordner konsolidiert
+