{"id":16226768,"url":"https://github.com/xandao-dev/files-organizer","last_synced_at":"2025-12-14T18:45:58.896Z","repository":{"id":57429451,"uuid":"450590783","full_name":"xandao-dev/files-organizer","owner":"xandao-dev","description":"Organize files by date, creating a folder for each month","archived":false,"fork":false,"pushed_at":"2022-09-06T01:42:55.000Z","size":190,"stargazers_count":7,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-15T04:40:41.627Z","etag":null,"topics":["files","filesystem","organize-media-files","organize-photos","organizer","python","python3"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xandao-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-01-21T17:59:42.000Z","updated_at":"2025-01-05T07:42:25.000Z","dependencies_parsed_at":"2022-08-27T17:01:59.400Z","dependency_job_id":null,"html_url":"https://github.com/xandao-dev/files-organizer","commit_stats":null,"previous_names":["xandao6/files-organizer"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xandao-dev%2Ffiles-organizer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xandao-dev%2Ffiles-organizer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xandao-dev%2Ffiles-organizer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xandao-dev%2Ffiles-organizer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xandao-dev","download_url":"https://codeload.github.com/xandao-dev/files-organizer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244434710,"owners_count":20452236,"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","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":["files","filesystem","organize-media-files","organize-photos","organizer","python","python3"],"created_at":"2024-10-10T12:50:24.815Z","updated_at":"2025-12-14T18:45:58.835Z","avatar_url":"https://github.com/xandao-dev.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cbr /\u003e\n\u003cp align=\"center\"\u003e\n  \u003ch3 align=\"center\"\u003eFiles Organizer\u003c/h3\u003e\n\n  \u003cp align=\"center\"\u003e\n    It's a great tool to organize your photos, videos, documents, etc based on their date.\n    When you run the tool, all the files in the current directory will be moved to the corresponding folders organized by month and year.\n    \u003cbr /\u003e\n    :warning: Linux limitation: If the file doesn't have a date on it's name, it's not possible to get the file creation date, so the last modified date will be used instead. :warning:\n    \u003cbr /\u003e\n    \u003cbr /\u003e\n    \u003ca href=\"https://github.com/xandao-dev/files-organizer\"\u003e\u003cstrong\u003eExplore the docs »\u003c/strong\u003e\u003c/a\u003e\n    \u003cbr /\u003e\n    \u003ca href=\"https://github.com/xandao-dev/files-organizer/issue\"\u003eReport Bug\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/xandao-dev/files-organizer/issues\"\u003eRequest Feature\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/p\u003e\n\n\n\u003c!-- TABLE OF CONTENTS --\u003e\n\u003cdetails open=\"open\"\u003e\n  \u003csummary\u003eTable of Contents\u003c/summary\u003e\n  \u003col\u003e\n    \u003cli\u003e\n      \u003ca href=\"#about-the-project\"\u003eAbout The Project\u003c/a\u003e\n      \u003cul\u003e\n        \u003cli\u003e\u003ca href=\"#features\"\u003eFeatures\u003c/a\u003e\u003c/li\u003e\n        \u003cli\u003e\u003ca href=\"#built-with\"\u003eBuilt With\u003c/a\u003e\u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/li\u003e\n    \u003cli\u003e\n      \u003ca href=\"#getting-started\"\u003eGetting Started\u003c/a\u003e\n      \u003cul\u003e\n        \u003cli\u003e\u003ca href=\"#pypi-installation\"\u003ePyPI Installation\u003c/a\u003e\u003c/li\u003e\n        \u003cli\u003e\u003ca href=\"#github-installation\"\u003eGitHub Installations\u003c/a\u003e\u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#usage\"\u003eUsage\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#roadmap\"\u003eRoadmap\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#contributing\"\u003eContributing\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#license\"\u003eLicense\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#contact\"\u003eContact\u003c/a\u003e\u003c/li\u003e\n  \u003c/ol\u003e\n\u003c/details\u003e\n\n\n\u003c!-- ABOUT THE PROJECT --\u003e\n## About The Project\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/xandao-dev/files-organizer\"\u003e\n    \u003cimg src=\"images/before.png\" alt=\"before organize\"\u003e\n\t  \u003cimg src=\"images/after.png\" alt=\"after organize\"\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n### Features\n\n* It has 4 ways to identify the files date\n* Cross-platform (Windows, Mac, Linux)\n* Do a backup by default\n* Organize files in folders created by month and year (like 2022-01)\n\n### Built With\n\n* [Python3](https://www.python.org/) - A general-purpose, high-level programming language\n* [fire](https://github.com/google/python-fire) - A google library for creating CLI applications\n\n\n\u003c!-- GETTING STARTED --\u003e\n## Getting Started\n\nYou can install the tool from PyPI or directly from GitHub. You just need to have Python3 installed.\n\n### PyPI Installation\n\n* Windows:\n  ```sh\n  pip3 install files-organizer[win]\n  ```\n* Mac or Linux:\n  ```sh\n  pip3 install files-organizer\n\t```\n\n### GitHub Installation\n\n1. Clone the repo\n  ```sh\n  git clone https://github.com/xandao-dev/files-organizer.git\n  ```\n\n2. Install the tool\n  ```sh\n  cd files-organizer\n  python3 setup.py install\n  ```\n\n3. (Windows Only) Install Dependencies\n  ```sh\n  python3 -m pip install pywin32\n  ```\n\n\u003c!-- USAGE EXAMPLES --\u003e\n## Usage\n\n* Run the tool on the current directory and do a backup\n\t```sh\n  files-organizer\n  ```\n* Run the tool on the current directory without backup\n\t```sh\n  files-organizer --no-backup\n  ```\n* Run the tool specifying the path and do a backup\n\t```sh\n  files-organizer --path=path/to/directory\n  ```\n* Run the tool specifying the path without backup\n\t```sh\n  files-organizer --path=path/to/directory --no-backup\n  ```\n* Show the help\n  ```sh\n  files-organizer --help\n  ```\n\n\n\u003c!-- ROADMAP --\u003e\n## Roadmap\n\nSee the [open issues](https://github.com/xandao-dev/files-organizer/issues) for a list of proposed features (and known issues).\n\n\n\u003c!-- CONTRIBUTING --\u003e\n## Contributing\n\nContributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are **greatly appreciated**.\n\n1. Fork the Project\n2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the Branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n\u003c!-- LICENSE --\u003e\n## License\n\nDistributed under the MIT License. See [LICENSE](./LICENSE.md) for more information.\n\nFree software =)\n\n\n\u003c!-- CONTACT --\u003e\n## Contact\n\nAlexandre Calil - [Linkedin](https://www.linkedin.com/in/xandao-dev/) - [alexandre@xandao.dev](mailto:alexandre@xandao.dev)\n\nProject Link: [https://github.com/xandao-dev/files-organizer](https://github.com/xandao-dev/files-organizer)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxandao-dev%2Ffiles-organizer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxandao-dev%2Ffiles-organizer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxandao-dev%2Ffiles-organizer/lists"}