{"id":23875240,"url":"https://github.com/shashwat-19/filenest","last_synced_at":"2025-10-13T18:43:22.677Z","repository":{"id":270549428,"uuid":"910723688","full_name":"Shashwat-19/FileNest","owner":"Shashwat-19","description":"FileNest is a fast, lightweight Java tool with a Mac-ready .dmg installer that organizes files by extension, keeping your directories clean and clutter-free.","archived":false,"fork":false,"pushed_at":"2025-09-21T18:03:31.000Z","size":18760,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-21T20:22:58.193Z","etag":null,"topics":["automation","cross-platform","customize","direcotry","efficiency","error-handling","exception-handling","file-handling-in-java","file-manager","file-organization","java","java-filemanager"],"latest_commit_sha":null,"homepage":"https://drive.google.com/file/d/1_SnN4VN4LGvKE_X2e0r-tIJZ-UyQ3Dcm/view?usp=drive_link","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Shashwat-19.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-01-01T07:45:09.000Z","updated_at":"2025-09-21T18:03:37.000Z","dependencies_parsed_at":"2025-01-01T08:26:17.468Z","dependency_job_id":"c0c37c50-5362-4f83-a403-1582c6353f7d","html_url":"https://github.com/Shashwat-19/FileNest","commit_stats":null,"previous_names":["shashwat-19/filenest"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/Shashwat-19/FileNest","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Shashwat-19%2FFileNest","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Shashwat-19%2FFileNest/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Shashwat-19%2FFileNest/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Shashwat-19%2FFileNest/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Shashwat-19","download_url":"https://codeload.github.com/Shashwat-19/FileNest/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Shashwat-19%2FFileNest/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279016600,"owners_count":26085852,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-13T02:00:06.723Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","cross-platform","customize","direcotry","efficiency","error-handling","exception-handling","file-handling-in-java","file-manager","file-organization","java","java-filemanager"],"created_at":"2025-01-03T18:19:11.437Z","updated_at":"2025-10-13T18:43:22.671Z","avatar_url":"https://github.com/Shashwat-19.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://readme-typing-svg.herokuapp.com?font=Fira+Code\u0026size=32\u0026duration=2800\u0026pause=2000\u0026color=667EEA\u0026background=FFFFFF00\u0026center=true\u0026vCenter=true\u0026width=600\u0026lines=FileNest;Organize+%E2%80%A2+Manage+%E2%80%A2+Nest\" alt=\"FileNest Banner\" /\u003e\n\u003c/div\u003e\n\n\n[![GitHub stars](https://img.shields.io/github/stars/Shashwat-19/FileNest?style=social)](https://github.com/Shashwat-19/FileNest/stargazers)\n[![GitHub forks](https://img.shields.io/github/forks/Shashwat-19/FileNest?style=social)](https://github.com/Shashwat-19/FileNest/network)\n[![GitHub issues](https://img.shields.io/github/issues/Shashwat-19/FileNest)](https://github.com/Shashwat-19/FileNest/issues)\n[![GitHub pull requests](https://img.shields.io/github/issues-pr/Shashwat-19/FileNest)](https://github.com/Shashwat-19/FileNest/pulls)\n[![License](https://img.shields.io/github/license/Shashwat-19/FileNest)](./LICENSE)\n[![GitHub release](https://img.shields.io/github/v/release/Shashwat-19/FileNest)](https://github.com/Shashwat-19/FileNest/releases)\n[![Platform](https://img.shields.io/badge/platform-Windows%20|%20macOS%20|%20Linux-blue)](#)\n[![Build](https://img.shields.io/badge/build-passing-brightgreen)](#)\n[![Open Source](https://img.shields.io/badge/Open%20Source-Yes-green)](#)\n[![Contributions Welcome](https://img.shields.io/badge/Contributions-Welcome-brightgreen)](#)\n\n```\n███████╗██╗██╗     ███████╗███╗   ██╗███████╗███████╗████████╗\n██╔════╝██║██║     ██╔════╝████╗  ██║██╔════╝██╔════╝╚══██╔══╝\n█████╗  ██║██║     █████╗  ██╔██╗ ██║█████╗  ███████╗   ██║   \n██╔══╝  ██║██║     ██╔══╝  ██║╚██╗██║██╔══╝  ╚════██║   ██║   \n██║     ██║███████╗███████╗██║ ╚████║███████╗███████║   ██║   \n╚═╝     ╚═╝╚══════╝╚══════╝╚═╝  ╚═══╝╚══════╝╚══════╝   ╚═╝   \n```\n\n## Overview\nFileNest 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.\n\n### 🌟 **Why Open Source?**\n- **Transparency**: Complete source code visibility for security and trust\n- **Community-Driven**: Features and improvements driven by user needs\n- **Educational**: Learn from real-world Java application development\n- **Collaborative**: Join a growing community of developers and users\n- **Free Forever**: No licensing fees or hidden costs\n\n---\n\n## 📦 Latest Release: [v3.2](https://github.com/Shashwat-19/FileNest/releases/tag/v3.2)\nFileNest v3.2 is now live! 🎉  \nThis version introduces **Stats-Functionality**, making file organization even more intuitive and efficient.\n\n### 🚀 **Community Contributions in v3.2**\n- Enhanced UI/UX based on community feedback\n- Performance optimizations suggested by contributors\n- Bug fixes reported by users\n- New features requested through GitHub issues\n\n---\n\n## ✨ **Features**  \n- **Multi-Platform Support** — Works seamlessly on **Windows, macOS, and Linux**.  \n- **Graphical User Interface (GUI)** — Simple and intuitive interface for easy navigation.  \n- **Smart File Categorization** — Automatically sorts files into folders based on type (Images, Documents, Videos, etc.).  \n- **Drag-and-Drop Functionality** — Effortlessly move files into the application for quick sorting.  \n- **Optimized Performance** — Handles large directories efficiently without lag.  \n- **Trash Management** — Moves unnecessary files to the trash safely on all supported operating systems.  \n- **Stats Feature** — View detailed statistics on your file system, including total file count, file types, largest files, and more for better file management.\n- **Open Source** — Full source code available for review, modification, and contribution.\n- **Community Driven** — Features and improvements based on user feedback and contributions.\n\n\n---\n\n## 📚 Tech Stack\n- **Language**: Java ☕️\n- **File Handling**: Java IO \u0026 NIO\n- **GUI Framework**: Swing (Now with Drag \u0026 Drop support!)\n- **Event Handling**: Java Event Listeners\n\n---\n\n## System Components\n```\nFileNest/\n├── .github/               \n├── .vscode/                 \n├── src/                      \n│   └── com/\n│       └── filenest/\n│           └── FileOrganizer.java\n├── libs/                     \n├── assets/\n│   ├── images/               \n│   └── icons/                 \n│       ├── MyIcon.iconset/\n│       └── MyIcon.icns\n├── input/                   \n│   ├── input-folder/\n│   └── temp-input/\n├── output/                  \n│   ├── out/\n│   └── other generated files\n├── dist/                   \n│   ├── FileNest.jar\n│   ├── FileOrganizer.class\n│   └── manifest.txt\n├── .gitattributes\n├── .gitignore\n├── LICENSE\n├── README.md\n├── SECURITY.md\n└── CODE_OF_CONDUCT.md\n```\n---\n\n## 🔗 Dependencies\n\nMake sure these are installed before running **FileNest**:\n\n- **Java (JDK 8 or higher)** ☕️  \n  - macOS: `brew install openjdk@17`  \n  - Linux: `sudo apt install openjdk-17-jdk`  \n  - Windows: [Download JDK](https://www.oracle.com/java/technologies/javase-downloads.html)\n\n- **Git** 🌀  \n  - macOS: `brew install git`  \n  - Linux: `sudo apt install git`  \n  - Windows: [Download Git](https://git-scm.com/download/win)\n\n- **Maven (Optional)** ⚙️  \n  - macOS: `brew install maven`  \n  - Linux: `sudo apt install maven`  \n  - Windows: [Download Maven](https://maven.apache.org/download.cgi)\n---\n## 🛠️ Installation Guide\n\n### **Windows Users**\n1. **Clone the Repository:**\n   ```sh\n   git clone https://github.com/Shashwat-19/FileNest.git\n   cd FileNest\n   ```\n2. **Compile the Java Program:**\n   ```sh\n   javac FileOrganizer.java\n   ```\n3. **Run the Program:**\n   ```sh\n   java FileOrganizer\n   ```\n\n## 💻 MacOS Users\n🔽 **Download FileNest v3.2 for macOS**: [Download Here](https://drive.google.com/file/d/1_SnN4VN4LGvKE_X2e0r-tIJZ-UyQ3Dcm/view?usp=drive_link)\n\nAfter downloading, simply install the `.dmg` file and launch the application.\n\n### **Linux Users**\n1. **Clone the Repository:**\n   ```sh\n   git clone https://github.com/Shashwat-19/FileNest.git\n   cd FileNest\n   ```\n2. **Compile and Run:**\n   ```sh\n   javac FileOrganizer.java\n   java FileOrganizer\n   ```\n\n---\n\n\n\n## 📊 Performance Optimization\n- **Caching strategies implemented**\n- **Database indexing**\n- **Load balancing and scaling strategies**\n\n---\n\n## 🤝 **Contributing to FileNest**\n\nWe welcome contributions from the community! Whether you're fixing bugs, adding features, improving documentation, or helping others, your contributions make FileNest better for everyone.\n\n### **How to Contribute**\n\n1. **Fork the Repository**\n   ```bash\n   git clone https://github.com/your-username/FileNest.git\n   cd FileNest\n   ```\n\n2. **Create a Feature Branch**\n   ```bash\n   git checkout -b feature/your-feature-name\n   ```\n\n3. **Make Your Changes**\n   - Follow our coding standards\n   - Add tests for new functionality\n   - Update documentation as needed\n\n4. **Commit Your Changes**\n   ```bash\n   git commit -m \"Add: Brief description of your changes\"\n   ```\n\n5. **Push and Create Pull Request**\n   ```bash\n   git push origin feature/your-feature-name\n   ```\n\n### **Types of Contributions We Welcome**\n\n- 🐛 **Bug Fixes** — Help us identify and fix issues\n- ✨ **New Features** — Add functionality that benefits the community\n- 📚 **Documentation** — Improve guides, README, and code comments\n- 🎨 **UI/UX Improvements** — Enhance the user interface and experience\n- ⚡ **Performance** — Optimize code for better performance\n- 🧪 **Testing** — Add or improve test coverage\n- 🌍 **Localization** — Help translate FileNest to other languages\n\n### **Development Setup**\n\n1. **Prerequisites**\n   - Java 8 or higher\n   - Git\n   - Your favorite IDE (IntelliJ IDEA, Eclipse, VS Code)\n\n2. **Build from Source**\n   ```bash\n   javac FileOrganizer.java\n   java FileOrganizer\n   ```\n\n3. **Run Tests**\n   ```bash\n   # Add test commands here as they are implemented\n   ```\n\n### **Community Guidelines**\n\n- **Be Respectful** — Treat all community members with respect\n- **Be Constructive** — Provide helpful feedback and suggestions\n- **Be Patient** — Remember that maintainers are volunteers\n- **Follow Code of Conduct** — See [CODE_OF_CONDUCT.md](./CODE_OF_CONDUCT.md)\n\n### **Reporting Issues**\n\nFound a bug or have a feature request? We'd love to hear about it!\n\n1. **Check Existing Issues** — Search [GitHub Issues](https://github.com/Shashwat-19/FileNest/issues) first\n2. **Create New Issue** — Use our issue templates for bugs and feature requests\n3. **Provide Details** — Include steps to reproduce, expected behavior, and system info\n\n### **Getting Help**\n\n- 💬 **Discussions** — Use [GitHub Discussions](https://github.com/Shashwat-19/FileNest/discussions) for questions\n- 📧 **Email** — Contact maintainers at shashwat1956@gmail.com\n- 📖 **Documentation** — Check our [Google Docs](https://docs.google.com/document/d/e/2PACX-1vRbfTTckjWkqay1_ddfWNF7Y0DK0qg-iy_ANYLU1S2_QObyYVq_y4rMJH4XnCYDnDHNZmZ4XfnKqIjr/pub)\n\n---\n\n## 🗺️ **Roadmap \u0026 Future Plans**\n\n### **Upcoming Features** (Community Requested)\n- [ ] **Plugin System** — Allow custom file categorization plugins\n- [ ] **Cloud Integration** — Support for Google Drive, Dropbox, OneDrive\n- [ ] **Advanced Filters** — More sophisticated file filtering options\n- [ ] **Batch Operations** — Process multiple directories simultaneously\n- [ ] **File Preview** — Quick preview of files before organization\n- [ ] **Custom Categories** — User-defined file categorization rules\n- [ ] **API Support** — REST API for programmatic access\n- [ ] **Mobile App** — Companion mobile application\n\n### **How to Suggest Features**\n1. Open a [Feature Request](https://github.com/Shashwat-19/FileNest/issues/new?template=feature_request.md)\n2. Describe the feature and its benefits\n3. Community voting helps prioritize development\n\n---\n\n## 📖 Documentation\nSince FileNest does not have an API, the documentation includes installation guides, usage instructions, and troubleshooting tips. The documentation is also available in [Google Docs](https://docs.google.com/document/d/e/2PACX-1vRbfTTckjWkqay1_ddfWNF7Y0DK0qg-iy_ANYLU1S2_QObyYVq_y4rMJH4XnCYDnDHNZmZ4XfnKqIjr/pub) for easy sharing and reference.\n\n---\n\n## 🌟 **Community \u0026 Recognition**\n\n### **Contributors**\nThank you to all the amazing contributors who have helped make FileNest better! \n\n[![Contributors](https://contrib.rocks/image?repo=Shashwat-19/FileNest)](https://github.com/Shashwat-19/FileNest/graphs/contributors)\n\n### **Community Stats**\n- ⭐ **Stars**: Growing community of supporters\n- 🍴 **Forks**: Active development across the community\n- 🐛 **Issues**: Community-driven bug tracking and feature requests\n- 💬 **Discussions**: Active community conversations\n- 📈 **Downloads**: Thousands of users worldwide\n\n### **Recognition \u0026 Awards**\n- 🏆 **Featured Project** — Highlighted in multiple developer communities\n- 📰 **Blog Coverage** — Featured in tech blogs and tutorials\n- 👥 **Community Choice** — Voted as a top file management tool\n\n---\n\n## 📝 Developer Blog\n\nCurious about the story behind FileNest or how it was built?  \nI regularly share **development insights**, **Java tips**, and **behind-the-scenes tutorials** on my [Hashnode blog](https://hashnode.com/@Shashwat56).\n\n### 🔍 Blog Highlights *(Coming Soon)*\n\n- *How I Built FileNest – Tackling Cross-Platform File Organization in Java*  \n- *Implementing Drag-and-Drop in Swing UI – Made Easy*  \n- *Building the Stats Feature – Visualizing File System Data*  \n- *Open Source Best Practices – Lessons from FileNest Development*\n- *Community-Driven Development – How User Feedback Shapes Features*\n\n📰 **Read the full series and more here:**  \n[![Visit My Blog](https://img.shields.io/badge/Visit%20My%20Blog-2962FF?style=for-the-badge\u0026logo=hashnode\u0026logoColor=white)](https://shashwat-filenest.hashnode.dev/)\n\nStay tuned for new posts and updates!\n\n\n## 🔒 License\nThis project is licensed under the **Mozilla Public License Version 2.0**.\u003cbr\u003e For detailed licensing information, please refer to the [LICENSE](./LICENSE) file included in this repository.\n\n---\n\n## 📩 Contact \u0026 Community  \n### Shashwat - Project Maintainer  \n**Python \u0026 Java Developer | Cloud \u0026 NoSQL Enthusiast | Open Source Advocate**  \n\n- **Python \u0026 Java Development** – Automation, Backend Systems, APIs, and OOP  \n- **Cloud \u0026 NoSQL** – Docker, AWS, MongoDB, Firebase Firestore  \n- **UI/UX Design** – Creating user-focused, scalable, and visually engaging applications  \n- **Open Source** – Passionate about community-driven development and collaboration\n\n---\n\n## 🚀 **Join Our Open Source Community**  \nFileNest 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.\n\n## 🎉 **Get Started Today!**\n\nReady to join our open source community? Here's how:\n\n1. **⭐ Star the Repository** — Show your support\n2. **🍴 Fork the Project** — Create your own copy\n3. **🐛 Report Issues** — Help us improve\n4. **💡 Suggest Features** — Share your ideas\n5. **🔧 Contribute Code** — Make FileNest better\n6. **📢 Spread the Word** — Share with others\n\n**Together, we're building the future of file management!** 🚀\n\n### **Why Join Our Community?**\n- 🤝 **Collaborate** with developers worldwide\n- 📚 **Learn** from real-world Java development\n- 🎯 **Contribute** to meaningful open source projects\n- 🌟 **Build** your portfolio with recognized contributions\n- 💡 **Innovate** with cutting-edge file management features\n\n### **Community Channels**\n- 💬 **GitHub Discussions** — Ask questions, share ideas, get help\n- 🐛 **GitHub Issues** — Report bugs, request features\n- 📧 **Email** — Direct contact for maintainers\n- 📖 **Documentation** — Comprehensive guides and tutorials\n\n### 📌 **Connect with the Maintainer**  \n[\u003cimg src=\"https://img.shields.io/badge/GitHub-181717?style=for-the-badge\u0026logo=github\u0026logoColor=white\" /\u003e](https://github.com/Shashwat-19)  [\u003cimg src=\"https://img.shields.io/badge/LinkedIn-0A66C2?style=for-the-badge\u0026logo=linkedin\u0026logoColor=white\" /\u003e](https://www.linkedin.com/in/shashwatk1956/)  [\u003cimg src=\"https://img.shields.io/badge/Email-D14836?style=for-the-badge\u0026logo=gmail\u0026logoColor=white\" /\u003e](mailto:shashwat1956@gmail.com)  [\u003cimg src=\"https://img.shields.io/badge/Hashnode-2962FF?style=for-the-badge\u0026logo=hashnode\u0026logoColor=white\" /\u003e](https://hashnode.com/@Shashwat56)\n[\u003cimg src=\"https://img.shields.io/badge/HackerRank-15%2B-2EC866?style=for-the-badge\u0026logo=HackerRank\u0026logoColor=white\" /\u003e](https://www.hackerrank.com/profile/shashwat1956)\n\n---\n\n**Enjoy organizing your files with FileNest v3.2!** 🎉\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshashwat-19%2Ffilenest","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshashwat-19%2Ffilenest","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshashwat-19%2Ffilenest/lists"}