A powerful Java Swing application that automatically organizes unorganized files into a clean, hierarchical folder structure based on their internal metadata (ID3 tags, PDF properties, Document info, etc.).
Recursive Sorting: Create multi-level directory structures (e.g., Artist > Album > Genre > File). Deep File Analysis: Uses Apache Tika to extract metadata from hundreds of file types (MP3, PDF, DOCX, JPG, etc.). Live Preview: See exactly how your files will be moved before committing to the operation. Safety Revert: Made a mistake? Use the Revert function to move all files back to their original locations and delete the empty directories created. Performance Optimized: Uses parallel streams and NIO.2 for fast I/O operations and efficient memory management. Smart Sanitization: Automatically cleans metadata values to ensure they are valid folder names across all operating systems.
Install Java JDK 21 or higher.
Installation
Clone the repository:
git clone https://github.com/Tjorven-Liebe/file-sorter.git
Build the project:
./gradlew shadowJar
Run the application:
java -jar build/libs/FileSorter-SNAPSHOT-1.0.jar
- Select Folder: Pick the directory containing your unorganized files.
- Define Hierarchy: * Select a metadata attribute from the dropdown (e.g., Author).
- Click Add Level.
- Repeat to create deeper subfolders (e.g., adding Album after Author).
- Preview: Check the "Move Preview" list to verify the path logic: song.mp3 -> [Daft Punk]/[Discovery]/song.mp3
- Run: Click Run Recursive Sort to organize the files.
- Undo: If the results aren't what you expected, click Revert Last Sort immediately to restore the original state.
The application includes a blacklist.txt file. You can add metadata keys to this file (e.g., X-Parsed-By) to hide technical or irrelevant metadata from the sorting options, keeping the UI clean.