Skip to content

README.md

Latest commit

 

History

History
150 lines (94 loc) · 3.15 KB

README.md

File metadata and controls

150 lines (94 loc) · 3.15 KB

DropSort

DropSort is a desktop application for automatically organizing files on your computer. It provides a clean graphical interface and a robust Java core that categorizes and organizes files safely and efficiently.

Screenshot

DropSort Main Screen

Download

The easiest way to use DropSort is via the pre-built application available on GitHub Releases.

Steps

  1. Go to the Releases.
  2. Download the latest DropSort.jar file.
  3. Make sure you have Java 17 or newer installed.
  4. Double click the DropSort.jar file.

If the program does not open try opening the command line and run this command (make sure you are in the same directory as the .jar file when running this command)

java -jar DropSort.jar

No installation or setup is required beyond Java.

Usage

  1. Launch DropSort.
  2. Select the folder you want to organize.
  3. Choose an organization strategy.
  4. Configure the available options (backup, duplicates, subfolders, logs, etc.).
  5. (Optional) Use Preview to see the expected result.
  6. Click Organize Files and confirm.

Files will be moved into automatically created folders according to the selected strategy.

Organization Strategies

  • By Extension – Creates a folder for each file extension (e.g. jpg, pdf).
  • By File Type – Groups files into categories such as Images, Documents, Videos, Audio, Archives, and Code.
  • By Date – Organizes files by last modification date (YYYY-MM).
  • By Size – Groups files into Small, Medium, and Large categories.
  • Custom – Reserved for future rule-based strategies.

Safety Features

  • Preview mode before applying changes
  • Optional automatic backup of the target folder
  • Smart duplicate handling with automatic renaming
  • Optional generation of a detailed log file (dropsort_log.txt)

Manual Installation

Requirements

  • Java Development Kit (JDK) 17 or newer
  • Git
  • An IDE such as IntelliJ IDEA or Eclipse (recommended)

Building From Source

Clone the Repository

git clone https://github.com/AFaria20s/DropSort.git
cd DropSort

Build with Maven

This project uses Apache Maven for dependency management and builds.

Make sure Maven is installed:

mvn -v

To compile the project:

mvn clean compile

To package the application into a runnable JAR:

mvn clean package

The generated JAR will be available in the target/ directory.

Run from Maven

You can run the application directly using:

mvn exec:java -Dexec.mainClass="com.dropsort.app.DropSortApp"

(or configure the exec-maven-plugin with the correct main class if not already set).

Run the Packaged JAR

After packaging:

java -jar target/DropSort.jar

(Replace the JAR name if necessary.)

License

This project is licensed under the MIT License. See the LICENSE file for details.

Author

Developed by Afonso Faria.

Disclaimer

File operations are inherently destructive. Always ensure you have backups of important data before organizing files.