███████╗██╗██╗     ███████╗███╗   ██╗███████╗███████╗████████╗
██╔════╝██║██║     ██╔════╝████╗  ██║██╔════╝██╔════╝╚══██╔══╝
█████╗  ██║██║     █████╗  ██╔██╗ ██║█████╗  ███████╗   ██║   
██╔══╝  ██║██║     ██╔══╝  ██║╚██╗██║██╔══╝  ╚════██║   ██║   
██║     ██║███████╗███████╗██║ ╚████║███████╗███████║   ██║   
╚═╝     ╚═╝╚══════╝╚══════╝╚═╝  ╚═══╝╚══════╝╚══════╝   ╚═╝   

FileNest is a community-driven, open-source file management application designed to streamline file organization through intelligent categorization and user-friendly interfaces. Built with Java and maintained by contributors worldwide, this project addresses the critical challenge of managing digital file systems efficiently across Windows, macOS, and Linux platforms.

• Transparency: Complete source code visibility for security and trust
• Community-Driven: Features and improvements driven by user needs
• Educational: Learn from real-world Java application development
• Collaborative: Join a growing community of developers and users
• Free Forever: No licensing fees or hidden costs

FileNest v3.2 is now live! 🎉
This version introduces Stats-Functionality, making file organization even more intuitive and efficient.

• Enhanced UI/UX based on community feedback
• Performance optimizations suggested by contributors
• Bug fixes reported by users
• New features requested through GitHub issues

• Multi-Platform Support — Works seamlessly on Windows, macOS, and Linux.
• Graphical User Interface (GUI) — Simple and intuitive interface for easy navigation.
• Smart File Categorization — Automatically sorts files into folders based on type (Images, Documents, Videos, etc.).
• Drag-and-Drop Functionality — Effortlessly move files into the application for quick sorting.
• Optimized Performance — Handles large directories efficiently without lag.
• Trash Management — Moves unnecessary files to the trash safely on all supported operating systems.
• Stats Feature — View detailed statistics on your file system, including total file count, file types, largest files, and more for better file management.
• Open Source — Full source code available for review, modification, and contribution.
• Community Driven — Features and improvements based on user feedback and contributions.

• Language: Java ☕️
• File Handling: Java IO & NIO
• GUI Framework: Swing (Now with Drag & Drop support!)
• Event Handling: Java Event Listeners

FileNest/                   
├── assets/                         # All icons and images
├── CODE_OF_CONDUCT.md
├── LICENSE
├── README.md
└── SECURITY.md
├── src/
│   └── com/filenest/
│       ├── FileOrganizer.class
│       └── FileOrganizer.java      # Your main FileOrganizer application
└── .github/workflows/build.yml     # Updated to use simple Java compilation

Make sure these are installed before running FileNest:

• Java (JDK 8 or higher) ☕️

  • macOS: brew install openjdk@17
  • Linux: sudo apt install openjdk-17-jdk
  • Windows: Download JDK

• Git 🌀

  • macOS: brew install git
  • Linux: sudo apt install git
  • Windows: Download Git

• Maven (Optional) ⚙️

  • macOS: brew install maven
  • Linux: sudo apt install maven
  • Windows: Download Maven

1. Clone the Repository:

   git clone https://github.com/Shashwat-19/FileNest.git
   cd FileNest

2. Compile the Java Program:

   javac FileOrganizer.java

3. Run the Program:

   java FileOrganizer

🔽 Download FileNest v3.2 for macOS: Download Here

After downloading, simply install the .dmg file and launch the application.

1. Clone the Repository:

   git clone https://github.com/Shashwat-19/FileNest.git
   cd FileNest

2. Compile and Run:

   javac FileOrganizer.java
   java FileOrganizer

• Caching strategies implemented
• Database indexing
• Load balancing and scaling strategies

We welcome contributions from the community! Whether you're fixing bugs, adding features, improving documentation, or helping others, your contributions make FileNest better for everyone.

1. Fork the Repository

   git clone https://github.com/your-username/FileNest.git
   cd FileNest

2. Create a Feature Branch

   git checkout -b feature/your-feature-name

3. Make Your Changes

   • Follow our coding standards
   • Add tests for new functionality
   • Update documentation as needed

4. Commit Your Changes

   git commit -m "Add: Brief description of your changes"

5. Push and Create Pull Request

   git push origin feature/your-feature-name

