{"id":13658100,"url":"https://github.com/Kreateer/automatic-file-sorter","last_synced_at":"2025-04-24T08:31:15.135Z","repository":{"id":56562458,"uuid":"300270775","full_name":"Kreateer/automatic-file-sorter","owner":"Kreateer","description":"A small program that automatically moves and sorts files based on user input","archived":false,"fork":false,"pushed_at":"2023-06-20T11:55:24.000Z","size":73,"stargazers_count":13,"open_issues_count":6,"forks_count":9,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-31T07:17:20.503Z","etag":null,"topics":["automatic","file","files","hacktoberfest","hacktoberfest-starter","hacktoberfest2020","mover","pysimplegui","python","python3","python38","sort","sorting","tkinter","tkinter-python","windows"],"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/Kreateer.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2020-10-01T12:26:21.000Z","updated_at":"2024-08-11T10:04:51.000Z","dependencies_parsed_at":"2024-01-22T03:57:37.061Z","dependency_job_id":null,"html_url":"https://github.com/Kreateer/automatic-file-sorter","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kreateer%2Fautomatic-file-sorter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kreateer%2Fautomatic-file-sorter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kreateer%2Fautomatic-file-sorter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kreateer%2Fautomatic-file-sorter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Kreateer","download_url":"https://codeload.github.com/Kreateer/automatic-file-sorter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250591978,"owners_count":21455476,"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":["automatic","file","files","hacktoberfest","hacktoberfest-starter","hacktoberfest2020","mover","pysimplegui","python","python3","python38","sort","sorting","tkinter","tkinter-python","windows"],"created_at":"2024-08-02T05:00:56.158Z","updated_at":"2025-04-24T08:31:14.813Z","avatar_url":"https://github.com/Kreateer.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"\u003ch1 align=center\u003e Automatic File Sorter 🗃️ \u003c/h1\u003e\n\n\u003ch3 align=center\u003e A program that automatically moves/copies and sorts bulk files \u003c/h3\u003e\n\n\u003cp align=\"center\"\u003e\n   \u003cimg src=\"https://img.shields.io/github/hacktoberfest/2020/Kreateer/automatic-file-sorter\"\u003e \u003cimg src=\"https://img.shields.io/github/license/Kreateer/automatic-file-sorter\"\u003e \u003cimg src=\"https://img.shields.io/github/last-commit/Kreateer/automatic-file-sorter\"\u003e \u003cimg src=\"https://img.shields.io/github/downloads/kreateer/automatic-file-sorter/total\"\u003e\n   \u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n   \u003ca href=https://github.com/Kreateer/automatic-file-sorter#project-goals-\u003eProject Goal(s)\u003c/a\u003e • \u003ca href=https://github.com/Kreateer/automatic-file-sorter#contributors\u003eContributors\u003c/a\u003e • \u003ca href=https://github.com/Kreateer/automatic-file-sorter#installation--usage-\u003eInstallation \u0026 Usage\u003c/a\u003e • \u003ca href=https://github.com/Kreateer/automatic-file-sorter#how-to-contribute-%EF%B8%8F\u003eHow to Contribute?\u003c/a\u003e • \u003ca href=https://github.com/Kreateer/automatic-file-sorter#compiling-into-executable-%EF%B8%8F\u003eCompiling Into Executable\u003c/a\u003e\n  \u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"\"\u003e\n  \u003c/p\u003e\n\n- This is a small program that automatically moves and sorts files from chosen source to destination. It uses [PySimpleGUI](https://github.com/PySimpleGUI/PySimpleGUI) to create a minimal GUI for the user.\n- Anyone is welcome to work on it and add whatever features they wish, as long as they adhere to the [Code of Conduct](https://github.com/Kreateer/automatic-file-sorter/blob/master/CODE_OF_CONDUCT.md) and the [Contributing Guidelines](https://github.com/Kreateer/automatic-file-sorter/blob/master/CONTRIBUTING.md).\n- This project is especially interesting **for Python beginners** who don't have a project idea, but would like to work on something or anyone participating in the annual **Hacktoberfest** and looking to contribute to a project.\n\n## Project Goal(s) 🎯\n\nThis project aims to create a small, user-friendly tool to help people with organizing their files through use of simple algorithms that provide a number of sorting options.\n\nSpecifically, this project looks to provide the user with:\n\n- A program that automatically moves/copies and sorts files from user-designated source to destination directory\n- A user-friendly interface for managing files\n- The option to automatically move/copy and sort files from removable devices\n- The option to automatically sort directories or partitions as content is added, changed or removed\n\n## Installation \u0026 Usage 💻\n\nFirst, clone this repository:\n```bash\n# Clone the repository\n$ git clone https://github.com/Kreateer/automatic-file-sorter\n```\n\n### Linux\n\nMake sure you have Python 3.8+ installed on your system:\n```bash\n# Install Python 3.8\n$ sudo apt-get install python3.8\n```\n\nYou may also need to install the `tkinter` module for Python:\n```bash\n# Install tkinter for Python 3\n$ sudo apt-get python3-tk\n```\n\nNext, install the dependencies:\n```bash\n# Install dependencies\n$ pip3 install -r requirements.txt\n```\n\nFinally, locate ``fmain.py`` and run the script through an IDE or through console:\n```bash\n# cd to where 'fmain.py' is located\n$ cd \u003cclonelocation\u003e/automatic-file-sorter/scripts\n\n# run 'fmain.py'\n$ sudo python3 fmain.py\n```\nOnce you run the program, just follow the GUI instructions.\n\n### Windows\n\nMake sure you have Python 3.8+ installed.\nIf you don't, you can download the Windows release from the [official Python site](https://www.python.org/downloads/windows/).\n\nOnce Python is installed, you need to install the dependencies using pip.\n\n*IMPORTANT: If you're using an IDE like PyCharm, preferably you can use the IDE options to install packages in a virtual environment*\n\nIn Command Prompt, type:\n```bash\npip install -r requirements.txt\n```\n\nThen simply launch `fmain.py` through an IDE or through Command Prompt:\n```bash\n#cd to where 'fmain.py' is located\ncd \u003cclonelocation\u003e/automatic-file-sorter/scripts\n\n#run 'fmain.py'\npython fmain.py\n```\nOnce you run the program, just follow the GUI instructions.\n\n## Contributors ❤️\n\nThis is the 'hall of fame' for all the wonderful people who contributed to this project. It's a way to say a huge 'Thank You' to all contributors for helping out!\n\nEvery contribution, no matter how small or large, is welcome and equally important! ❤️❤️\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --\u003e\n\u003c!-- prettier-ignore-start --\u003e\n\u003c!-- markdownlint-disable --\u003e\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/Kreateer\"\u003e\u003cimg src=\"https://avatars2.githubusercontent.com/u/19147258?v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eMatija Milaković\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"#projectManagement-Kreateer\" title=\"Project Management\"\u003e📆\u003c/a\u003e\u003ca href=\"#ideas-Kreateer\" title=\"Ideas, Planning, \u0026 Feedback\"\u003e🤔\u003c/a\u003e\u003ca href=\"https://github.com/Kreateer/automatic-file-sorter/commits?author=Kreateer\" title=\"Code\"\u003e💻\u003c/a\u003e \u003ca href=\"https://github.com/Kreateer/automatic-file-sorter/commits?author=Kreateer\" title=\"Documentation\"\u003e📖\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/pushp1997\"\u003e\u003cimg src=\"https://avatars2.githubusercontent.com/u/19623154?s=400\u0026u=7a94be1ab36f881e6b2c2322ccc9e5f63082a28f\u0026v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003ePushp Vashisht\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/Kreateer/automatic-file-sorter/commits?author=pushp1997\" title=\"Code\"\u003e💻\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/arjunKay\"\u003e\u003cimg src=\"https://avatars3.githubusercontent.com/u/21005432?s=460\u0026u=44753ea260478cb4305a2bb9e11e2d8eac12550b\u0026v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eArjun K\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/Kreateer/automatic-file-sorter/commits?author=arjunKay\" title=\"Code\"\u003e💻\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/saptarsi96\"\u003e\u003cimg src=\"https://avatars1.githubusercontent.com/u/29809001?s=400\u0026u=877444ac545a2e7cdf3aac3189e13181761a0669\u0026v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eSaptarsi Saha\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/Kreateer/automatic-file-sorter/commits?author=saptarsi96\" title=\"Code\"\u003e💻\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/EmeraldEntities\"\u003e\u003cimg src=\"https://avatars0.githubusercontent.com/u/44278515?s=400\u0026u=91541d9d3b3fb613495c52239c8ddc474f5c0b19\u0026v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eJoseph Wang\n\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/Kreateer/automatic-file-sorter/commits?author=EmeraldEntities\" title=\"Code\"\u003e💻\u003c/a\u003e\u003c/td\u003e\n     \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/polynoman\"\u003e\u003cimg src=\"https://avatars1.githubusercontent.com/u/25401827?s=400\u0026v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003epolynoman\n\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/Kreateer/automatic-file-sorter/commits?author=polynoman\" title=\"Code\"\u003e💻\u003c/a\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n\u003c!-- markdownlint-enable --\u003e\n\u003c!-- prettier-ignore-end --\u003e\n\u003c!-- ALL-CONTRIBUTORS-LIST:END --\u003e\n\n\n## How to Contribute? ✍️\n\n- First, refer to the [Contributing Guidelines](https://github.com/Kreateer/automatic-file-sorter/blob/master/CONTRIBUTING.md)\n- Take a look at the existing Issues or create your own Issues to work on!\n- Wait for the Issue to be assigned to you before you start working on it.\n- Fork the repository and create a Branch for any Issue that you are working on.\n- Create a Pull Request which will be promptly reviewed and suggestions might be added to improve it.\n- Optional, but it would be helpful if you added screenshots to help everyone know how your fix or new feature works.\n\nOtherwise, if you are **new to GitHub** or have **never contributed** to GH projects, you can refer to these **helpful guides** on how to contribute:\n\n- [Forking a Repo](https://help.github.com/en/github/getting-started-with-github/fork-a-repo)\n\n- [Cloning a Repo](https://help.github.com/en/desktop/contributing-to-projects/creating-an-issue-or-pull-request)\n\n- [How to create a Pull Request](https://opensource.com/article/19/7/create-pull-request-github)\n\n- [Getting started with Git and GitHub](https://towardsdatascience.com/getting-started-with-git-and-github-6fcd0f2d4ac6)\n\n- [Learn GitHub from Scratch](https://lab.github.com/githubtraining/introduction-to-github)\n\n\n## Compiling Into Executable ⚙️\n\n- If you wish to build the source yourself and run the program from an **executable** instead of running the script everytime, you can use [PyInstaller](https://www.pyinstaller.org/) to compile the script into an **`.exe`** file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FKreateer%2Fautomatic-file-sorter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FKreateer%2Fautomatic-file-sorter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FKreateer%2Fautomatic-file-sorter/lists"}