File Organizer is a small Python command-line app that helps sort files inside a folder into separate -fileorg folders. It asks for a valid directory path first, then lets you choose how you want the files organized.

The project supports three organization modes: by file extension, by file category, and by file year. Before moving files, the extension and category workflows show a simple preview and ask for confirmation, so you can review the changes before they happen. Files without extensions are skipped, and duplicate filenames are handled by renaming the later file instead of overwriting anything.

To run the app, install Python dependencies from requirements.txt if needed, then start the program from main.py. The app will prompt for the folder path and show a menu for the available organization options.

The code is split into small modules under app/organizers, app/utils, and app/previewer. Runtime logs are written into the logs folder with the current date in the filename, which makes it easier to review what was moved and when.