• 🐛 Bug Fixes — Help us identify and fix issues
• ✨ New Features — Add functionality that benefits the community
• 📚 Documentation — Improve guides, README, and code comments
• 🎨 UI/UX Improvements — Enhance the user interface and experience
• ⚡ Performance — Optimize code for better performance
• 🧪 Testing — Add or improve test coverage
• 🌍 Localization — Help translate FileNest to other languages

1. Prerequisites

   • Java 8 or higher
   • Git
   • Your favorite IDE (IntelliJ IDEA, Eclipse, VS Code)

2. Build from Source

   javac FileOrganizer.java
   java FileOrganizer

3. Run Tests

   # Add test commands here as they are implemented

• Be Respectful — Treat all community members with respect
• Be Constructive — Provide helpful feedback and suggestions
• Be Patient — Remember that maintainers are volunteers
• Follow Code of Conduct — See CODE_OF_CONDUCT.md

Found a bug or have a feature request? We'd love to hear about it!

1. Check Existing Issues — Search GitHub Issues first
2. Create New Issue — Use our issue templates for bugs and feature requests
3. Provide Details — Include steps to reproduce, expected behavior, and system info

• 💬 Discussions — Use GitHub Discussions for questions
• 📧 Email — Contact maintainers at shashwat1956@gmail.com
• 📖 Documentation — Check our Google Docs

• Plugin System — Allow custom file categorization plugins
• Cloud Integration — Support for Google Drive, Dropbox, OneDrive
• Advanced Filters — More sophisticated file filtering options
• Batch Operations — Process multiple directories simultaneously
• File Preview — Quick preview of files before organization
• Custom Categories — User-defined file categorization rules
• API Support — REST API for programmatic access
• Mobile App — Companion mobile application

1. Open a Feature Request
2. Describe the feature and its benefits
3. Community voting helps prioritize development

Since FileNest does not have an API, the documentation includes installation guides, usage instructions, and troubleshooting tips. The documentation is also available in Google Docs for easy sharing and reference.

Thank you to all the amazing contributors who have helped make FileNest better!

• ⭐ Stars: Growing community of supporters
• 🍴 Forks: Active development across the community
• 🐛 Issues: Community-driven bug tracking and feature requests
• 💬 Discussions: Active community conversations
• 📈 Downloads: Thousands of users worldwide

• 🏆 Featured Project — Highlighted in multiple developer communities
• 📰 Blog Coverage — Featured in tech blogs and tutorials
• 👥 Community Choice — Voted as a top file management tool

Curious about the story behind FileNest or how it was built?
I regularly share development insights, Java tips, and behind-the-scenes tutorials on my Hashnode blog.

• How I Built FileNest – Tackling Cross-Platform File Organization in Java
• Implementing Drag-and-Drop in Swing UI – Made Easy
• Building the Stats Feature – Visualizing File System Data
• Open Source Best Practices – Lessons from FileNest Development
• Community-Driven Development – How User Feedback Shapes Features

📰 Read the full series and more here:

Stay tuned for new posts and updates!

This project is licensed under the Mozilla Public License Version 2.0.
For detailed licensing information, please refer to the LICENSE file included in this repository.

Python & Java Developer | Cloud & NoSQL Enthusiast | Open Source Advocate

• Python & Java Development – Automation, Backend Systems, APIs, and OOP
• Cloud & NoSQL – Docker, AWS, MongoDB, Firebase Firestore
• UI/UX Design – Creating user-focused, scalable, and visually engaging applications
• Open Source – Passionate about community-driven development and collaboration

FileNest is more than just a project—it's a community of developers, users, and contributors working together to create the best file management experience possible.

Ready to join our open source community? Here's how:

1. ⭐ Star the Repository — Show your support
2. 🍴 Fork the Project — Create your own copy
3. 🐛 Report Issues — Help us improve
4. 💡 Suggest Features — Share your ideas
5. 🔧 Contribute Code — Make FileNest better
6. 📢 Spread the Word — Share with others

Together, we're building the future of file management! 🚀

• 🤝 Collaborate with developers worldwide
• 📚 Learn from real-world Java development
• 🎯 Contribute to meaningful open source projects
• 🌟 Build your portfolio with recognized contributions
• 💡 Innovate with cutting-edge file management features

• 💬 GitHub Discussions — Ask questions, share ideas, get help
• 🐛 GitHub Issues — Report bugs, request features
• 📧 Email — Direct contact for maintainers
• 📖 Documentation — Comprehensive guides and tutorials

Enjoy organizing your files with FileNest v3.2! 🎉