{"id":26713707,"url":"https://github.com/victorcast2/file-organizer","last_synced_at":"2025-07-28T16:08:21.368Z","repository":{"id":181341372,"uuid":"666602766","full_name":"VictorCast2/File-Organizer","owner":"VictorCast2","description":"📂🐍 Organizador de Archivos en Python  Simplifica tu vida organizando tus archivos con un solo click gracias a este increíble organizador desarrollado en Python! 🚀¡Mantén tus archivos en orden y ahorra tiempo con este Organizador de Archivos en Python! 📂🐍","archived":false,"fork":false,"pushed_at":"2024-06-28T02:14:30.000Z","size":247,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-16T03:56:26.971Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/VictorCast2.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-07-15T01:03:01.000Z","updated_at":"2025-03-14T11:36:55.000Z","dependencies_parsed_at":"2024-06-28T03:26:57.913Z","dependency_job_id":"54c6cf55-76e3-4f06-9383-6f1d0ac8c4db","html_url":"https://github.com/VictorCast2/File-Organizer","commit_stats":null,"previous_names":["victorcast2/file-organizer"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/VictorCast2/File-Organizer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VictorCast2%2FFile-Organizer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VictorCast2%2FFile-Organizer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VictorCast2%2FFile-Organizer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VictorCast2%2FFile-Organizer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/VictorCast2","download_url":"https://codeload.github.com/VictorCast2/File-Organizer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VictorCast2%2FFile-Organizer/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267543446,"owners_count":24104578,"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-07-28T02:00:09.689Z","response_time":68,"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":[],"created_at":"2025-03-27T12:29:53.789Z","updated_at":"2025-07-28T16:08:21.342Z","avatar_url":"https://github.com/VictorCast2.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"![](img/1_haqHPRjJwSeqDA7UZ-zntA.jpg)\n\n## 📂\u0026nbsp;🐍\u0026nbsp; Python File Organizer 🗂️\u0026nbsp;🐍\u0026nbsp;\nSimplify your life and conquer the chaos of your files with just one click using this amazing Python file organizer! 🚀\n\n🤔 Tired of wasting time searching for your files? Need a quick and efficient way to sort and manage your documents, images, videos, and music? Say goodbye to clutter and hello to ultimate organization! This Python file organizer is here to save the day. 💪📁\n\n💡 Unlock the power of Python, one of the most versatile and widely-used programming languages in the world. Whether you're a web developer, desktop application enthusiast, aspiring hacker, or AI explorer, Python has got you covered! 🌐🖥️🔍🤖\n\nThis project is a file organizer developed in Python that allows you to organize your files easily and quickly.🚀\n\n##\n\n\u003cdetails\u003e\n  \u003csummary\u003e🎉\u0026nbsp; \u003cstrong\u003eKey Features:\u003c/strong\u003e\u003c/summary\u003e\n\n*  \u003cstrong\u003e Simplicity at its finest:\u003c/strong\u003e Effortlessly organize your files into intuitive categories. 🗂️✨\n\n*  \u003cstrong\u003e Automation for the win: \u003c/strong\u003e Let the Python script do the heavy lifting, saving you valuable time and energy. ⚙️⏱️\n\n*  \u003cstrong\u003e Customization made easy:\u003c/strong\u003e  Tailor the organizer to suit your specific needs and preferences. It's flexible, adaptable, and ready to meet your requirements. 🎨🔧\n\n*  \u003cstrong\u003e User-friendly experience:\u003c/strong\u003e  No advanced coding skills required! With a user-friendly design, this organizer is a breeze to use. Just one click and voilá! 🚀🖱️\n\u003c/details\u003e\n\n## \n\n📋 Follow the easy steps outlined in the README.md to get started. \nFrom installation to execution, it's a smooth process. Plus, if you're feeling adventurous, contribute to the project and be part of an active and supportive community. 👥🤝\n\n🔗 Check out the additional resources to explore more about Python and unleash its full potential. From official documentation to GitHub repositories, Stack Overflow, and more, the world of Python awaits your curiosity. 📚🐍🌟\n\nGet ready to bid farewell to file chaos and welcome an organized and efficient workflow with this powerful Python File Organizer! 📂🐍💼\n\n## Illustration: \nAn artistic depiction showing files transforming from a disorganized mess into a beautifully arranged, harmonious collection, symbolizing the transformative power of the Python file organizer. 🌈📁✨\n\n## 🗃️\u0026nbsp; Python File Organizer 🐍\u0026nbsp;\n\nThis project is a file organizer developed in Python that allows you to organize your files easily and quickly. 🚀\n\n## 📝\u0026nbsp; Description 📂\u0026nbsp;\nPython is one of the most important programming languages today due to its versatility. With Python, you can create web applications, desktop applications, perform hacking tasks, develop artificial intelligence applications, and much more. In this project, you will learn how to use Python to organize your files with just one click, making your life much easier. 💡🌟\n\n##\n\n \u003cdetails\u003e\n    \u003csummary\u003e\u003cstrong\u003e🔧 Features ✨\u003c/strong\u003e\u003c/summary\u003e\n   \n- **Easy organization:** With this organizer, you can classify your files into different categories such as images, documents, videos, music, and more.📁🗂️\n- **Automation:** The Python script automates the file sorting process, saving you time and effort.⚙️⏱️\n- **Customization:** You can customize the classification categories according to your needs and preferences. The script is flexible and adapts to your specific requirements.🎨🔧\n- **User-friendly:** No advanced programming knowledge is required. The organizer is designed intuitively and can be executed with just one click.🚀\n  \n \u003c/details\u003e\n \n##\n\n## 📋\u0026nbsp; Requirements 🛠️\u0026nbsp;\nTo use the Python File Organizer, make sure you have the following requirements fulfilled:\n\n1. \u003cstrong\u003ePython 3:\u003c/strong\u003e Ensure that Python 3 is installed on your system. If you don't have it installed, you can download it from the official Python website: Python.org.\n2. \u003cstrong\u003ePython libraries:\u003c/strong\u003e You need to have the following Python libraries installed:\n- \u003cstrong\u003eOs:\u003c/strong\u003e This library provides a way to interact with the operating system and perform file operations. You can install it by running the following command in your terminal: ```batch pip install os```\n  \n- \u003cstrong\u003eShutil:\u003c/strong\u003e This library provides a higher-level interface for file operations, such as moving, copying, and deleting files. Install it by running the following command in your terminal: ```batch pip install shutil```\n\n- \u003cstrong\u003eColorama:\u003c/strong\u003e This library adds ANSI escape character sequences to your Python program, allowing you to add colors and styles to the terminal output. Install it by running the following command in your terminal: ```pip install colorama```\n  \n- \u003cstrong\u003eArgparse:\u003c/strong\u003e This library provides a way to parse command-line arguments and options. It makes it easy to create powerful and user-friendly command-line interfaces. Install it by running the following command in your terminal: ```batch pip install argparse```\n\nMake sure all the required libraries are installed correctly to ensure the smooth functioning of the Python File Organizer.\n\nNow you're ready to organize your files with just a few clicks! 🗂️🐍✨\n\n## 📚\u0026nbsp; How to Use 🚀\u0026nbsp;\n1. Clone or download the repository to your local machine. 🔄💻\n   ```batch\n   git clone https://github.com/VictorCast2/File-Organizer.git                \n\n   and access the folder with\n\n   \n   cd \"Organizador De Todos Tus Archivos\\Py \"       \n\n\n3. Make sure you have Python 3 installed on your system. 🐍✅\n4. Install the necessary Python libraries by running the following command in your terminal: ```pip install os shutil```. 💻⚙️\n5. Open the ```organizer.py``` file in a text editor.📝📂\n6. Customize the classification categories according to your needs. For example, you can add new categories or modify existing ones.📁🔧\n7. Save the changes made to the file.💾✅\n8. Run the `organizer.py` script by double-clicking on it or from your terminal: ```python organizer.py```.🚀⏩\n9. That's it! Your files will be automatically organized into the corresponding categories. 🗂️🎉\n\n## 📚\u0026nbsp; How Library installation 🚀\u0026nbsp;\nTo begin your journey into the world of libraries, let's embark on a beautiful path filled with knowledge and possibilities.\n\nWith a simple command, the magic starts:\n```pip install -r __TXT__\\requirements.txt ```\nAs the lines of code dance and intertwine, a symphony of dependencies unfolds, forming the foundation of your project. Each library, like a unique flower, contributes its own beauty and purpose.\n\nIn this realm of creativity and innovation, your ideas take flight, soaring through the vast expanse of possibilities. With each installation, you unlock new doors, revealing untapped realms of discovery.🔄💻\n\nEmbrace this process, for it is more than a mere installation. It is a testament to your passion and curiosity, a testament to the power of human ingenuity.\n\nSo, with every library installed, remember the potential it holds within. Let it guide you towards new horizons, where your dreams can become a reality.\n\nHappy coding, adventurer! May your library installation journey be filled with wonder and inspiration. ✨🚀🔮\n----\n\n## 📚\u0026nbsp; Reading the README.md file and LICENSE 🚀\u0026nbsp;\n- for Windows:\n```batch\ntype README.md | more\ntype LICENSE | more\n```\n\n- for Linux:\n```bash\ncat README.md | more\ncat LICENSE | more\n```\n----\n\n### 📚\u0026nbsp; File Organizer Script 🚀\u0026nbsp\n## Description\nThis script organizes files based on their file extensions into specific folders. It helps you keep your files organized and easily accessible.\n\n## Usage\n1. Ensure you have Python installed on your system.\n2. Clone or download this repository to your local machine.\n3. Open a terminal or command prompt and navigate to the directory where you have the script.\n4. Install the required dependencies by running the following command:\n   \n```bash\npip install colorama\n```\n\n5. Run the script using the following command:\n```bash\npython script.py\n```\n\n### 📚\u0026nbsp; 🐍\u0026nbsp; Folder Structure 🐍\u0026nbsp; 📚\u0026nbsp; \n\u003cdetails\u003e\n  \u003csummary\u003e\u003cstrong\u003eThe script organizes files into the following folders:\u003c/strong\u003e\u003c/summary\u003e\n  \n- **Documents 📄**\n  \n- **Photos 📷**\n  \n- **Videos 📹**\n  \n- **Music 🎵**\n  \n- **Downloads ⬇️**\n  \n- **Other 🗂️**\n  \n\u003c/details\u003e\n\n### 📚\u0026nbsp; Customize 🚀\u0026nbsp\nYou can customize the file extensions and folder names in the script according to your preferences. Open the script and modify the ``` \nfile_extensions ``` dictionary as needed.\n\n### 📚\u0026nbsp; Author 📚\u0026nbsp;\nVíctor Cast2\n```vbnet\nPlease note that you should replace \"Víctor Castillo\" with your actual name or desired author \"Víctor José Castillo Castro \".\n\nWith this content, you'll have a README.md file that explains the script, its usage, the folder structure, and includes the section for reading the README.md file and LICENSE.\n\nLet me know if you need further assistance!\n```\n\n## 📚\u0026nbsp; Detailed explanation of the script 🚀\u0026nbsp; 🐍\u0026nbsp;\n📂 The create_folder_if_not_exists function checks if a folder exists and creates it if it doesn't. This ensures that the target directory for organizing the files is available.\n\n🚀 The organize_files function performs the actual file organization. It uses a dictionary called file_extensions to define the file extensions and their corresponding folders. If a file matches any of the extensions, it is moved to the respective folder.\n\n✨ When a file is successfully moved, it prints a success message with a green color using colorama. The Fore.GREEN adds a touch of color to the output.\n\n❌ If there is an error moving a file, it prints an error message with a red color.\n\n⚡️ If a file doesn't match any of the defined extensions, it is moved to the \"Other\" folder.\n\n🌈 The init() function from colorama initializes color support for the terminal, making the output more colorful and vibrant.\n\n📁 The source_dir variable holds the source directory where the files are located. Modify this to the desired source directory.\n\n📂 The target_dir variable holds the target directory where the organized folders will be created. Modify this to the desired target directory. The script ensures that the target directory exists by calling create_folder_if_not_exists.\n\nThat's it! The script organizes files based on their extensions into specific folders. Make sure to customize the file_extensions dictionary to match your desired folder structure and file extensions.\n\n## 👥\u0026nbsp; Contribution 🤝\u0026nbsp;\n\nIf you want to contribute to this project, follow these steps:\n\n1. Fork the repository.\n2. Create a new branch with the feature or improvement you want to implement.\n3. Make the changes in your branch.\n4. Submit a pull request to merge your changes into the main branch.\n   \n##\n\n\u003cdetails\u003e\n  \u003csummary\u003e🚫📝\u003cstrong\u003e Legal Disclaimer \u003c/strong\u003e🚫📝\u003c/summary\u003e\n- \u003cstrong\u003e📢 Attention!\u003c/strong\u003e Before using this Python File Organizer, please read the following legal disclaimer carefully. By using this software, you agree to the terms and conditions stated below:\n\n- \u003cstrong\u003e⚠️ Use at Your Own Risk:\u003c/strong\u003e The Python File Organizer is provided on an \"as is\" basis, without any warranties or guarantees of any kind. The creators and contributors of this project do not take any responsibility for any damage or loss caused by the use of this software. Use it at your own risk.\n\n- \u003cstrong\u003e🔒 Data Privacy:\u003c/strong\u003e The Python File Organizer operates locally on your system and does not collect or store any personal or sensitive data. However, it is always recommended to review the code and ensure that it meets your privacy requirements.\n\n- \u003cstrong\u003e💼 Intellectual Property:\u003c/strong\u003e The Python File Organizer is an open-source project released under the MIT License. You are free to use, modify, and distribute the software, provided you comply with the terms of the license. Please refer to the LICENSE file for more details.\n\n- \u003cstrong\u003e👥 Contributions:\u003c/strong\u003e If you contribute to this project, you grant the project maintainers the right to use, modify, and distribute your contributions under the same MIT License. Your contributions may be subject to review and may be rejected or modified to meet project requirements.\n\n- \u003cstrong\u003e📚 Additional Resources:\u003c/strong\u003e The Python File Organizer may include links or references to external resources, such as official documentation or third-party libraries. The creators and contributors of this project are not responsible for the content, accuracy, or reliability of those external resources. Use them at your own discretion.\n\n- \u003cstrong\u003e🚧 Modification and Termination:\u003c/strong\u003e The creators and contributors of this project reserve the right to modify, suspend, or terminate the Python File Organizer at any time, with or without notice. They are not obligated to provide support or updates for the software.\n\n- \u003cstrong\u003e📝 Legal Jurisdiction:\u003c/strong\u003e This legal disclaimer shall be governed by and construed in accordance with the laws of the jurisdiction where the creators and contributors of this project reside. Any legal disputes arising from the use of this software shall be subject to the exclusive jurisdiction of the courts in that jurisdiction.\n\n- \u003cstrong\u003e ⚖️ Final Words:\u003c/strong\u003e While the Python File Organizer strives to provide a useful and efficient solution for file organization, it is your responsibility to ensure its suitability for your specific needs. Use it wisely and always backup your files.\n\nThank you for using the Python File Organizer! Happy organizing! 📂🐍🌟\n\n* \u003cstrong\u003eDisclaimer:\u003c/strong\u003e This legal disclaimer is for informational purposes only and does not constitute legal advice. If you have any legal concerns, please consult with a legal professional.\n\n\u003c/details\u003e\n\n## Support 🆘\u0026nbsp;🤝\u0026nbsp;\n\nIf you have any questions or issues related to this project, feel free to open an issue in the repository or contact the development team via email.\n\nEmail:                         \u003cimg align=\"center\" src=\"icons/Outlook.svg.png\" alt=\"Outlook\" height=\"25\" width=\"30\" /\u003e 👨‍💻📧vcastilloc@tecnocomfenalco.edu.co\n\n## 📲\u0026nbsp;💻\u0026nbsp;🔗\u0026nbsp; Connect with me 🔗\u0026nbsp;🌐\u0026nbsp;🤝\u0026nbsp;\n\u003cp align=\"left\"\u003e\n\u003ca href=\"https://twitter.com/VctorJosCast02\" target=\"blank\"\u003e\n  \u003cimg align=\"center\" src=\"https://raw.githubusercontent.com/rahuldkjain/github-profile-readme-generator/master/src/images/icons/Social/twitter.svg\" alt=\"Twitter\" height=\"30\" width=\"40\" /\u003e\n\u003c/a\u003e\n\u003ca href=\"https://linkedin.com/in/vcastilloc\" target=\"blank\"\u003e\n  \u003cimg align=\"center\" src=\"https://raw.githubusercontent.com/rahuldkjain/github-profile-readme-generator/master/src/images/icons/Social/linked-in-alt.svg\" alt=\"Linkendin\" height=\"30\" width=\"40\" /\u003e\n\u003c/a\u003e\n\u003ca href=\"https://instagram.com/victor02_cast2\" target=\"blank\"\u003e\n  \u003cimg align=\"center\" src=\"https://raw.githubusercontent.com/rahuldkjain/github-profile-readme-generator/master/src/images/icons/Social/instagram.svg\" alt=\"Instagram\" height=\"30\" width=\"40\" /\u003e\n\u003c/a\u003e\n\u003ca href=\"https://www.youtube.com/@VCastilloC\" target=\"blank\"\u003e\n  \u003cimg align=\"center\" src=\"https://raw.githubusercontent.com/rahuldkjain/github-profile-readme-generator/master/src/images/icons/Social/youtube.svg\" alt=\"YouTube\" height=\"30\" width=\"40\" /\u003e\n\u003c/a\u003e\n\u003ca href=\"https://api.whatsapp.com/send/?phone=3195598806\u0026text\u0026type=phone_number\u0026app_absent=0\" target=\"_blank\"\u003e\n  \u003cimg align=\"center\" src=\"icons/whatsapp.png\" alt=\"WhatsApp\" height=\"25\" width=\"30\" /\u003e\n\u003c/a\u003e\n\u003cp align=\"left\"\u003e\n\n## 🔒\u0026nbsp; License 📜\u0026nbsp;\n\nThis project is licensed under the [MIT License](https://github.com/VictorCast2/File-Organizer/blob/main/LICENSE). See the `LICENSE` file for more information.\n\nDerechos de autor (c) 2023 -  Víctor Castillo Cast2\n\n## 🌟\u0026nbsp; Acknowledgments 🙏\u0026nbsp;\n\nWe would like to thank all contributors and the Python community for their support and collaboration on this project.\n\n## 📚\u0026nbsp; Additional Resources 📚\u0026nbsp; 🌐\u0026nbsp;\n\nIf you want to learn more about Python or how to use it for different tasks, here are some recommended additional resources:\n\n- [Official Python Documentation](https://docs.python.org/3/)\n- [Python.org](https://www.python.org/)\n- [Python on GitHub](https://github.com/python)\n- [Python on Stack Overflow](https://stackoverflow.com/questions/tagged/python)\n\nThank you for using this Python File Organizer! We hope it helps you keep your files organized efficiently. 🗂️🐍🚀\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvictorcast2%2Ffile-organizer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvictorcast2%2Ffile-organizer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvictorcast2%2Ffile-organizer/lists"}