{"id":18932670,"url":"https://github.com/yougotwill/sortifiler-cli","last_synced_at":"2026-03-18T12:30:15.980Z","repository":{"id":47925319,"uuid":"230575822","full_name":"yougotwill/sortifiler-cli","owner":"yougotwill","description":"Get your files sorted from the command line.","archived":false,"fork":false,"pushed_at":"2021-08-11T20:23:38.000Z","size":78,"stargazers_count":1,"open_issues_count":3,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-04-26T22:41:12.447Z","etag":null,"topics":["cli","command-line","files","filesystem","folders","productivity","sort","sorting"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yougotwill.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}},"created_at":"2019-12-28T07:33:18.000Z","updated_at":"2023-02-13T19:36:25.000Z","dependencies_parsed_at":"2022-08-12T14:20:49.368Z","dependency_job_id":null,"html_url":"https://github.com/yougotwill/sortifiler-cli","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yougotwill%2Fsortifiler-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yougotwill%2Fsortifiler-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yougotwill%2Fsortifiler-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yougotwill%2Fsortifiler-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yougotwill","download_url":"https://codeload.github.com/yougotwill/sortifiler-cli/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239931560,"owners_count":19720541,"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":["cli","command-line","files","filesystem","folders","productivity","sort","sorting"],"created_at":"2024-11-08T11:50:11.909Z","updated_at":"2026-03-18T12:30:15.909Z","avatar_url":"https://github.com/yougotwill.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Sortifiler CLI\n\n\u003e Get your files sorted from the command line. 📚🗂🖥\n\n## Description\nAn opinionated command line interface to sort your files and folders easily while feeling like [Hackerman](https://knowyourmeme.com/memes/hackerman).\n\n**Desktop app coming soon! 🚀**\n\nEveryday you look at your *Desktop/Downloads* folder and think, \"Damn I need to clean up this mess\". 🤦\n\nThat feeling is why this CLI now exists. 😆\n\nSortifiler CLI classifies files and folders and moves them into *\\_Type* folders for easy access at the root of your chosen directory. 🗃\n\n## Installation\n\nTo install Sortifiler CLI enter `npm -g install sortifiler-cli` into your terminal.\n\nIf you are looking for the Sortifiler API then check out [Sortifiler](https://github.com/yougotwill/sortifiler)!\n\n## Usage\n\n```\nsortifiler --help\n\n  Usage\n    $ sortfiler \u003cpath\u003e\n\n  Options\n    no flags,                     Sorts all files and folders in a given path.\n    --files, -f                   Sort all files in a given path.\n    --folders, -F                 Sort all folders in a given path.\n    --config, -c \u003cfilePath\u003e       Use a custom configuration file.\n\n  \u003cpath\u003e is the path to directory that needs sorting\n\n  Examples\n    Sort all files and folders in the Downloads folder.\n    $ sortifiler ~/Downloads\n    Sorting ...\n    Sorted ✔\n\n    Sort all files on the Desktop\n    $ sortifiler ~/Desktop --files\n    Sorting files ...\n    Sorted ✔\n\n    Sort all folders in the Downloads folder\n    $ sortifiler ~/Downloads --folders\n    Sorting folders ...\n    Sorted ✔\n\n    Sort all files and folders on the Desktop using a custom configuration file\n    $ sortifiler ~/Desktop --config ~/sortifiler.json\n    Loaded configuration ✔\n    Sorting folders ...\n    Sorted ✔\n```\n\n## How does the sorting work?\n\n- Folders are classified using the best matching *_Type* folder based on the files within that folder (only 1 level down).\n- Files are classified as follows:\n\n| _Type Folder | File Extension                           |\n| :------------- | :--------------------------------------- |\n| _Books         | \".epub\", \".mobi\"                         |\n| _Documents     | \".pdf\", \".txt\", \".doc\", \".docx\", \".ppt\", \".pptx\", \".md\", \".json\", \".ods\", \".log\", \".xls\", \".xlsx\", \".ttf\" |\n| _Images        | \".png\", \".jpg\", \".jpeg\", \".gif\", \".xcf\", \".stl\", \".blend\", \"*.obj\", \"*.mtl\", \"*.3ds\", \"*.tga\", \".icns\" |\n| _Music         | \".mp3\", \".wav\", \".flac\", \".m4a\", \".ogg\", \".mid\", \".asd\", \".m3u\", \".pls\", \".alp\", \".asx\", \".bfxrsound\", \".m3u8\", \".als\", \".m4r\" |\n| _Programs      | \".dmg\", \".exe\", \".sh\", \".app\", \".pkg\", \".apk\", \".ipa\", \".gba\", \".gbc\" |\n| _Scripts       | \".py\", \".java\", \".class\", \".sh\", \"*.cs\", \"*.r\", \".itermcolors\", \".terminal\", \".theme\", \".gbaskin\", \".tmtheme\", \".resbackup\" |\n| _Torrents      | \".torrent\"                               |\n| _Videos        | \".mkv\", \".mp4\", \".mov\", \".mpeg\", \".webm\", \".srt\", \".avi\" |\n| _Web           | \".html\", \".css\", \".js\", \".htm\"           |\n| _Zipped        | \".zip\", \".rar\", \".7z\", \".tar.gz\", \".tar\", \".gz\", \"*.unitypackage\", \"*.prefab\", \".fbx\" |\n\n- **Note:** This list maybe outdated please check out [Sortifiler](https://github.com/yougotwill/sortifiler) for the latest info.\n\n## Custom Configuration\n\nYou can customise the whitelist and sorting rules used by Sortifiler. Create a custom JSON file and then pass the file path to the `config` flag.\n\nExample: sortifiler.json\n\n```json\n{\n  \"whitelist\": [\"fileToIgnore.txt\"],\n  \"rules\": {\n    \"_Documents\": [\"*.pdf\"],\n    \"_Music\": [\"*.mp3\"]\n  }\n}\n```\n\n## Development\n\n### Contributing\n\n1. Fork it\n2. Create your feature branch: `git checkout -b feature/my-new-feature`\n3. Commit your changes: `git commit -am 'Add some feature'`\n4. Push to the branch: `git push origin feature/my-new-feature`\n5. Submit a pull request\n\n### Requirements / Dependencies\n\n- npm\n\n## Version\n\n0.2.0\n\n## License\n\n[GNU GPLv3](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyougotwill%2Fsortifiler-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyougotwill%2Fsortifiler-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyougotwill%2Fsortifiler-cli/lists"}